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 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 →

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 #

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:

{
  "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 18 oder neuer erforderlich ist:

{
  "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 Desktop, Cursor oder ein anderer MCP-Client oder die Claude-API.

ChatGPT kann die Hilfedokumentation auch ohne Verbindung lesen: siehe 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:

{
  "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 listet auf, was unterstützt wird.

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.

Clients mit Tool-Limit #

https://mcp.youraiconnector.com/mcp?tags=SubAccounts,Contacts,Messages

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 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.
• „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 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 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 — den Schlüssel generieren oder rotieren, den diese Verbindung verwendet.
• Webhooks — das Push-basierte Gegenstück zu dieser Pull-basierten MCP-Verbindung.