> For AI agents: the complete documentation index is available at https://docs.danqiuos.com/llms.txt, the full documentation bundle is available at https://docs.danqiuos.com/llms-full.txt.

# 企业连接与集成

## 让数字员工进入真实业务入口

企业连接层将协作平台、外部系统、资料来源和业务事件接入数字员工的工作流程。当前开发指南覆盖飞书、企业微信、钉钉、微信等外部消息渠道；具体机器人或嵌入方式应以实际租户支持的入口为准。邮件通过入站能力接入。渠道会话与系统业务连接分别配置，参见 [外部消息渠道](https://docs.danqiuos.com/platform/channels.md)。

连接的目的在于完成一个具体闭环：从哪里收到工作、读取什么依据、向哪里回写结果、通知谁。企业可按自身系统和授权条件逐步装配，无需先接完全部系统。

## 选择连接方式

| 业务条件      | 优先考虑          | 配置重点          |
| --------- | ------------- | ------------- |
| 已有标准连接器   | 系统集成连接器       | 管理员配置凭据与可用工具  |
| 企业已有或自建服务 | MCP           | 注册服务并授权所需方法   |
| 系统产生状态事件  | Webhook 或邮件入站 | 来源、字段、员工与异常处理 |
| 只有网页入口    | 浏览器工作台        | 登录态、页面流程与人工接管 |
| 企业资料留在本地  | 资料同步能力        | 同步范围、更新与访问边界  |

MCP 让员工发现并调用已授权的服务、工具和资源；系统集成连接器由平台托管凭据与运行器。两种方式都需要验证实际环境中的服务是否可用，不能因为平台具备连接机制，就假定某个企业系统已接通。

## 从发现能力到真实操作

先确定目标 team、业务系统、连接账号、配置责任人和允许使用的员工，再按目标动作发现能力。系统集成通过 `services_search` 查找团队已连接的服务和工具，通过 `services_execute` 执行；MCP 先用 `mcp_list_servers`、`mcp_list_tools` 发现服务和工具，再使用 `mcp_call_tool`。需要资料时，`mcp_list_resources` 和 `mcp_read_resource` 用于发现与读取资源。

连接后的具体工具、参数和资源以实际发现结果为准。本页不预设某个 CRM、ERP 或数据库已经接通。先让目标员工完成一次真实查询；需要写入时，再执行一次已授权业务操作，并回到目标系统核对记录。连接成功只证明连接条件满足，不能证明所有业务方法均可用。

企业私有服务还需要验证 [设备、网络和 Secret](https://docs.danqiuos.com/platform/enterprise-access.md)，资料同步后的可检索性则要检查 [知识库权限与索引](https://docs.danqiuos.com/platform/knowledge-memory.md)。完整入口见 [能力速查](https://docs.danqiuos.com/reference/overview.md)。

## 示例：接入一条客户线索

先约定表单或邮件携带的姓名、联系信息、来源和需求，再把事件交给销售助理。员工按 [技能](https://docs.danqiuos.com/build/skills.md) 核对必填信息，在业务台账中建档或提出疑似重复项，并创建后续跟进任务。

设计时同时约定缺字段、来源不可信和连接失败的处理方式。若结果需要发给业务人员，还要单独配置接收人解析、渠道绑定与送达检查；事件触发成功不等于消息已送达。

## 权限边界与验收

MCP 授权可以细化到方法，员工只应使用完成岗位所需的部分。凭据由受控配置管理，不应写入提示词、普通文档或对话。外部用户能进入聊天，也不意味着已经拥有内部数据访问权。

验收应检查调用的服务与方法、输入、返回结果、业务回写以及通知结果。写操作结果不明确时，不应直接重复调用，以免产生重复记录或业务动作。至少测试一次无权限、缺少绑定或连接失败的路径，并确认能留下可诊断记录。
