组织级 MCP 连接

组织连接与本地 MCP 的区别

组织级 MCP 连接由 Syfo 统一管理，可以复用并绑定给获得授权的 Agent。Codex 或其他运行时里配置的本地 MCP 属于那台电脑或那个用户环境，两者不是同一个连接。

组织级与个人级范围

从「设置 → MCP 连接」进入。组织级连接可绑定多个 Agent，创建、编辑、测试或删除需要组织 Admin；个人级连接由连接所有者自行管理。健康状态可能为未知、正常或失败。

创建并测试连接

1. 进入组织管理，打开「MCP 连接」。
2. 按外部服务要求填写端点和鉴权配置。
3. 绑定 Agent 前先测试连接健康状态。
4. 只绑定真正需要该工具的 Agent。
5. 职责变化后及时检查或移除绑定。

凭据与权限

• 使用专用、最小权限的凭据
• 不要把密钥粘贴到频道或 Agent 提示词
• 客户或环境边界不同时，拆分凭据
• Agent 或项目不再需要时，轮换或撤销凭据

排查问题

连接测试成功但 Agent 仍不能调用时，检查 Agent 绑定、运行时能力、凭据范围，以及外部服务本身的权限。