crisp-mcp-server

一个用于 Crisp REST API 的 Model Context Protocol 服务器，部署在 Cloudflare Workers 上。

它将 Crisp 的网站、操作员和对话作为 MCP 工具暴露出来，使兼容 MCP 的 AI 智能体能够查询它们、发布私人备注并管理对话分段。

工具

Related MCP server: neon-mcp

认证

该服务器是无状态且不保存凭据的：它不存储任何 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。