将一个 MCP 工具，接入企业智能体。

开始前，准备一项可以核对结果的查询

先选一个输入和预期结果都明确的任务，例如按商品编号查询测试库存。确认服务提供方提供的是兼容的 Streamable HTTP MCP 端点，并准备接口说明、认证方式和允许访问的资源范围。

• 当前账号可以查看 MCP 服务；创建连接、修改工具策略还需要相应的管理权限。
• 准备一个可使用的智能体，以及这个智能体允许访问的模型和资料。
• 让服务维护人确认执行请求从哪台服务发出、能否到达端点，以及远端账号实际拥有的权限。
• 优先使用测试数据和只读工具，先证明一次查询正确，再逐步增加写入能力。

第一步：添加 MCP 连接

通用连接默认访问公网 HTTPS。HTTP 或私网服务需要运维在真正发出请求的一端配置明确的访问许可。服务地址中不应嵌入账号、密码或认证查询参数。

1. 在管理后台打开“MCP 服务”，选择添加连接。
2. 填写连接名称、服务地址和用途说明。名称可直接采用业务用途，例如“商品库存查询”。
3. 根据服务提供方要求选择认证方式，填写凭据；需要自定义请求头时同时填写请求头名称。
4. 核对超时设置，保存连接。保存后继续进行连接验证与工具发现。

第二步：测试发现，保存工具策略

工具的风险分类需要结合服务方的实现核对。名称看起来像查询，并不能证明工具内部一定没有写入行为。远端账号的权限也应与计划启用的功能匹配。

1. 在连接卡片执行连接验证，等待工具目录读取完成。连接验证成功只说明当前连接与工具发现通过。
2. 打开工具列表，逐项查看工具名称、说明和参数，启用本次任务需要的工具。新发现的工具默认关闭。
3. 按工具的实际作用设置执行风险：读取、写入、外部操作或删除等破坏性操作。
4. 核对“执行前审批”，保存工具策略。涉及业务变更时，先在测试环境验证确认与拒绝两条路径。

第三步：绑定到指定智能体

连接验证、工具启用和智能体绑定是不同配置。只完成连接保存，工具不会因此自动对所有智能体开放；平台授权连接和企业自建连接的维护责任也不同。

1. 打开目标智能体的编辑页，在“MCP 工具”区域找到刚刚验证的连接。
2. 展开“工具选择”，勾选该智能体需要使用的具体工具，核对已选数量和工具状态。
3. 确认使用范围。如果没有跨企业应用的使用需求，保持该连接只服务于当前已明确授权的范围。
4. 保存智能体配置，按团队的发布流程核对生效版本，再从实际使用入口测试。

怎样判断这次接入可以使用？

管理后台的“调用记录”可用于查看连接调用情况；执行是否完成，还要结合任务记录与业务系统中的实际结果判断。

连接后仍不能调用，先检查这些位置

本教程适用于通用远程 Streamable HTTP MCP 连接。stdio 本地进程、旧独立 HTTP+SSE 传输及通用 OAuth 登录不能直接套用上述步骤；飞书专用连接有独立的授权流程。MCP 返回的文件路径也不自动成为平台中可下载的交付文件。