Skip to main content
Glama
crisp-mcp-server

crisp-mcp-server

crisp-mcp-server

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

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

ツール

ツール

ティア

説明

get_website

both

単一のウェブサイト(ワークスペース)を取得します。

list_connect_websites

plugin

プラグイントークンに接続されているすべてのウェブサイトを一覧表示します。

get_connect_account

plugin

認証されたプラグインアカウントを取得します。

list_website_operators

both

ウェブサイトのオペレーターを一覧表示します。

list_last_active_website_operators

both

ウェブサイトの最終アクティブなオペレーターを一覧表示します。

get_website_operator

both

ウェブサイトの単一のオペレーターを取得します。

list_conversations

both

ウェブサイトの会話を一覧表示します(ページング可能、フィルタリング可能)。

get_conversation

both

単一の会話を取得します。

get_conversation_messages

both

会話のメッセージを取得します。

send_conversation_note

both

プライベートノートを投稿します(オペレーターのみ、訪問者には表示されません)。

set_conversation_segments

both

会話に割り当てられたセグメントを置き換えます。

Related MCP server: Cloudflare Workers AI MCP Server

認証

サーバーはステートレスかつ資格情報不要です。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 アプリからローテーションしてください。

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