Docs · 连接器
千问办公连接器接入 MCP 与 Composio 两条路
把外部系统接进工作流的完整说明:支持哪些来源、授权怎么做、权限怎么收、出错怎么查。
两类连接器
| 类型 | 来源 | 授权方式 | 适用 |
|---|---|---|---|
| MCP 连接器 | 钉钉 AIhub | 免登授权导入 | 已在钉钉侧开通的应用与服务 |
| Composio 连接器 | Composio 平台 | 按应用逐个授权 | 常见的 SaaS 工具集成 |
接入流程
- 确认前置条件
MCP 路线要求组织已在钉钉侧开通对应应用;Composio 路线要求有对应账号。
- 导入或添加
MCP:从钉钉 AIhub 导入,免登授权。Composio:在连接器管理里添加并完成 OAuth。
- 最小权限验证
先用只读操作试通一条数据,例如查一条客户记录,确认字段映射正确。
- 在任务中调用
描述清楚「从哪个系统取什么,写到哪个系统的哪个字段」,避免模糊指令。
权限收口三条原则
- 能只读就不给写。写权限意味着它可以改业务数据,出错难回滚;
- 按应用授权,不按账号全开。一个连接器只覆盖一个业务系统;
- 定期复查。人员变动、系统迁移后旧授权应清理,建议季度检查一次。
写入类连接器需要人工确认环节。让 AI 直接改 CRM 状态或写工单,一旦指令理解偏差会污染业务数据。建议流程设计为「生成变更建议 → 人工确认 → 执行」。
常见故障
| 现象 | 原因 | 处理 |
|---|---|---|
| 已授权仍提示重新授权 | 2.0.2 修复过的旧问题 | 升级到 2.1.0 |
| 调用返回空结果 | 权限范围不足或字段名不符 | 核对授权范围与实际字段名 |
| 上游接口报错 | 对方系统接口变更或限流 | 联系对方管理员,降低调用频率 |
| 写入后数据异常 | 字段类型不匹配 | 先写测试记录,确认类型后批量 |