Chatwoot über MCP mit Cursor verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Chatwoot klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Chatwoot + Cursor

Chatwoot, das Omnichannel-Support-Postfach, in der Cloud oder selbst gehostet: Konversationen und Nachrichten aus WhatsApp, E-Mail, Webchat und sozialen Kanälen, Kontakte, Labels, Agenten, Teams, Textbausteine und Support-Reports (erste Antwort, Lösungs- und Antwortzeiten). Antworten, private Notizen und neue Konversationen sind enthalten, aber bei der Installation deaktiviert.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

CHATWOOT_URL, CHATWOOT_API_TOKEN, CHATWOOT_ACCOUNT_ID

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein Chatwoot-Konto, in Chatwoot Cloud oder selbst gehostet, und das Access Token des Benutzers, als der die KI arbeiten soll.

1. Melde dich mit diesem Benutzer bei Chatwoot an. Agenten sehen nur Konversationen der Postfächer, in denen sie Mitglied sind, und können keine Reports lesen. Für das ganze Bild nimmst du deshalb einen Administrator.
2. Klicke auf deinen Avatar, dann auf Profile Settings, und kopiere das Access Token unten auf der Seite in CHATWOOT_API_TOKEN. Es läuft nicht ab; zurücksetzen kannst du es auf derselben Seite.
3. Setz CHATWOOT_URL auf die Adresse, unter der du Chatwoot öffnest: https://app.chatwoot.com bei Chatwoot Cloud, oder deine eigene Domain wie https://chat.example.com, wenn du selbst hostest. Kein Pfad, kein /app, kein /api.
4. Setz CHATWOOT_ACCOUNT_ID auf die Zahl nach /app/accounts/ in der Adresszeile des Browsers: https://app.chatwoot.com/app/accounts/3/dashboard bedeutet 3.
5. Installiere den Connector und rufe chatwoot_get_profile auf: Es zeigt den Benutzer hinter dem Token, seine Rolle und jedes Konto, das das Token erreicht, samt ID.

Konto-Token, nicht Platform API: Das Token einer Platform App eines Super-Admins (/platform/api) funktioniert hier nicht. Der Connector nutzt die Application API von Chatwoot für ein Konto.

Selbst gehostet hinter nginx: Das Token reist im Header api_access_token, und nginx verwirft Header mit Unterstrich, solange underscores_in_headers on; nicht gesetzt ist. Das zeigt sich als 401 bei jedem Aufruf, obwohl das Token stimmt. Ein selbst gehostetes Chatwoot, das nur in einem privaten Netz läuft, erreicht AnythingMCP Cloud nicht; betreibe dann AnythingMCP selbst in diesem Netz.

Was sie liest: das Konto und den Benutzer hinter dem Token; deine Postfächer (WhatsApp, E-Mail, Web-Widget, API, Instagram, Telegram und mehr) mit ihren Mitgliedern; Agenten und Administratoren mit ihrer Verfügbarkeit; Teams und ihre Mitglieder; Labels, Textbausteine (Canned Responses) und Definitionen eigener Attribute; Konversationen mit Status, Priorität, Postfach, Labels, Kontakt, zuständigem Agenten und Team, als Liste, als Zählung oder mit Filtern wie erstellt nach einem Datum und einem Agenten zugewiesen; die Nachrichten einer Konversation samt privaten Notizen und Anhängen; Kontakte nach Name, E-Mail, Telefonnummer oder Kennung, mit all ihren Konversationen über alle Postfächer; und die Support-Reports: Summen eines Zeitraums neben dem vorigen Zeitraum, eine Kennzahl im Zeitverlauf, Agenten, Postfächer oder Teams im direkten Vergleich und was gerade offen und unbeantwortet ist. Kanal-Geheimnisse der Postfächer und das eigene Access Token des Benutzers werden aus den Antworten entfernt.

Zeiten und Zahlen: Zeiten von Konversationen und Nachrichten und die Zeiträume der Reports sind Unix-Zeitstempel in Sekunden (UTC); die KI rechnet sie um, bevor sie eine Uhrzeit nennt. Erste Antwort, Lösungszeit und Antwortzeit stehen in den Reports in Sekunden.

Fragt vor jeder Änderung: chatwoot_set_conversation_labels. Chatwoot ersetzt die ganze Label-Liste einer Konversation. Deshalb liest die KI zuerst die aktuellen Labels und schickt sie zusammen mit dem neuen (oder ohne das zu entfernende). Labels müssen im Konto schon existieren. Die KI zeigt dir die Konversation und die neue Label-Liste und wartet auf dein Ja.

Bei der Installation deaktiviert: chatwoot_send_message (eine Antwort oder eine private Notiz, die nur Agenten sehen) und chatwoot_create_conversation. Eine Antwort oder erste Nachricht erreicht den Kunden sofort per WhatsApp, E-Mail oder Chat, deshalb schaltet ein Administrator sie bewusst ein. Auch dann zeigt dir die KI Text und Empfänger und wartet auf dein Ja. In Postfächern mit WhatsApp Cloud API erreicht freier Text einen Kontakt nur innerhalb von 24 Stunden nach seiner letzten Nachricht; außerhalb dieses Fensters braucht Chatwoot eine freigegebene Vorlage, die dieser Connector nicht verschickt.

Limits: Konversationen kommen mit 25 pro Seite, Kontakte mit 15 pro Seite und Nachrichten jeweils 20 auf einmal, also blättert die KI weiter; für eine reine Anzahl zählt sie, statt aufzulisten. Reports und Live-Statistiken brauchen das Token eines Administrators.

Häufige Fehler: 401 bedeutet ein falsches oder zurückgesetztes Token oder nginx, das den Header verwirft. 404 bei jedem Aufruf heißt meist, dass CHATWOOT_URL oder CHATWOOT_ACCOUNT_ID falsch ist; 404 bei einer einzelnen Konversation heißt, dass dieser Benutzer die ID nicht sehen darf. Reports antworten mit 401 oder 403 für Agenten, die keine Administratoren sind.

Der Connector nutzt nicht die Platform API, verschickt keine WhatsApp-Vorlagen, löst, verteilt oder löscht keine bestehenden Konversationen und ändert oder löscht keine Kontakte.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Cursor hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Chatwoot-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Wie viele offene Konversationen sind gerade niemandem zugewiesen, und welche Agenten haben unbeantwortete Chats?“
• „Lies Konversation 1284 und fass zusammen, was der Kunde will und was wir ihm schon zugesagt haben.“
• „Finde den Kontakt [email protected] und liste alle ihre Konversationen über WhatsApp und E-Mail auf.“
• „Vergleich unsere Agenten in den letzten 30 Tagen: bearbeitete Konversationen, Zeit bis zur ersten Antwort und Lösungszeit.“
• „Gib Konversation 1284 das Label erstattung und behalte die anderen Labels. Zeig mir vorher die neue Liste.“

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden