为 AI 客户端创建并管控 MCP 服务。
概述
💡 通过本指南，您可以创建 MCP 服务、分配授权工具、设置授权方式。
配置完成后，员工即可在自己的 AI 客户端中安全访问 CRM 数据。
合理的最小权限配置，能显著降低数据外泄风险。
开始之前
[!IMPORTANT]
- 角色权限：您需要拥有 CRM 管理员或系统管理员权限。
- 前置配置：企业已订购 MCP 调用次数包，或已开通 15 天试用。
- 影响范围：服务 URL、授权范围与工具配置的变更，对新建连接立即生效。
第一步：创建 MCP 服务
- 在 CRM 管理后台中，前往 MCP 服务。
- 点击 新建 MCP 服务。
- 填写服务名称与说明。
- 在 授权工具 区域中，按业务需要勾选工具。
- 点击 保存。
[!TIP]
建议按部门、角色或场景拆分服务，遵循最小权限原则。
只分配业务真正需要的工具，避免过度开放。
企业可通过配置不同的应用，控制不同角色人员可调用的工具列表。
第二步：设置授权方式
在 授权方式 区域中，选择允许员工使用的授权方式。
| 授权方式 | 凭证来源 | 适用场景 | 建议 |
|---|---|---|---|
| PKCE | 客户端动态生成 | 支持 OAuth 的客户端 | 优先启用，安全性更高 |
| User Token | 员工在个人中心创建 | 不支持 OAuth 的客户端 | 按需启用 |
[!TIP]
建议同时勾选两种方式，由员工按客户端能力与安全要求自行选择。
第三步：生成并下发服务 URL
- 在服务列表中，找到目标 MCP 服务。
- 点击 查看，复制服务 URL。
- 将服务 URL 与授权方式告知使用该服务的员工。
服务 URL 由企业专属标识和应用 API Name 组成，格式如下：
https://open.fxiaoke.com/mcp/<ea>/<mcp-api-name>
[!NOTE]
<ea>：企业专属标识，由系统按租户生成。<mcp-api-name>：MCP 服务的应用 API Name，由管理员在创建时指定。
第四步：管控安全边界
管理侧管控
- 只分配业务真正需要的工具，避免过度开放。
- 按部门、角色或场景拆分服务，遵循最小权限原则。
- 对服务 URL、授权范围和工具配置统一管理。
个人侧管控
当服务启用 User Token 授权时，员工可自行控制令牌：
- 在 CRM 中前往 个人中心 > 访问令牌。
- 点击 新建，创建公司授权的 MCP 令牌。
- 复制生成的用户令牌。
[!WARNING]
用户令牌属于敏感凭证，请提醒员工妥善保管。
- 令牌有效期建议设置为 90 天，安全性要求更高时设为 7 天。
- 不要向他人转发令牌或密钥。
- 不要将令牌写入公开脚本、代码仓库或共享文档。
- 如怀疑泄露，第一时间停用并重新生成令牌。
第五步：开通与计费
- 联系对应客服经理，下单开通。
- 确认产品名称为 MCP 调用 10 万次。
- 如需更高上限，可叠加多个包。
计费与配额规则：
- 限制的是企业按天调用的总次数，即 10 万次每天每企业。
- 叠加 2 个包即为 20 万次每天每企业。
- 一次查询或修改通常调用多个工具，每调用一个工具计一次。
- 重复查询计多次调用。
[!NOTE]
MCP 服务可由外部 Agent 独立调用，不依赖开通纷享的其他 AI 产品。
调用消耗的是外部 Agent 平台的配额，与纷享算粒无关。
验证方法
- 在客户端的 MCP 配置中填入服务 URL，并完成授权。
- 在客户端中输入“获取当前 MCP 的全部工具”。
- 确认成功返回工具列表。
- 在客户端中完成一次数据查询，确认返回 CRM 真实数据。
注意事项
- 未开通 MCP 服务时，管理员通过连接器连接会收到 15 天试用提示。
- 试用开通后如需取消或调整授权范围，前往 MCP 服务 操作。
- 修改授权方式后，已建立的连接不受影响，新建连接按新配置执行。