Skip to main content
Glama
crisp-mcp-server

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

get_website

beide

Eine einzelne Website (Workspace) abrufen.

list_connect_websites

Plugin

Alle Websites auflisten, die mit dem Plugin-Token verbunden sind.

get_connect_account

Plugin

Das authentifizierte Plugin-Konto abrufen.

list_website_operators

beide

Operatoren einer Website auflisten.

list_last_active_website_operators

beide

Zuletzt aktive Operatoren einer Website auflisten.

get_website_operator

beide

Einen einzelnen Operator einer Website abrufen.

list_conversations

beide

Konversationen einer Website auflisten (paginiert, filterbar).

get_conversation

beide

Eine einzelne Konversation abrufen.

get_conversation_messages

beide

Nachrichten einer Konversation abrufen.

send_conversation_note

beide

Eine private Notiz verfassen (nur für Operatoren, für Besucher nicht sichtbar).

set_conversation_segments

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) — setzt X-Crisp-Tier: website

  • ?tier=plugin — setzt X-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 typecheck

Bereitstellung

npm run deploy

Konfigurieren 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 an createMcpHandler (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…

    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

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to read, write, and search security findings, engagement memory, and semantic triage via MCP tools on Cloudflare Workers.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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