通过 MCP 连接 AI 智能体(Claude)
通过原生 MCP 服务器,将 AI 智能体(例如 Claude)连接到你的 CRM。该智能体使用你的 API 密钥,安全地读取和创建记录(线索、联系人、商机)。
MCP(模型上下文协议,Model Context Protocol)是一种让 AI 智能体与外部系统通信的标准。Sellio 提供原生 MCP 服务器:只需将智能体(例如运行在 Claude Desktop 中的 Claude,或任何支持 MCP 的客户端)指向该服务器地址,它就可以查询并在你的 CRM 中创建记录。这非常适合用于自动创建线索和联系人的获客智能体。所有操作都在该 API 密钥所属租户的上下文中进行,并遵循 CRM 的校验规则和权限(RBAC)。
前提条件
- 拥有一个 MCP 客户端(Claude Desktop,或任何通过 HTTP 支持 MCP 的应用/智能体)。
- 在 Sellio 中拥有管理员权限,以便在“设置 → API 与开发者”中生成 API 密钥。
1)生成 API 密钥
- 打开“设置 → API 与开发者”(也可通过侧边栏快捷方式访问)。
- 创建一个新的 API 密钥并复制其值(以 sk_ 开头,只会显示一次,请像对待密码一样妥善保管)。
- 同一个密钥可同时用于 REST API 和 MCP。
2)将智能体指向 MCP 服务器
MCP 服务器地址为 https://YOUR-CRM/api/mcp,认证方式与 REST 相同:使用 Authorization: Bearer sk_... 请求头。
在 Claude Desktop 中(以及使用 mcp-remote 桥接的客户端中),将以下内容添加到你的 MCP 服务器配置文件:
Example: { "mcpServers": { "sellio-crm": { "command": "npx", "args": ["-y", "mcp-remote", "https://YOUR-CRM/api/mcp", "--header", "Authorization: Bearer sk_live_..."] } } }
💡 已直接支持远程 HTTP MCP 服务器的客户端,可以直接使用上述 URL 并携带 Authorization: Bearer 请求头,无需通过 mcp-remote 桥接。
3)智能体可用的工具
- list_objects: 发现可用的对象(leads、联系人、公司、商机和自定义对象)。
- describe_object: 发现某个对象的字段:apiName、标签、类型、是否必填、select 接受的选项,以及 lookup 的目标对象。创建或更新前请先调用它。
- list_records: 列出并搜索某个对象的记录(搜索、字段过滤、排序、分页)。
- get_record: 按 id 获取一条记录。
- create_record: 创建一条记录(例如一条新的开发线索)。
- update_record: 更新现有记录的字段。
- delete_record: 将记录移入回收站(可恢复)。仅当 API 密钥启用了删除权限时才可用,该权限默认关闭。
- bulk_create_records: 一次调用最多创建 500 条记录,按条目报告成功或失败。
- bulk_update_records: 一次调用按 id 最多更新 500 条记录,按条目报告成功或失败。
- export_records: 以列稳定的扁平表格行返回某个对象的记录,提供 updated_since 和 created_since 用于增量同步。为 BI 和自动化工具而设计。
- list_activities: 列出某条记录的活动(其时间线),或工作区最近的活动。
- create_activity: 记录一项待办任务,或一次已发生的通话、邮件、会议或备注。
- update_activity: 完成、重新打开、改期、改派或记录一项活动的结果。
- delete_activity: 删除一项活动。需要删除权限。
- list_attachments: 列出某条记录的附件文件。
- get_attachment: 返回某个附件的元数据和一个 5 分钟后过期的签名下载链接。
- create_attachment_upload_url: 上传的第 1 步:返回一个签名 URL,用 PUT 方式发送文件字节(最大 25 MB)。
- register_attachment: 上传的第 2 步:在记录上登记已上传的文件,使其出现在时间线中。
- delete_attachment: 删除一个附件及其文件。不可恢复,因此需要删除权限。
- list_inventory: 按产品查看库存余额、已预留和可用数量,可查单个产品,或只看低于最低库存的产品。
- list_line_items: 某个商机的产品明细行(数量、单价、折扣、税额)及重新计算的总额。
- add_line_item: 向某个商机添加一条产品明细行。总额和商机金额会用与界面相同的引擎重新计算。
- update_line_item: 修改某条产品明细行的数量、单价、折扣、税额、期限或描述。
- delete_line_item: 从某个商机中移除一条产品明细行。
- send_marketing_email: 通过已配置的服务商发送一封营销邮件(收件人、主题、html),并自动加入退订链接。
💡 推荐的智能体流程:list_objects → describe_object(了解字段以及哪些是必填的)→ create_record/update_record。你也可以通过 REST 发现字段:GET /api/v1/objects/{object}。
💡 删除功能是开放的,但被锁定:delete_record、delete_activity 和 delete_attachment 只有在 API 密钥启用了删除权限时才可用,该权限默认关闭。其他所有工具都遵守密钥的只读标记及其对象权限范围,与 REST API 完全一致。
完整的 REST API 与 MCP 参考文档(端点、参数、错误格式、速率限制以及字段发现),请参阅帮助中心中的《开发者参考:REST API 与 MCP》一文。
如何测试
- 连接智能体,并提出类似“列出我的 CRM 对象”的请求,它应该会调用 list_objects 并返回列表。
- 提出“创建一个名为 Ana Souza、邮箱为 ana@acme.com 的线索”,智能体会调用 create_record 并返回新记录的 id。
- 在 CRM 中确认该记录已出现在对应对象的列表中。
故障排查
- 401 未授权:API 密钥缺失或错误。请在“设置 → API 与开发者”中生成一个新密钥,并使用 Authorization: Bearer sk_... 重新配置智能体。
- 智能体无法看到服务器:请确认地址 https://YOUR-CRM/api/mcp 是否正确;在 Claude Desktop 中,请确认配置文件中存在 mcpServers 配置块,并且应用已重启。
- 某个操作被拒绝:MCP 遵循 CRM 的权限(RBAC)和校验规则,错误信息会说明原因(必填字段缺失、无权限、套餐限制等)。
- 我只能看到自己的数据:这是正确的。每个 API 密钥都被隔离在所属租户内,智能体永远不会看到其他公司的数据。