Crisp MCP

Crisp MCP服务器

MCP（模型上下文协议）服务器，提供与 脆的 客户支持平台。将其与Claude Code或任何兼容MCP的客户端一起使用，以管理支持对话、发送消息等。

安装

git clone https://github.com/getlate-dev/crisp-mcp.git
cd crisp-mcp
npm install
npm run build

获取您的Crisp API证书

您需要创建一个Crisp Marketplace插件来获得API证书。方法如下：

第一步：进入市场

1. 首选 Crisp市场
2. 点击 “创建插件” （您需要一个Crisp账户）

第二步：创建插件

1. 填写插件基本信息：

- 名字：类似于“我的MCP集成”（仅对您可见） - 描述：“个人MCP服务器集成” - 类别：选择“自动化” - 隐私：保持私密（除非你想发布）

1. 点击 “创建插件”

步骤3：获取您的凭据

创建插件后：

1. 转到插件的设置页面
2. 导航到 “代币” 部分
3. 你会发现：

- 插件ID （这是你的 CRISP_IDENTIFIER) - 插件密钥 （这是你的 CRISP_KEY)

步骤4：获取您的网站ID

1. 去你的 Crisp仪表板
2. 点击 设置 （齿轮图标）
3. 首选 网站设置
4. 你的 网站ID 位于URL中： app.crisp.chat/website/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/
5. 或者在下面找到它 安装说明 > 网站ID

步骤5：配置插件权限

回到Marketplace插件设置中，您需要启用所需的作用域：

1. 转到您的插件 “权限” 标签

1. 启用这些作用域：

- website:conversation:sessions -阅读对话 - website:conversation:messages -读/写消息 - website:conversation:states -更改对话状态 - website:conversation:routing -分配对话 - website:conversation:metas -读取/写入元数据 - website:operators:list -列出团队成员 - website:visitors:list -列出访问者

1. 点击 “保存”

步骤6：在您的网站上安装插件

1. 去 “安装” 插件设置中的选项卡
2. 点击 “添加安装”
3. 选择您的网站
4. 确认安装

您现在可以使用MCP服务器了！

配置

设置这些环境变量：

使用Claude代码

将此添加到您的Claude Code MCP设置中(~/.claude/settings.json):

{
  "mcpServers": {
    "crisp": {
      "command": "node",
      "args": ["/path/to/crisp-mcp/dist/index.js"],
      "env": {
        "CRISP_IDENTIFIER": "your-plugin-id",
        "CRISP_KEY": "your-plugin-secret-key",
        "CRISP_WEBSITE_ID": "your-website-id"
      }
    }
  }
}

然后重新启动Claude Code。您现在可以使用自然语言来管理您的Crisp对话：

• “显示未解决的支持票”
• “会话session_abc123的上下文是什么？”
• “回复客户说我们正在调查”
• “将该对话标记为已解决”

可用工具

对话发现

对话详细信息

消息传递

对话状态

对话操作

实时导航

人员/联系人

团队与访客

可靠性

HTTP客户端在指数回退的情况下自动重试 429 （价格有限）和 5xx 回应，尊重 Retry-After 标题（如果存在）。默认情况下最多重试4次。防止Crisp加载时操作员回复的无声下降。

可用资源

示例

列出未解决的对话

Use the list_conversations tool with unresolved_only: true

获得完整上下文的支持票

Use the get_conversation_with_messages tool with the session_id

回复客户

Use the send_message tool with session_id and content

添加内部注释（客户不可见）

Use the send_message tool with type: "note"

将票标记为已解决

Use the set_conversation_state tool with state: "resolved"

发展

# Watch mode for development
npm run dev

# Build for production
npm run build

# Run the server directly
npm start

故障排除

“Crisp API错误：401未经授权”

• 检查你的 CRISP_IDENTIFIER 和 CRISP_KEY 是正确的
• 确保您已在网站上安装了该插件

“Crisp API错误：403禁止”

• 您的插件可能缺少所需的权限
• 转到Marketplace>您的插件>权限并启用必要的作用域

“找不到网站”

• 仔细检查你的 CRISP_WEBSITE_ID
• 确保插件安装在特定网站上

许可证

麻省理工学院