销售易 CRM

通过 MCP 协议接入销售易 CRM，以当前登录用户的身份和权限执行所有操作。

capabilities: [neo-crm]
mcpEndpoint: https://mcp.xiaoshouyi.com/mcp
mcpTransport: streamableHttp

执行前检查

任何任务执行前，必须按顺序完成以下两步检查，未通过不要继续往下走业务流程。

步骤 1：检查 MCP 是否已配置

确认当前 Agent 已注册销售易 CRM 的 MCP server（server 名建议使用 neo-crm，端点指向 https://mcp.xiaoshouyi.com/mcp，传输方式为 streamableHttp）。判断方式任选其一：

列出当前可用 MCP server / 工具，检查是否存在指向 https://mcp.xiaoshouyi.com/mcp 的工具集
试调一个只读工具（如 user.profile），若返回 tool not found 或 MCP server not configured 即视为未配置

步骤 2：未配置时引导用户安装 MCP，并主动提出代为安装

如果 MCP 未注册，不要返回报错就结束、也不要伪造结果。按以下顺序处理：

明确告知用户："销售易 CRM MCP 尚未在当前 Agent 中安装。"
给出下方安装指引，让用户了解涉及哪些改动。
在同一条回复里主动询问用户："需要我直接帮您把销售易 CRM MCP 安装到当前 Agent 吗？" 等待用户回复。
根据用户回复分支处理：
- 用户回复"需要 / 好 / 帮我装 / yes"等肯定意图：直接进入下方「代为安装流程」，不要再让用户手动复制配置。
- 用户回复"不用 / 我自己来 / 先不装"等否定意图：保留安装指引让用户自行处理，告诉他"配置完成并重启或刷新会话后再发原始指令，我会从步骤 1 重新开始检查。"
- 用户没明确表态：再追问一次是否需要代为安装；除非确认，不要擅自动手改配置文件。

通用配置（适用于任何支持 MCP 的客户端）

把下面这段加入该 Agent 的 MCP 配置文件即可：

{
  "mcpServers": {
    "neo-crm": {
      "type": "streamableHttp",
      "url": "https://mcp.xiaoshouyi.com/mcp"
    }
  }
}

部分客户端字段命名略有差异，常见替代写法："transport": "streamable-http"、"transportType": "http"，按客户端文档调整。

代为安装流程（用户同意后执行）

仅在用户明确同意"帮我装"后才执行，未同意前严禁改动用户的 MCP 配置。

由 Agent 自己决定安装方式：每个 Agent 客户端管理 MCP 配置的方式不同（有的写文件、有的走 API、有的走插件设置）。请按你所在 Agent 的内置机制完成配置，不必参考任何第三方客户端的文件路径。
写入内容：在 mcpServers 下新增或更新一项名为 neo-crm 的 server，端点固定为 https://mcp.xiaoshouyi.com/mcp，传输方式为 streamableHttp（按客户端字段惯例可微调）：
```
{
  "mcpServers": {
    "neo-crm": {
      "type": "streamableHttp",
      "url": "https://mcp.xiaoshouyi.com/mcp"
    }
  }
}
```
保留其它配置：如果 Agent 已经存在其它 MCP server，必须保留不动，仅新增或覆盖 neo-crm 这一项。
告知后续动作：安装完成后告诉用户："销售易 CRM MCP 已配置好，请重启 / 刷新会话以加载；加载完成后重新发送原始指令，我会从步骤 1 继续。"
失败兜底：若 Agent 没有自动安装 MCP 的能力或安装失败，回退到让用户按上面的手动指引自行配置，并简要说明失败原因。

步骤 3：已配置时进入授权检查

MCP 通过后，首次使用需完成销售易账号授权。若任一业务调用返回 authorization-required，将 authorizeUrl 提供给用户在浏览器中打开完成登录，之后重试同一个工具。

可以做什么

客户与联系人

查看客户完整画像（基本信息、联系人、商机、跟进历史）
查找长期未跟进的客户
管理联系人信息

商机

查看商机当前阶段和推进条件
推进商机阶段、标记赢单/输单/重启
查找超期商机
为商机添加联系人、完成销售活动

线索

将线索转化为客户、联系人或商机
关闭无效线索
从线索公海领取或释放线索

公海（客户公海池）

查看公海池整体情况
搜索公海中的客户
领取、智能领取、释放、分配公海客户

跟进与拜访

记录跟进（文字、拜访、电话等类型）
查询某客户或商机的跟进历史
安排拜访日程
PRM 渠道：管理拜访计划、执行拜访记录、提交拜访结果

日程与任务

查看今日日程、按时间范围查询日程
创建、修改、删除日程和任务
批量创建任务

审批

查看待审批列表和审批状态
提交审批、同意或拒绝审批

合同

合同生效、作废
创建回款计划、收款单、收款申请
合同核销

订单

创建、查询、修改订单
订单生效/失效/作废
履约链路：创建交付记录、发运单、收货单、出库单
O2C 财务：查询应收单、创建收款单、开具发票、退款

报价单

报价单转订单
设置主报价单

工作报告

查看日报/周报/月报列表
提交工作报告
查阅他人报告

工作圈动态

发布、查看、评论、点赞动态

数据查询

按任意条件搜索 CRM 中的任何对象（客户、商机、合同、订单等）
查看对象详情及关联数据
批量更新、启用/禁用记录

关键行为规范

歧义时先问：用户说"拜访"可能是 PRM 门店拜访或普通跟进记录；"日程"可能是普通日程或 PRM 拜访计划/日程；"公海"可能是客户公海或线索公海。遇到歧义给出选项，一次只问一个。

写操作前确认：删除、废弃、释放、作废等不可逆操作，必须用户明确确认后才执行。

时间处理：所有时间默认 Asia/Shanghai（UTC+8）。"今天""本周""上月"等相对时间可直接用于查询条件；具体时刻需换算为毫秒时间戳。

分页：列表结果每页最多 50 条，结果带是否有更多的提示。