接入与管理 MCP 服务

MCP 服务是智能体调用外部能力的标准通道——把外部系统（GitHub、数据库、内部 API 等）按 MCP 协议接进来，智能体就能在对话中直接调用这些工具，不需要为每个外部能力单独开发技能。

MCP 服务在目录里统一管理：接入一次，本工作空间内的智能体都可以绑定复用。本页说明谁能看到、谁能管理，以及接入、测试、绑定与移除的完整流程。

目录卡片展示服务描述、地址、协议与凭证配置标记及最近更新时间；单击卡片打开详情抽屉，编辑 / 移除收在右上角 ⋮ 菜单（无权限时不显示），测试连接固定在卡片底部。

前提条件

• 查看目录：任何能进入管理台的用户均可
• 接入 / 编辑 / 移除服务：当前工作空间可写，且拥有外部工具管理权限（平台员工、当前企业空间的租户管理员、部门管理员、开发者）
• 已从外部系统拿到服务地址（或 OpenAPI 定义文件），以及对方的鉴权方式与凭证

谁能看到、谁能管理

MCP 服务按「归属」分两类，可见性与管理权限如下：

归属	谁能看到	谁能编辑 / 移除
平台共享	所有工作空间	仅平台员工（切到「全部空间」时）
本组接入	仅所属工作空间	该空间的管理员

此外，平台预置的系统内置服务（如知识库检索）由平台自动挂载，任何用户都不可见、不可手动绑定。

工作空间层面的写规则与平台其他资源一致：

• 企业（组织）空间：租户管理员可接入与管理；普通成员只读
• 部门空间：可管理本部门及下级部门的服务；不能操作其他部门的服务
• 只读空间：所有「接入 / 编辑 / 移除」按钮不可用

只读成员可以浏览、测试与查看工具，但不能接入或修改服务。需要调整权限时，请联系租户管理员在角色管理里授予。

接入 MCP 服务

1. 在顶部工具栏把工作空间切换到要接入服务的空间。

2. 在左侧导航栏单击 MCP服务。

3. 单击左上角接入MCP服务。若按钮不可见，说明当前空间只读或当前角色没有外部工具管理权限。

4. 在弹窗中填写：

   字段	说明
   标识名	英文下划线命名（如 github_tool），接入后作为服务标识，不可与已有服务重复
   显示名	中文名称，展示在目录卡片和智能体接入卡片上
   描述	选填，说明该服务能做什么
   协议	Streamable HTTP / SSE / OpenAPI。选 OpenAPI 时改为填写接口定义地址，或上传定义文件（.json / .yaml，不超过 2MB）
   服务地址	外部 MCP 服务的访问地址，需以 http:// 或 https:// 开头
   认证方式	无认证 / Bearer Token / API Key / Basic Auth / OAuth 2.0 / AWS SigV4，按外部服务要求填写
   凭证	提交后不再回显，仅由平台安全持有
   Logo / 来源链接	选填，用于目录卡片展示与溯源
   最大并发请求数	选填，留空表示不限
   高级设置	实例级变量、转发请求头、静态请求头，按外部服务要求配置

5. 单击保存。目录中出现新卡片，带「本组接入」归属（平台共享服务带「平台共享」标记）。

6. 单击卡片上的测试连接，确认能拉到工具列表。工具列表为空或报错时，先检查服务地址与凭证。

绑定到智能体

服务接入后，还要绑定到具体智能体，智能体才能调用这些工具。两种方式：

• 在智能体里添加：进入智能体工作台 → 构建 页签 → 外部工具 面板 → 添加绑定，在弹窗中搜索并勾选一个或多个服务，确定即可。绑定后可单击卡片上的工具范围，只放行部分工具（未勾选的工具对智能体不可见、不可调用）。
• 从资产中心一键接入：在 资产中心 找到该 MCP 服务，单击接入到智能体，选择目标智能体。需要鉴权的服务会在此补录凭证。

绑定完成后，智能体需要重新部署或应用配置才会生效——运行中的实例涉及外部工具变更时会自动重启。

编辑与移除

• 编辑：单击卡片上的编辑修改名称、地址、凭证、并发等配置；保存后已绑定的智能体沿用新配置。
• 移除：单击移除。若已有智能体绑定了该服务，会先列出绑定关系，确认后一并解除；也可选择强制删除。
• 平台共享服务在本部门空间内只能查看与测试，不能编辑或移除——需要变更时请联系平台员工。

预期结果

• 接入成功后，目录出现该服务卡片，状态为可用
• 测试连接能列出该服务登记的工具及其说明
• 绑定该服务的智能体在调试对话中能调用这些工具

常见问题

看不到「接入MCP服务」按钮 当前工作空间是只读空间，或当前角色没有外部工具管理权限。切换到有写权限的空间，或联系租户管理员。

能查看但不能编辑某个服务 该服务是平台共享（平台员工接入），只有平台员工可以修改。

凭证填错了怎么改 在该服务的编辑弹窗里重新填写并保存。凭证提交后不会回显，直接填写新值即可覆盖。

绑定后智能体还是调不到工具 确认智能体已重新部署或应用配置；草稿状态的智能体需要发布并部署后，绑定才随版本生效。

目录里找不到某个服务 本组接入的服务只在所属工作空间可见；系统内置服务由平台自动挂载，不出现在目录中。