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

Related MCP server: neon-mcp

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.