crisp-mcp-server
crisp-mcp-server
Model Context Protocol のサーバーで、Crisp REST API 用です。Cloudflare Workers 上にデプロイされています。
Crisp のウェブサイト、オペレーター、会話を MCP ツールとして公開し、MCP 互換の AI エージェントがそれらの照会、プライベートノートの投稿、会話セグメントの管理を行えるようにします。
ツール
ツール | ティア | 説明 |
| both | 単一のウェブサイト(ワークスペース)を取得します。 |
| plugin | プラグイントークンに接続されているすべてのウェブサイトを一覧表示します。 |
| plugin | 認証されたプラグインアカウントを取得します。 |
| both | ウェブサイトのオペレーターを一覧表示します。 |
| both | ウェブサイトの最終アクティブなオペレーターを一覧表示します。 |
| both | ウェブサイトの単一のオペレーターを取得します。 |
| both | ウェブサイトの会話を一覧表示します(ページング可能、フィルタリング可能)。 |
| both | 単一の会話を取得します。 |
| both | 会話のメッセージを取得します。 |
| both | プライベートノートを投稿します(オペレーターのみ、訪問者には表示されません)。 |
| 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…
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