Skip to main content
Glama
crisp-mcp-server

crisp-mcp-server

crisp-mcp-server

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

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

工具

工具

层级

描述

get_website

两者

获取单个网站(工作区)。

list_connect_websites

plugin

列出连接到插件 token 的所有网站。

get_connect_account

plugin

获取已认证的插件账户。

list_website_operators

两者

列出网站的操作员。

list_last_active_website_operators

两者

列出网站最近活跃的操作员。

get_website_operator

两者

获取网站的单个操作员。

list_conversations

两者

列出网站的对话(支持分页和过滤)。

get_conversation

两者

获取单个对话。

get_conversation_messages

两者

获取对话的消息。

send_conversation_note

两者

发布私人备注(仅操作员可见,访客不可见)。

set_conversation_segments

两者

替换分配给对话的分段。

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…

    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