KI-Assistenten verbinden (MCP)

DM Champ liefert einen offiziellen MCP-Server aus — einen Model Context Protocol-Endpunkt, der es KI-Assistenten wie Claude Code, Claude Desktop, ChatGPT, Cursor und Ihren eigenen Anwendungen ermöglicht, Ihr DM Champ-Konto direkt zu steuern. Fragen Sie in natürlicher Sprache (“list my live campaigns”, “add this lead”, “what did AI cost me this week?”) und der Assistent ruft die DM Champ-API für Sie auf.

Es handelt sich um dieselbe v1-API, die im API-Abschnitt dokumentiert ist und mit Ihrem eigenen API-Schlüssel authentifiziert wird. Der MCP-Server erstellt ein Tool für jede Operation in unserer veröffentlichten API-Spezifikation. Er deckt daher den Großteil, aber nicht die gesamte v1-API ab: Kontakte, Nachrichten, Kampagnen, KI-Agenten, Wissensdatenbank, Termine, Analysen, Tags, Listen und Unterkonten. Broadcasts, Automatisierungen und Deals sind noch nicht als MCP-Tools verfügbar – verwenden Sie für diese direkt die REST-API. Innerhalb dessen, was verfügbar gemacht 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 DM Champ-API-Schlüssel (wird als X-API-Key-Header gesendet)
Voraussetzung: Ein 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 dm-champ 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 dm-champ ✓ 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": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop

Bearbeiten Sie Ihre claude_desktop_config.json (Einstellungen → Entwickler → Konfiguration bearbeiten) und fügen Sie Folgendes hinzu:

{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Starten Sie Claude Desktop neu. DM Champ-Tools erscheinen im Werkzeugmenü.

ChatGPT

Benutzerdefinierte MCP-Connectoren sind für ChatGPT Business, Enterprise und Pro verfügbar. Ein Arbeitsbereich-Inhaber oder Administrator muss zuerst den Entwicklermodus / benutzerdefinierte Connectoren in den Arbeitsbereich-Einstellungen aktivieren – ohne dies erscheint die Option zum Erstellen eines Connectors nicht.

Erstellen Sie dann den Connector mit:

URL: https://mcp.youraiconnector.com/mcp
Authentifizierung: Benutzerdefinierte Header
Header-Name: X-API-Key
Header-Wert: Ihr DM Champ-API-Schlüssel

Die URL muss auf /mcp enden. Das Einfügen von nur https://mcp.youraiconnector.com ist der häufigste Fehler – ChatGPT überprüft genau diese Adresse, findet dort nichts und zeigt “Unable to add connector URL” an.

Cursor & andere MCP-Clients

Die meisten MCP-fähigen Editoren verwenden dasselbe .mcp.json-Format wie oben gezeigt (ein HTTP- Server mit einem url und einem X-API-Key Header). Fügen Sie einen dm-champ-Server hinzu, der auf https://mcp.youraiconnector.com/mcp verweist, 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 DM Champ-Tools ohne einen separaten Client verwenden kann:

{
  "model": "claude-opus-4-8",
  "messages": [{ "role": "user", "content": "List my live campaigns" }],
  "mcp_servers": [
    {
      "type": "url",
      "name": "dm-champ",
      "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:

Kampagnen: auflisten, erstellen, aktualisieren, pausieren/fortsetzen, Bot-Konfiguration prüfen.
Kontakte: suchen, erstellen, taggen, 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, Guthabenverbrauch, KI-Kosten.
Kanäle: Verbindungsstatus prüfen, einen Verbindungsablauf 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 diese Woche für jeden meiner Kunden gekostet?"
„Welche Kampagnen sind für Northside Dental live und wie ist der Status ihrer Kanäle?"

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 ist stärker eingeschränkt. Das Einrichten von KI-Agenten, benutzerdefinierten Funktionen, WhatsApp-Vorlagen, Einstiegspunkten, Kanalverbindungen, Kampagnenstatus und der Kauf einer Nummer funktionieren für einen benannten Kunden; die meisten anderen Schreibvorgänge laufen weiterhin über Ihr eigenes Konto. Führen Sie diese daher über den eigenen Schlüssel des Kunden oder über die REST API aus, die einen größeren Funktionsumfang bietet.

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.

Dem Assistenten die Hilfedokumentation zur Verfügung stellen

Der MCP-Server gibt einem Assistenten Zugriff auf Ihr Konto; er gibt ihm nicht diese Dokumentation. Wenn Sie möchten, dass er auch Fragen wie „Wie mache ich…“ korrekt beantwortet, verweisen Sie ihn auf https://docs.youraiconnector.com/llms.txt (einen Index jeder Hilfeseite mit einem Link zur Markdown-Version der jeweiligen Seite) oder https://docs.youraiconnector.com/llms-full.txt (die gesamte Dokumentation in einer einzigen Markdown-Datei). Beide sind öffentlich zugänglich, benötigen keinen Schlüssel und werden bei jeder Änderung der Dokumentation neu erstellt. Siehe Diese Dokumentation als Markdown lesen.

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

“Unable to add connector URL” (ChatGPT) / “connection refused” — 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.
Ein Tool gibt 403 zurück — Ihr Plan oder Ihre Teamrolle erlaubt diese Aktion nicht; der MCP-Server erzwingt nichts Zusätzliches, es ist dieselbe Berechtigungsprüfung wie bei der API.
Tool nicht gefunden — die Tool-Liste wird live aus der API generiert, daher entspricht sie immer der aktuellen Version; verbinden Sie sich erneut, um sie zu aktualisieren.
Eine Sicherheits- oder Zertifikatswarnung auf Ihrer eigenen Domain — einen DNS-Eintrag auf uns zu verweisen reicht allein nicht aus: Die Subdomain muss auch 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 gebrandeten Subdomains. Bis zur Verifizierung verwenden Sie die Standardadresse oben — sie ist neutral und kann daher sicher an Kunden weitergegeben 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.

KI-Assistenten verbinden (MCP) #

Claude Code #

Claude Desktop #

ChatGPT #

Cursor & andere MCP-Clients #

Die Claude-API (in Ihre eigene App integrieren) #

Was Sie tun können #

Fragen zu den Konten Ihrer Kunden (Agenturen) #

Dem Assistenten die Hilfedokumentation zur Verfügung stellen #

Ihren API-Schlüssel finden oder generieren #

Fehlerbehebung #

Nächste Schritte #