JinDaGe - crisp-mcp MCP Details

article

README

🚀 Crisp MCP 服务器

Crisp MCP 服务器是一个基于 MCP（模型上下文协议）的服务器，它提供了与 Crisp 客户支持平台进行交互的工具，能帮助用户更好地管理客户支持相关事务。

🚀 快速开始

安装

cd mcp-servers/crisp-mcp
npm install
npm run build

配置

服务器需要以下环境变量： | 变量 | 说明 | |------|------| | CRISP_IDENTIFIER | 你的 Crisp 插件标识符 | | CRISP_KEY | 你的 Crisp API 密钥 | | CRISP_WEBSITE_ID | 你的 Crisp 网站 ID |

你可以通过在 Crisp 市场创建插件，或者在你的 Crisp 仪表盘设置中获取这些凭证。

使用 Claude Code 配置

将以下内容添加到你的 Claude Code MCP 设置（.claude/settings.json 或全局设置）中：

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

✨ 主要特性

可用工具

对话管理

| 工具 | 说明 | |------|------| | list_conversations | 列出对话，可进行可选过滤（分页、搜索、未解决、未读） | | get_unresolved_conversations | 获取所有未解决的对话（分页显示） | | get_conversation | 获取特定对话的详细信息 | | search_conversations | 通过文本查询搜索对话 |

消息管理

| 工具 | 说明 | |------|------| | get_messages | 从对话中获取消息 | | get_conversation_with_messages | 获取格式化后的对话和消息，用于分析 | | send_message | 向对话发送消息（文本或内部备注） |

对话状态管理

| 工具 | 说明 | |------|------| | set_conversation_state | 更改对话状态（待处理、未解决、已解决） | | update_conversation_meta | 更新对话元数据（电子邮件、昵称、主题、标签） | | add_segments | 为对话添加标签/分段 | | remove_segments | 从对话中移除标签/分段 |

对话操作

| 工具 | 说明 | |------|------| | assign_conversation | 将对话分配给特定操作员 | | block_conversation | 阻止对话 | | unblock_conversation | 解除阻止对话 | | delete_conversation | 永久删除对话 |

团队与访客管理

| 工具 | 说明 | |------|------| | get_operators | 获取支持团队操作员列表 | | get_visitors | 获取当前网站访客列表 |

可用资源

| URI | 说明 | |-----|------| | crisp://conversations/unresolved | 所有未解决的支持对话列表 |

💻 使用示例

列出未解决的对话

使用 list_conversations 工具，并设置 unresolved_only: true

获取带有完整上下文的支持工单

使用 get_conversation_with_messages 工具，并传入 session_id

回复客户

使用 send_message 工具，并传入 session_id 和内容

将工单标记为已解决

使用 set_conversation_state 工具，并设置 state: "resolved"

📦 安装指南

开发环境

# 开发模式下的监听模式
npm run dev

# 生产环境构建
npm run build

# 启动服务器
npm start

📄 许可证

本项目采用 MIT 许可证。

crisp-mcp