Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge Chatwoot mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
Zusammenfassung
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.
Frag einfach
Beispiel-Prompts für Chatwoot
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 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 + Microsoft Copilot
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.
- 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.
- 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. - Setz
CHATWOOT_URLauf die Adresse, unter der du Chatwoot öffnest:https://app.chatwoot.combei Chatwoot Cloud, oder deine eigene Domain wiehttps://chat.example.com, wenn du selbst hostest. Kein Pfad, kein/app, kein/api. - Setz
CHATWOOT_ACCOUNT_IDauf die Zahl nach/app/accounts/in der Adresszeile des Browsers:https://app.chatwoot.com/app/accounts/3/dashboardbedeutet 3. - Installiere den Connector und rufe
chatwoot_get_profileauf: 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 Microsoft Copilot 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 AnleitungYOUR_SERVER_IDzeigt.
Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.
- Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
- Trag einen Server name ein (zum Beispiel
AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft. - Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf
X-API-Keyund klicke auf Create. - Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
- Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die
Chatwoot-Tools braucht. - Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.
Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.
Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.
Verfügbare Tools
| Tool | What it does |
|---|---|
chatwoot_get_profile | Get the user behind the access token: id, name, email, role, availability and every account the token can reach (accounts[].id and name) |
chatwoot_get_account | Get the Chatwoot account configured in CHATWOOT_ACCOUNT_ID: name, locale, domain, support e-mail, status, enabled features and custom… |
chatwoot_list_inboxes | List the inboxes (channels) of the account: id, name, channel type (WhatsApp, API, web widget, e-mail, Instagram, Telegram...), phone… |
chatwoot_list_inbox_agents | List the agents who are members of one inbox (id, name, email, role, availability) |
chatwoot_list_agents | List the agents and administrators of the account: id, name, email, role (agent or administrator), availability (online, busy, offline) and… |
chatwoot_list_teams | List the teams of the account (id, name, description, whether auto-assignment is on) |
chatwoot_list_team_members | List the agents in one team (id, name, email, role, availability) |
chatwoot_list_labels | List the labels defined in the account: id, title, description and color |
chatwoot_list_canned_responses | List the canned responses (saved replies) of the account: id, short code and content |
chatwoot_list_custom_attributes | List the custom attribute definitions of the account for conversations (attribute_model 0) or contacts (1): key, display name, type and… |
chatwoot_list_conversations | List conversations, 25 per page, newest activity first, with counts (mine, assigned, unassigned, all) |
chatwoot_count_conversations | Count conversations without listing them: mine_count, assigned_count, unassigned_count and all_count for a status, inbox, team or label |
chatwoot_filter_conversations | Filter conversations with Chatwoot's advanced filter, 25 per page: a list of conditions on status, assignee_id, inbox_id, team_id… |
chatwoot_get_conversation | Get one conversation by its id (the number shown in the Chatwoot URL): status, priority, inbox, labels, contact, assignee, team, custom and… |
chatwoot_list_messages | List the messages of a conversation, oldest first: the latest 20 by default, or 20 older than before. message_type 0 = incoming (from the… |
chatwoot_list_contacts | List contacts with an e-mail, phone number or identifier, 15 per page: id, name, e-mail, phone, identifier, custom and additional… |
chatwoot_search_contacts | Search contacts by name, e-mail, phone number or identifier (case-insensitive, partial), 15 per page. meta.has_more tells whether another… |
chatwoot_get_contact | Get one contact: name, e-mail, phone, identifier, custom and additional attributes, last activity and the inboxes the contact is reachable… |
chatwoot_list_contact_conversations | List the conversations of one contact across all inboxes, with status, labels, assignee and last message |
chatwoot_get_report_summary | Get the totals of a period for the account, an agent, an inbox, a label or a team: conversations, incoming and outgoing messages… |
chatwoot_get_report_timeseries | Get one metric over time as [{value, timestamp}] buckets, for the account, an agent, an inbox, a label or a team, grouped by hour, day… |
chatwoot_get_summary_by | Compare agents, inboxes or teams over a period, one row each: conversations, resolved and handled conversations, average resolution, first… |
chatwoot_get_live_conversation_stats | Right now: how many conversations are open, unattended (no reply yet) and unassigned for the whole account (type account), or open and… |
chatwoot_send_message | Send a reply in an existing conversation, or add a private note that only agents see (private true) |
chatwoot_set_conversation_labels | Set the labels of a conversation |
chatwoot_create_conversation | Start a new conversation with an existing contact in an inbox, optionally with a first message, status, assignee and team |
chatwoot_add_agent | Invite a person to the account as an agent or administrator |
chatwoot_update_agent | Change an agent's role (agent or administrator), availability or auto-offline setting |
chatwoot_remove_agent | Remove an agent from the account |
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
Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.
Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.
Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.
Nächste Schritte
- Connector-Startseite
- Mit Claude verbinden
- Mit ChatGPT verbinden
- Mit Cursor verbinden
- Mit Gemini verbinden
- Mit Meta Muse verbinden
War dieser Guide hilfreich?