# KI-Assistenten verbinden (MCP) Your AI Connector liefert einen offiziellen **MCP-Server** aus — einen Model Context Protocol-Endpunkt, mit dem KI-Assistenten wie **Claude Code**, **Claude Desktop**, **Cursor** und Ihre eigenen Apps Ihr Your AI Connector-Konto direkt steuern können. Fragen Sie in natürlicher Sprache ("list my AI agents", "add this lead", "what did AI cost me this week?") und der Assistent ruft die Your AI Connector-API für Sie auf. Es handelt sich um dieselbe v1-API, die Sie mit einem [API-Schlüssel](api-access.md) erreichen und mit Ihrem eigenen API-Schlüssel authentifizieren. Der MCP-Server erstellt ein Tool für jede Operation in unserer veröffentlichten API-Spezifikation und deckt somit den Großteil, wenn auch nicht die gesamte v1-API ab: Kontakte, Nachrichten, Kampagnen, KI-Agenten, benutzerdefinierte Funktionen, Wissensdatenbank, Termine, Analysen, Tags, Listen, Broadcasts, Deals, Kanalverbindungen und Unterkonten. Automatisierungen können aufgelistet und gelesen, aber noch nicht über MCP erstellt oder bearbeitet werden; führen Sie dies in der App aus. Innerhalb dessen, was bereitgestellt wird, gibt es keine Berechtigungen pro Tool und keine schreibgeschützte Standardeinstellung, sodass der API-Schlüssel die gesamte Zugriffskontrolle darstellt. - **Endpunkt:** `https://mcp.youraiconnector.com/mcp` - **Authentifizierung:** Ihr Your AI Connector API-Schlüssel (gesendet als `X-API-Key` Header) - **Erfordert:** Einen Plan mit API-Zugriff. [API-Schlüssel erstellen →](api-access.md#generating-your-api-key) > Ihr API-Schlüssel wirkt auf **Ihr eigenes Konto** mit denselben Berechtigungen wie der > Rest der API – und kann die von Ihnen verwalteten Kundenkonten lesen, falls Sie einen > Agentur-Plan haben (siehe unten). Behandeln Sie ihn wie ein Passwort. Sie können ihn jederzeit unter > Einstellungen → Integrationen → API-Schlüssel widerrufen, wodurch der Zugriff des Assistenten sofort unterbrochen wird. ## Claude Code ```bash claude mcp add --transport http ai-connector https://mcp.youraiconnector.com/mcp \ --header "X-API-Key: YOUR_API_KEY" ``` Führen Sie dann `/mcp` in Claude Code aus, um zu bestätigen, dass **ai-connector ✓ connected** angezeigt wird. Standardmäßig wird der Server im **lokalen** Bereich hinzugefügt (nur für Sie, dieses Projekt). Verwenden Sie `--scope user`, um ihn in all Ihren Projekten verfügbar zu machen, oder `--scope project` to commit it to a repo's `.mcp.json` für Ihr Team: ```json { "mcpServers": { "ai-connector": { "type": "http", "url": "https://mcp.youraiconnector.com/mcp", "headers": { "X-API-Key": "YOUR_API_KEY" } } } } ``` ## Claude Desktop Fügen Sie den Server als benutzerdefinierten Connector hinzu. Er wird in Ihrem Claude-Konto eingerichtet, sodass er sowohl in Claude Desktop als auch auf claude.ai funktioniert (kostenlose Claude-Konten können einen benutzerdefinierten Connector hinzufügen). 1. Öffnen Sie **Anpassen → Connectors**, klicken Sie auf **+ Hinzufügen** und dann auf **Benutzerdefinierten Connector hinzufügen**. 2. Geben Sie ihm einen Namen und geben Sie `https://mcp.youraiconnector.com/mcp` als URL ein. 3. Wählen Sie unter **Authentifizierung** die Option **Keine Anmeldung**. Der MCP-Server hat keine Anmeldeseite: Die Auswahl einer Anmeldeoption führt zu der Meldung „Konnte nicht beim … Anmeldedienst registriert werden“. 4. Fügen Sie unter **Anfrage-Header** einen Header namens `X-API-Key` mit Ihrem API-Schlüssel als Wert hinzu. 5. Klicken Sie auf **Hinzufügen**. Your AI Connector Tools erscheinen im Tool-Menü eines neuen Chats. **Kein Feld für Anfrage-Header vorhanden?** Ihre Claude Desktop-Version ist veraltet: Aktualisieren Sie sie oder verwenden Sie stattdessen die Konfigurationsdatei. Die Konfigurationsdatei (`claude_desktop_config.json`, Einstellungen → Entwickler → Konfiguration bearbeiten) führt Programme nur auf Ihrem Computer aus und ignoriert einen `url`-Eintrag, daher benötigt sie die kleine `mcp-remote`-Brücke, für die [Node.js](https://nodejs.org) 18 oder neuer erforderlich ist: ```json { "mcpServers": { "ai-connector": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.youraiconnector.com/mcp", "--header", "X-API-Key:${AI_CONNECTOR_KEY}" ], "env": { "AI_CONNECTOR_KEY": "YOUR_API_KEY" } } } } ``` Behalten Sie `X-API-Key:${AI_CONNECTOR_KEY}` genau so bei, wie es geschrieben ist, ohne Leerzeichen nach dem Doppelpunkt (unter Windows trennt ein Leerzeichen den Header) und fügen Sie Ihren Schlüssel nur in `env` ein. Beenden Sie dann Claude Desktop vollständig (unter Windows: Rechtsklick auf das Tray-Symbol → Beenden) und öffnen Sie es erneut. ## ChatGPT ChatGPT kann sich derzeit nicht mit dem MCP-Server verbinden. Das Formular für benutzerdefinierte Connectors bietet nur **OAuth** oder **Keine Authentifizierung** an, und der Your AI Connector-MCP- Server meldet sich mit Ihrem API-Schlüssel an, der als Request-Header gesendet wird. Die Auswahl von OAuth schlägt mit "could not discover OAuth settings" fehl, und "Keine Authentifizierung" wird abgelehnt, da jede Anfrage den Schlüssel benötigt. Verwenden Sie stattdessen einen Assistenten, bei dem Sie einen Request-Header festlegen können: [Claude Code](#claude-code), [Claude Desktop](#claude-desktop), [Cursor oder ein anderer MCP-Client](#cursor--other-mcp-clients) oder [die Claude-API](#the-claude-api-build-it-into-your-own-app). ChatGPT kann die Hilfedokumentation auch ohne Verbindung lesen: siehe [The help docs are built in](#the-help-docs-are-built-in) für die öffentlichen `llms.txt`-Dateien. ## Cursor & andere MCP-Clients Die meisten MCP-fähigen Editoren verwenden dieselbe `.mcp.json`-Form wie oben gezeigt (ein HTTP-Server mit einem `url` und einem `X-API-Key` Header). Fügen Sie einen `ai-connector`-Server hinzu, der auf `https://mcp.youraiconnector.com/mcp` zeigt, und fügen Sie Ihren API-Schlüssel in den Header ein. ## Die Claude-API (in Ihre eigene App integrieren) Sie können den MCP-Server programmgesteuert mit dem MCP-Connector der Claude-API verbinden, sodass ein von Ihnen erstellter Agent Your AI Connector-Tools ohne einen separaten Client verwenden kann: ```json { "model": "claude-opus-4-8", "messages": [{ "role": "user", "content": "List my AI agents" }], "mcp_servers": [ { "type": "url", "name": "ai-connector", "url": "https://mcp.youraiconnector.com/mcp", "authorization_token": "YOUR_API_KEY" } ] } ``` ## Was Sie tun können Innerhalb des Teils der v1-API, den der MCP-Server verfügbar macht, wählt der Assistent automatisch das richtige Tool aus: - **KI-Agenten:** auflisten, erstellen, aktualisieren, pausieren/fortsetzen, Konfiguration prüfen. - **Kontakte:** suchen, erstellen, markieren, zu Listen hinzufügen, importieren. - **Wissensdatenbank / FAQs:** hinzufügen, bearbeiten, Massenimport, KI-Vorschläge genehmigen. - **Nachrichten:** Unterhaltungen lesen, eine Nachricht an einen Kontakt senden. - **Termine:** auflisten, buchen, stornieren. - **Aufgaben:** erstellen, abschließen, auflisten. - **Analysen:** Nachrichtenstatistiken, Kreditverbrauch, KI-Kosten. - **Kanäle:** Verbindungsstatus prüfen, einen Verbindungsvorgang starten. ## Fragen zu den Konten Ihrer Kunden (Agenturen) Eine Verbindung deckt jedes Konto ab, das Sie verwalten. Sie müssen keine zweite Verbindung pro Kunde hinzufügen: Bei einem Agentur-Plan kann der Assistent jedes Kundenkonto unter Ihnen lesen, sodass Sie in einer einzigen Konversation nach allen fragen können. Nennen Sie einfach den Kunden: - "Wie viele Kontakte hat Bella's Bistro?" - "Was hat die KI jeden meiner Kunden diese Woche gekostet?" - "Wie ist der Status der Kanäle von Northside Dental und wie viele Chats sind diese Woche eingegangen?" Dies umfasst das Lesen von Kontakten, Nachrichten, Chats, Kampagnen, Terminen, Aufgaben, Tags, Ereignissen, FAQs, Wissensdatenbank-Quellen, Telefonnummern, Kanälen, Webhooks und Analysen. Wir prüfen, ob das Konto wirklich Ihnen gehört, bevor etwas ausgeführt wird – die Anfrage nach einem Konto, das nicht Ihnen gehört, wird als „nicht gefunden“ zurückgegeben. Wenn Sie den Kunden weglassen, liest der Assistent Ihr eigenes Konto, genau wie zuvor. **Das Ändern eines Kundenkontos** funktioniert auf die gleiche Weise. Jede Aktion, die ein Kundenkonto in der API akzeptiert, ist für einen benannten Kunden verfügbar: das Einrichten von KI-Agenten, Wissensdatenbanken, benutzerdefinierten Funktionen, WhatsApp-Vorlagen, Einstiegspunkten, Kanalverbindungen, Kontakten, Tags, Broadcasts, Terminen, Deals und Aufgaben sowie das Senden von Nachrichten. Die Ausnahmen sind Aktionen auf Agenturebene, die immer über Ihr eigenes Agenturkonto ausgeführt werden: die Verwaltung der Kundenkonten selbst (Limits, Funktionen, Preise, Pausieren), Snapshots, Ihr Team und API-Schlüssel. Das Hinzufügen von Kontakten zu oder das Entfernen aus einer Kundenliste ist für einen benannten Kunden noch nicht verfügbar; führen Sie dies über den eigenen Schlüssel des Kunden oder in dessen Konto aus. Der [Leitfaden zur Agentur-API](../agency/api-for-agencies.md#where-sub_account_id-is-supported) listet auf, was unterstützt wird. ::: neutral-mcp Die Agentur-Tools befinden sich nur unter der standardmäßigen, nicht gebrandeten Adresse, `https://mcp.youraiconnector.com/mcp`. Eine White-Label-MCP-Adresse auf Ihrer eigenen Domain (`mcp.youragency.com`) ist für Ihre Kunden konzipiert und schließt diese aus. Verwenden Sie daher die standardmäßige, nicht gebrandete Adresse, wenn Sie Kundenkonten verwalten. ::: Dies ist auch die Antwort für einen Kunden, der **mehrere Unternehmen unter einem Login** betreibt. Geben Sie jedem Unternehmen ein eigenes Konto und laden Sie dann die E-Mail-Adresse des Kunden als Teammitglied für alle ein: Er meldet sich einmal an und wechselt zwischen seinen Marken mit der Kontoauswahl in der Seitenleiste. ### Testen eines Agenten eines Kunden Bitten Sie den Assistenten, den Agenten eines Kunden auszuprobieren („sende 'liefern Sie sonntags?' an den Bäckerei-Agenten von Kunde X und zeige mir, was er getan hat“). Er sendet eine „Ausprobieren“-Nachricht mit Ihrem Agenturschlüssel und der `sub_account_id` des Kunden, wartet und liest die Antwort sowie alle Aktionen des Agenten vor. Es ist keine Kopie des Agenten erforderlich. Wenn der Assistent meldet, dass Sie kein Agenturkonto haben, ist er mit dem Schlüssel eines Kunden verbunden: Verbinden Sie ihn erneut mit dem Schlüssel Ihres Agenturkontos. Siehe [Ausprobieren](../chats/playground.md#testing-an-agent-from-the-api-or-an-ai-assistant). ## Clients mit Tool-Limit ::: neutral-mcp Einige KI-Clients akzeptieren nur Server mit einer begrenzten Anzahl an Tools. Composio verweigert beispielsweise einen Server, der mehr als 500 Tools auflistet, und importiert keines davon. Die vollständige Agenturverbindung listet mehr als das auf, fügen Sie also `?tags=` zur Adresse hinzu, die nur die von Ihnen benötigten Tool-Gruppen enthält. Für eine Agentur, die ihre Kundenkonten auflisten, deren Kontakte, Chats und Nachrichten lesen sowie Nachrichten senden möchte: ``` https://mcp.youraiconnector.com/mcp?tags=SubAccounts,Contacts,Messages ``` Dies lädt etwa 80 Tools. Nennen Sie den Kunden in Ihrer Anfrage, und der Assistent agiert wie oben beschrieben auf dem Konto dieses Kunden. - Trennen Sie Gruppen mit Kommas; Groß- und Kleinschreibung funktionieren beide. - Um einzelne Tools hinzuzufügen, listen Sie deren genaue Namen mit `tools=` auf, zum Beispiel `?tags=Contacts&tools=list_or_get_subaccounts`. Sie erhalten jedes Tool aus beiden Listen. - Die Hilfedokumentations-Tools sind immer enthalten. - Der API-Schlüssel gehört weiterhin in den `X-API-Key`-Header (oder `Authorization: Bearer YOUR_API_KEY`), niemals in die Adresse. ::: ## Die Hilfedokumentation ist integriert Der MCP-Server stellt dem Assistenten Ihr **Konto** und diese **Dokumentation** zur Verfügung. Drei Tools lesen die Hilfedokumentation live, sodass der Assistent nachschlagen kann, wie eine Funktion funktioniert oder was sich kürzlich geändert hat, anstatt zu raten: - `docs_search`: findet die Abschnitte, die eine Frage beantworten, und gibt sie mit dem Seitenlink zurück. - `docs_read`: liest eine Seite vollständig oder einen Abschnitt davon. - `docs_list`: listet jede Seite nach Bereich auf. Es muss nichts eingerichtet werden, und die Dokumentations-Tools greifen niemals auf Ihre Kontodaten zu. Fragen Sie „Wie funktionieren Einstiegspunkte?“ oder „Was ist neu bei Automatisierungen?“, und der Assistent durchsucht zuerst die Dokumentation. Da die Tools die Hilfeseite selbst lesen, ist dem Assistenten eine Funktion bekannt, sobald deren Anleitung veröffentlicht wurde. Ein Assistent, der nicht über MCP verbunden ist, kann die Dokumentation dennoch lesen: Verweisen Sie ihn auf `https://docs.youraiconnector.com/llms.txt` (ein Index jeder Hilfeseite mit einem Link zur Markdown-Version jeder Seite) oder `https://docs.youraiconnector.com/llms-full.txt` (die gesamte Dokumentation in einer Markdown-Datei). Beide sind öffentlich, benötigen keinen Schlüssel und werden bei jeder Dokumentationsänderung neu erstellt. ## Ihren API-Schlüssel finden oder generieren Der API-Schlüssel, den diese Verbindung verwendet, befindet sich unter **Einstellungen → Integrationen → API-Schlüssel** — ein eigener Bereich, getrennt von Webhooks. Siehe [API-Zugriff](api-access.md#generating-your-api-key) für die genauen Schritte. ## Fehlerbehebung - **„Verbindung verweigert“ oder „nicht gefunden“** — der Adresse fehlt das `/mcp` am Ende. Verwenden Sie `https://mcp.youraiconnector.com/mcp`, nicht `https://mcp.youraiconnector.com`. - **`Needs authentication` / 401** — Ihr API-Schlüssel fehlt oder ist falsch. Fügen Sie den Server erneut mit einem gültigen `X-API-Key` hinzu. - **„Konnte OAuth-Einstellungen nicht ermitteln“ (ChatGPT)** — ChatGPT unterstützt für benutzerdefinierte Connectors nur OAuth oder keine Authentifizierung, und der MCP-Server verwendet einen API-Schlüssel, daher kann ChatGPT derzeit keine Verbindung herstellen. Siehe [ChatGPT](#chatgpt). - **„Konnte nicht beim … Anmeldedienst registriert werden“ oder „OAuth-Client-ID hinzufügen“ (Claude Desktop)** — der benutzerdefinierte Connector wurde mit einer Anmeldeoption hinzugefügt. Es gibt keine OAuth-Client-ID zur Eingabe: Entfernen Sie den Connector und fügen Sie ihn erneut mit **Authentifizierung → Keine Anmeldung** und Ihrem API-Schlüssel als `X-API-Key` Anfrage-Header hinzu, wie unter [Claude Desktop](#claude-desktop) beschrieben. - **Claude Desktop zeigt nach dem Bearbeiten der Konfigurationsdatei keine Tools an** — die Konfigurationsdatei ignoriert einen `"url"`-Eintrag; verwenden Sie den benutzerdefinierten Connector oder das `mcp-remote`-Formular in [Claude Desktop](#claude-desktop) und beenden Sie die App vollständig, bevor Sie sie erneut öffnen. - **Ein Tool gibt `403` zurück** — Ihr Plan oder Ihre Teamrolle erlaubt diese Aktion nicht; der MCP-Server erzwingt nichts Zusätzliches, es handelt sich um dieselbe Berechtigungsprüfung wie bei der API. - **Tool nicht gefunden** — die Tool-Liste wird live aus der API generiert und entspricht daher immer der aktuellen Version; stellen Sie die Verbindung erneut her, um sie zu aktualisieren. - **Eine Sicherheits- oder Zertifikatswarnung auf Ihrer eigenen Domain** — einen DNS-Eintrag auf uns zu verweisen reicht für sich allein nicht aus: Die Subdomain muss im Dashboard verifiziert werden, bevor sie eine sichere Verbindung bereitstellen kann. White-Label-Agenturen können die MCP-Adresse auf ihrer eigenen Domain (z. B. `mcp.youragency.com`) über die Karte **Benutzerdefinierte Domain** unter **Einstellungen → White Labeling** platzieren — fügen Sie zuerst den CNAME bei Ihrem Registrar hinzu, geben Sie dann den Hostnamen im Block **MCP-Domain (KI-Assistenten)** ein und klicken Sie auf **Verifizieren**, genau wie bei Ihren anderen Marken-Subdomains. Die Marken-Adresse lässt die Agentur-Tools weg; verwenden Sie für diese weiterhin die standardmäßige, nicht gebrandete Adresse. Bis Ihre Marken-Adresse verifiziert ist, verwenden Sie die standardmäßige, nicht gebrandete Adresse: Sie kann sicher mit Kunden geteilt werden. --- ## Nächste Schritte - [API-Zugriff](api-access.md) — den Schlüssel generieren oder rotieren, den diese Verbindung verwendet. - [Webhooks](webhooks.md) — das Push-basierte Gegenstück zu dieser Pull-basierten MCP-Verbindung.