crisp-mcp-server
crisp-mcp-server
一个用于 Crisp REST API 的 Model Context Protocol 服务器,部署在 Cloudflare Workers 上。
它将 Crisp 的网站、操作员和对话作为 MCP 工具暴露出来,使兼容 MCP 的 AI 智能体能够查询它们、发布私人备注并管理对话分段。
工具
工具 | 层级 | 描述 |
| 两者 | 获取单个网站(工作区)。 |
| plugin | 列出连接到插件 token 的所有网站。 |
| plugin | 获取已认证的插件账户。 |
| 两者 | 列出网站的操作员。 |
| 两者 | 列出网站最近活跃的操作员。 |
| 两者 | 获取网站的单个操作员。 |
| 两者 | 列出网站的对话(支持分页和过滤)。 |
| 两者 | 获取单个对话。 |
| 两者 | 获取对话的消息。 |
| 两者 | 发布私人备注(仅操作员可见,访客不可见)。 |
| 两者 | 替换分配给对话的分段。 |
Related MCP server: Cloudflare Workers AI MCP Server
认证
该服务器是无状态且不保存凭据的:它不存储任何 Crisp token。每个 MCP 客户端直接将 Crisp token 传递给端点。
Crisp REST API 使用 Basic 认证,密钥对为 token_id:token_key。将字符串 token_id:token_key 进行 Base64 编码,并作为 Bearer token 传递给 MCP 端点:
Authorization: Bearer <base64(token_id:token_key)>Worker 会将该值作为 Authorization: Basic <base64(...)> 转发给 Crisp API。
层级
Crisp token 有两种:website(单个工作区)或 plugin(多工作区)。使用 tier 查询参数选择层级:
?tier=website(默认)— 设置X-Crisp-Tier: website?tier=plugin— 设置X-Crisp-Tier: plugin
从 Crisp 应用生成 token:设置 → 工作区设置 → 高级配置 → 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 token 和层级,为每个请求构建一个新的 MCP 服务器,并将其交给createMcpHandler(无状态的 Streamable HTTP 传输)。src/crisp.ts— 轻量级的只读 Crisp REST 客户端(https://api.crisp.chat/v1)。src/tools.ts— 注册上述 MCP 工具。
备注
以读取为主:只有私人备注和对话分段是可写的;所有其他工具均为只读。
无状态:没有 Durable Objects、没有会话、不存储任何凭据。
Crisp token 由客户端在每次连接时发送;如果泄露,请从 Crisp 应用轮换该 token。
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.7MIT