CRM MCP Server

通过 VoiceBrain (Kortzeo) 语音/对话管理 CRM 系统 — 客户、商机、合同、工单等。

给同事的安装指南（3 分钟搞定）

第 1 步：在 VoiceBrain 添加 MCP 插件

1. 打开 VoiceBrain → 技能市场
2. 点击 「添加 MCP 插件」
3. 按下表填写：

| 字段 | 填什么 | |------|--------| | ID | crm | | 名称 | CRM 系统 | | 描述 | 连接 CRM，管理客户、商机、合同 | | 启动命令 | npx | | 命令参数 | -y crm-mcp-server | | 自动启动 | 勾选 |

4. 添加 3 个环境变量：

| 变量名 | 值 | |--------|-----| | CRM_API_URL | https://你们的CRM域名/api | | CRM_USERNAME | 你自己的 CRM 用户名 | | CRM_PASSWORD | 你自己的 CRM 密码 |

5. 点击 保存

首次启动会自动下载，可能需要等 10-20 秒。之后就是秒启动。

第 2 步：添加 CRM 助手技能（推荐）

1. 在技能市场点击 「添加技能」
2. 按下表填写：

| 字段 | 填什么 | |------|--------| | ID | crm_assistant | | 名称 | CRM 助手 | | 描述 | 智能 CRM 操作助手 | | 创建专属页面 | 勾选 | | 图标 | users | | 欢迎语 | 你好！我是你的 CRM 助手。 |

3. 提示词内容复制这段：

你是一个专业的 CRM 系统助手。你可以通过工具操作 CRM 系统，帮助用户管理客户、线索、商机、合同、项目和工单。

业务知识：
- 销售流程：线索 → 客户 → 商机 → 合同 → 项目
- 客户分两种：政府客户(G)和企业客户(B)
- 商机有阶段流转，可通过看板查看全局
- 合同创建后需提交审批流程
- 跟进记录可挂在客户、商机、线索上

使用规则：
- 用户提到公司名时，先搜索确认是否已存在
- 创建操作前确认关键信息
- 金额单位默认人民币
- 用简洁中文回复

4. 点击 保存

第 3 步：开始使用

在 VoiceBrain 侧边栏找到 「CRM 助手」，点进去直接说话：

• 「帮我查一下最近的商机」
• 「华为的联系人有哪些」
• 「给 XX 客户创建一条拜访记录」
• 「本月销售漏斗怎么样」
• 「创建一个新线索，公司叫 XX 科技」

常见问题

Q: 提示 "could not determine executable to run" A: 确认启动命令填的是 npx，命令参数填的是 -y crm-mcp-server（两个参数用逗号分隔或各占一行，取决于 VoiceBrain 的 UI）。

Q: 提示 "CRM 登录失败" A: 检查用户名密码是否正确。可以试试用同样的账号密码在 CRM 网页上登录。

Q: 提示 "无法连接 CRM 服务" A: 检查 CRM_API_URL 是否能访问。注意结尾要有 /api，比如 https://crm.example.com/api。

Q: 工具没出现 A: 在 VoiceBrain 控制台日志搜索 [MCPManager]，正常应显示 Started "crm" — 24 tools discovered。

开发者说明

cd mcp-server
npm install
npm run build    # 构建
npm test         # 运行测试
npm publish      # 发布到 npm