# KI-Assistenten verbinden (MCP)

<span data-t="appName">DM Champ</span> 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 <span data-t="appName">DM Champ</span>-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 <span data-t="appName">DM Champ</span>-API für Sie auf.

Es handelt sich um dieselbe v1-API, die im [API-Abschnitt](../api/getting-started.md) 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 <span data-t="appName">DM Champ</span>-API-Schlüssel (wird als `X-API-Key`-Header gesendet)
- **Voraussetzung:** Ein 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 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:

```json
{
  "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:

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

Starten Sie Claude Desktop neu. <span data-t="appName">DM Champ</span>-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 <span data-t="appName">DM Champ</span>-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 <span data-t="appName">DM Champ</span>-Tools ohne einen separaten Client verwenden kann:

```json
{
  "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](../agency/api-for-agencies.md) 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.dmchamp.com/llms.txt` (einen Index jeder Hilfeseite mit einem Link zur Markdown-Version der jeweiligen Seite) oder `https://docs.dmchamp.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](../api/getting-started.md#reading-these-docs-as-markdown).

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

- **"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](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.