crisp-mcp-server

Model Context Protocol のサーバーで、Crisp REST API 用です。Cloudflare Workers 上にデプロイされています。

Crisp のウェブサイト、オペレーター、会話を MCP ツールとして公開し、MCP 互換の AI エージェントがそれらの照会、プライベートノートの投稿、会話セグメントの管理を行えるようにします。

ツール

Related MCP server: neon-mcp

認証

サーバーはステートレスかつ資格情報不要です。Crisp トークンを一切保存しません。各 MCP クライアントは Crisp トークンをエンドポイントに直接渡します。

Crisp REST API は、キーペア token_id:token_key による Basic 認証を使用します。文字列 token_id:token_key を Base64 エンコードし、Bearer トークンとして MCP エンドポイントに渡します:

Authorization: Bearer <base64(token_id:token_key)>

ワーカーはその値を Authorization: Basic <base64(...)> として Crisp API に転送します。

ティア

Crisp トークンは website（単一ワークスペース）または plugin（複数ワークスペース）のいずれかです。tier クエリパラメータでティアを選択します:

• ?tier=website（デフォルト）— X-Crisp-Tier: website を設定します

• ?tier=plugin — X-Crisp-Tier: plugin を設定します

Crisp アプリの Settings → Workspace Settings → Advanced configuration → API Token（website）、または Crisp Marketplace（plugin）からトークンを生成します。

開発

npm install
npm run dev      # local dev at http://localhost:8787
npm run typecheck

デプロイ

npm run deploy

次に、MCP クライアントを https://<your-worker>.workers.dev/mcp?tier=website に、Authorization: Bearer <base64(...)> ヘッダーを付けて接続します。

Claude Desktop / Claude Code の例

{
  "mcpServers": {
    "crisp": {
      "url": "https://<your-worker>.workers.dev/mcp?tier=website",
      "headers": {
        "Authorization": "Bearer <base64(token_id:token_key)>"
      }
    }
  }
}

動作の仕組み

• src/index.ts — Worker のエントリポイント。リクエストから Bearer トークンと tier を抽出し、リクエストごとに新しい MCP サーバーを構築して createMcpHandler（ステートレスな Streamable HTTP トランスポート）に渡します。

• src/crisp.ts — 軽量な読み取り専用の Crisp REST クライアント（https://api.crisp.chat/v1）。

• src/tools.ts — 上記の MCP ツールを登録します。

注意事項

• 読み取り主体: 書き込み可能なのはプライベートノートと会話セグメントのみです。他のすべてのツールは読み取り専用です。

• ステートレス: Durable Objects もセッションも保存資格情報もありません。

• Crisp トークンは接続のたびにクライアントから送信されます。漏えいした場合は Crisp アプリからローテーションしてください。