Crisp MCP服务器
MCP（模型上下文协议）服务器 Crisp.chat --允许Claude和其他LLM从您的Crisp工作区搜索和阅读对话。所有工具都是只读的。
工具
| 工具 | 说明 |
|---|---|
search_conversations | 按文本或片段搜索对话 |
get_conversation | 按会话ID获取会话详细信息和消息 |
list_conversations | 列出带有可选状态过滤器的对话 |
设置
1.简明证书
所有凭据都是通过创建的 Crisp市场.
创建插件并获取令牌
- 首选 marketplace.crisp.chat 然后登录（或创建一个Marketplace帐户——这与您的主Crisp帐户是分开的）
- 点击 新插件 → 选择 私人
- 命名您的插件（例如“MCP服务器”）并单击 创建
- 去 代币 tab → 滚动至 生产 → click 询问生产令牌
- 选择所需的范围（只读）：
- website:conversation:sessions --列出和搜索对话 - website:conversation:messages --阅读消息 - website:conversation:participants --阅读参与者
- 解释你的用例（例如“用于AI助手的只读MCP服务器”）并提交——批准通常需要几分钟
- 一旦获得批准，请复制您的 生产令牌密钥对:
- 标识符 → CRISP_IDENTIFIER - 钥匙 → CRISP_KEY
- 去 设置 tab → 复制 私人安装链接 并打开它在您的网站上安装插件
保持您的令牌密钥对私有。 如果受到损害，请立即从您的Marketplace仪表板中滚动。 如果您在某些路由上遇到权限错误，则您的令牌缺少所需的作用域。使用上面列出的所有范围创建一个新的生产令牌。
查找您的网站ID
- 登录到…… app.crisp.chat
- 首选 设置→ 网站设置
- 从URL复制网站ID→
CRISP_WEBSITE_ID
2.在铁路上部署
设置以下环境变量：
| 变量 | 值 |
|---|---|
MCP_TRANSPORT | http |
CRISP_IDENTIFIER | 您的插件标识符 |
CRISP_KEY | 您的插件密钥 |
CRISP_WEBSITE_ID | 您的网站ID |
构建命令： npm install && npm run build 启动命令： npm start
3.连接到Crisp
- 首选 app.crisp.chat
- 导航至 AI 代理→ 自动化→ 集成和MCP→ 外部MCP服务器
- 添加您的铁路URL：
https://your-app.railway.app/mcp - 命名、刷新工具、启用和保存
4.连接到Claude.ai
- 首选 claude.ai → 设置→ 连接器
- 添加自定义连接器
- 输入您的铁路URL：
https://your-app.railway.app/mcp
5.本地使用（克劳德桌面）
无需部署。添加 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"crisp": {
"command": "node",
"args": ["/path/to/crisp-mcp-server/dist/index.js"],
"env": {
"CRISP_IDENTIFIER": "your_plugin_identifier",
"CRISP_KEY": "your_plugin_key",
"CRISP_WEBSITE_ID": "your_website_id"
}
}
}
}发展
npm install
npm run dev # Run with tsx (hot reload)
npm run build # Compile TypeScript
npm start # Run compiled version堆栈
- Types/Node.js
@modelcontextprotocol/sdk--MCP协议crisp-api-Crisp API客户- Express--HTTP传输