文档教程
连接业务系统
接入有赞、小鹅通、云账房、微盟和飞书等连接器，完成授权、权限配置和连通性验证。
连接器让 Agent 在企业授权的业务系统里读取数据、执行操作，而不是靠成员手工复制粘贴。连接器涉及外部账号和业务数据，配置时要同时考虑“能用”和“权限最小化”。
| 连接器 | 典型用途 | 接入方式 |
|---|---|---|
| 有赞 | 店铺、商品、订单、评价 | 远程 MCP + OAuth |
| 小鹅通 | 课程、学员、订单 | 远程 MCP + OAuth |
| 云账房 | 财务账套、凭证、报表 | 远程 MCP + OAuth |
| 微盟 | 店铺运营、订单数据 | woscli |
| 飞书 | 文档、消息、日历、审批 | lark-cli |
| 自定义 MCP | 内部系统、数据库、API | MCP 服务配置 |
具体可用连接器以企业后台和当前客户端版本为准。没有列出的系统可以通过自定义 MCP 接入，但需要开发和运维配合。
- 企业已经开通对应厂商账号，并有足够权限创建应用或授权。
- 确认回调地址、网络出口和域名白名单。
- 明确连接器要读哪些数据、执行哪些操作。
- 准备一个测试账号或测试店铺，不要直接连生产主账号。
- 确认令牌保存位置和有效期。
第 1 步：创建或选择连接器
Section titled “第 1 步：创建或选择连接器”在企业后台或客户端连接器面板中新建连接器。需要填写：
| 字段 | 说明 |
|---|---|
| 名称 | 例如「有赞-华东旗舰店」 |
| 类型 | 厂商或自定义 MCP |
| 环境 | 测试/生产 |
| 权限范围 | 只读、读写或特定资源 |
| 负责人 | 谁维护授权和故障处理 |
名称要能区分环境和店铺，避免多个连接器混在一起。
第 2 步：完成授权
Section titled “第 2 步：完成授权”OAuth 类连接器的典型流程：
- 点击授权，跳转到厂商登录页；
- 使用企业账号登录；
- 确认授权范围；
- 回调到客户端或企业服务；
- 令牌加密保存；
- 返回连接器列表，状态变为已连接。
授权时注意：
- 只勾选任务需要的权限；
- 不要在个人账号下授权企业数据；
- 授权后立即做一次只读测试；
- 记录授权账号和到期时间。
第 3 步：配置权限
Section titled “第 3 步：配置权限”连接器权限至少分两层：
- 连接器级：哪些成员可以使用这个连接器；
- 操作级：能读哪些资源、能否写入、能否批量操作。
建议从只读开始，验证数据和流程后再开放写操作。涉及订单、退款、财务凭证等操作时，要求人工确认和审计记录。
第 4 步：连通性测试
Section titled “第 4 步：连通性测试”用低风险请求验证：
请通过「有赞-华东旗舰店」连接器读取最近 7 天的订单数量，只汇总，不修改任何数据。检查：
- 能成功连接，没有证书或网络错误。
- 返回的数据范围与授权范围一致。
- 没有读取未授权的店铺或字段。
- 操作日志中有本次调用记录。
- 令牌没有出现在对话、日志或截图中。
第 5 步：在任务中使用
Section titled “第 5 步：在任务中使用”成员在任务里引用连接器时，写清系统和范围：
使用「云账房-测试账套」连接器，读取 2026 年 9 月的凭证汇总，按科目分类。不要修改账套，不要导出客户明细。Agent 调用连接器前，企业版会按策略要求确认。确认前看清目标系统、操作类型和影响范围。
| 现象 | 可能原因 | 处理 |
|---|---|---|
| 授权跳转失败 | 回调地址不匹配；域名未在白名单 | 核对厂商应用配置和网络策略 |
| 连接状态正常但读不到数据 | 权限范围不足；账号无数据权限 | 检查授权 scope 和厂商账号角色 |
| 令牌过期 | 刷新令牌失效；管理员撤销授权 | 重新授权；检查令牌有效期 |
| 请求超时 | 网络出口、代理或厂商限流 | 检查代理和出口 IP；降低请求频率 |
| 写操作失败 | 权限只读；字段校验失败；审批未完成 | 检查权限和厂商接口要求 |
| 数据范围过大 | 没有限制店铺、账套或时间范围 | 在任务里明确范围；连接器侧限制资源 |
- 令牌加密保存，不写入代码、文档或对话。
- 连接器账号使用最小权限，不用企业主账号。
- 生产环境和测试环境分开授权。
- 定期检查长期未使用的连接器和过期令牌。
- 成员离职或调岗时回收连接器权限。
- 对外部系统的写操作保留审计和回滚方案。