crisp-mcp-server
crisp-mcp-server
Ein Model Context Protocol-Server für die Crisp-REST-API, bereitgestellt auf Cloudflare Workers.
Er stellt die Websites, Operatoren und Konversationen von Crisp als MCP-Tools bereit, sodass ein MCP-kompatibler KI-Agent sie abfragen, private Notizen verfassen und Konversationssegmente verwalten kann.
Tools
Tool | Typ | Beschreibung |
| beide | Eine einzelne Website (Workspace) abrufen. |
| Plugin | Alle Websites auflisten, die mit dem Plugin-Token verbunden sind. |
| Plugin | Das authentifizierte Plugin-Konto abrufen. |
| beide | Operatoren einer Website auflisten. |
| beide | Zuletzt aktive Operatoren einer Website auflisten. |
| beide | Einen einzelnen Operator einer Website abrufen. |
| beide | Konversationen einer Website auflisten (paginiert, filterbar). |
| beide | Eine einzelne Konversation abrufen. |
| beide | Nachrichten einer Konversation abrufen. |
| beide | Eine private Notiz verfassen (nur für Operatoren, für Besucher nicht sichtbar). |
| beide | Die Segmente ersetzen, die einer Konversation zugewiesen sind. |
Related MCP server: Cloudflare Workers AI MCP Server
Authentifizierung
Der Server ist zustandslos und ohne Zugangsdaten: Er speichert keinen Crisp-Token. Jeder MCP-Client übergibt den Crisp-Token direkt an den Endpunkt.
Die Crisp-REST-API verwendet Basic-Authentifizierung mit einem Schlüsselpaar token_id:token_key. Kodieren Sie die Zeichenfolge token_id:token_key in Base64 und übergeben Sie sie als Bearer-Token an den MCP-Endpunkt:
Authorization: Bearer <base64(token_id:token_key)>Der Worker leitet diesen Wert als Authorization: Basic <base64(...)> an die Crisp-API weiter.
Typ
Crisp-Tokens sind entweder website (ein einzelner Workspace) oder plugin (mehrere Workspaces). Wählen Sie den Typ über den Abfrageparameter tier aus:
?tier=website(Standard) — setztX-Crisp-Tier: website?tier=plugin— setztX-Crisp-Tier: plugin
Generieren Sie Tokens in der Crisp-App: Einstellungen → Workspace-Einstellungen → Erweiterte Konfiguration → API-Token (Website) oder im Crisp-Marketplace (Plugin).
Entwicklung
npm install
npm run dev # local dev at http://localhost:8787
npm run typecheckBereitstellung
npm run deployKonfigurieren Sie anschließend einen MCP-Client mit der URL https://<your-worker>.workers.dev/mcp?tier=website und dem Header Authorization: Bearer <base64(...)>.
Beispiel für Claude Desktop / Claude Code
{
"mcpServers": {
"crisp": {
"url": "https://<your-worker>.workers.dev/mcp?tier=website",
"headers": {
"Authorization": "Bearer <base64(token_id:token_key)>"
}
}
}
}So funktioniert es
src/index.ts— Worker-Einstiegspunkt. Extrahiert das Bearer-Token und den Typ aus der Anfrage, erstellt pro Anfrage einen neuen MCP-Server und übergibt ihn ancreateMcpHandler(zustandsloser Streamable-HTTP-Transport).src/crisp.ts— Schlanker, schreibgeschützter Crisp-REST-Client (https://api.crisp.chat/v1).src/tools.ts— Registriert die oben genannten MCP-Tools.
Hinweise
Hauptsächlich lesend: Nur private Notizen und Konversationssegmente sind beschreibbar; alle anderen Tools sind schreibgeschützt.
Zustandslos: keine Durable Objects, keine Sitzungen, keine gespeicherten Zugangsdaten.
Der Crisp-Token wird bei jeder Verbindung vom Client gesendet; erneuern Sie ihn über die Crisp-App, falls er ausgelaufen ist.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Freshchat MCP server for ChatGPT, Claude and any AI agent: list conversations, read conversation, send reply, assign conversation, resolve conversation with label, list canned responses and get CSAT report in your own Freshchat account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Freshchat yourself; Cotlet does not store your password and you need no Freshchat API key. About the official Freshchat API: Freshchat has a REST API (v2) but no official MCP server (checked 22 Oct 2026). Freshworks' MCP integration covers Freshdesk and Freshservice, and its docs do not list Freshchat. Setup and FAQ: https://cotlet.dev/integrations/freshchat-api-mcp-server
Cloudflare Workers MCP server: agent-workflow-engine
Remote streamable-HTTP MCP server running on a single Cloudflare Worker. Your assistant gets live Airbnb, Amazon, Booking.com, Google Flights, Maps and Reddit data, social search on X, Instagram and TikTok, the Meta Ad Library, and image/video generation without any keys. Connect your own accounts to let it send WhatsApp or Telegram messages, work an IMAP inbox, manage Meta Ads campaigns and publish to X and LinkedIn. OAuth 2.1 with PKCE; stored credentials are AES-256-GCM encrypted.
Chatwoot MCP server for ChatGPT, Claude and any AI agent: list conversations, reply to conversation, add private note, assign conversation, add labels and resolve or snooze conversation in your own Chatwoot account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Chatwoot yourself; Cotlet does not store your password and you need no Chatwoot API key. About the official Chatwoot API: Chatwoot has a full REST API, the Application API, and an official command-line client, but no official MCP server (checked 22 Oct 2026). The API covers conversations, messages, contacts, labels, teams and assignments with an access token from Profile Settings. Setup and FAQ: https://cotlet.dev/integrations/chatwoot-api-mcp-server
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to read, write, and search security findings, engagement memory, and semantic triage via MCP tools on Cloudflare Workers.-
- AlicenseAqualityCmaintenanceEnables AI agents to access Cloudflare Workers AI for serverless LLM chat completions, text embeddings, and image generation via MCP tools.420 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables an MCP-capable AI agent to receive and store WhatsApp Cloud API messages, claim conversations, read history, send replies through guarded tools, and answer inbound voice calls, all running on the owner's own Cloudflare account with staff pause and takeover controls.MIT
- AlicenseNot gradedqualityCmaintenanceEnables ChatGPT plugins and other MCP clients to fetch live web pages and documents as Markdown and to call HTTP APIs via self-hosted Cloudflare Workers.34 npm6MIT