跳到主要内容

MCP 工具

MCP 用于让智能体连接由外部服务提供的工具。开始前,向服务提供方确认连接地址、传输协议、需要的凭据及允许执行的操作。

添加或配置工具​

新版工具目录和连接状态

  1. 进入 智能体 → 工具。内置工具使用卡片上的配置入口。接入已有外部服务时,选择 添加外部工具。
  2. 填写工具名称、服务地址和协议。表单提供的协议包括 SSE 和 Streamable HTTP,请选择服务端实际支持的方式。
  3. 服务要求鉴权时,使用配置表单提供的凭据字段。请按服务方要求填写请求头、令牌或连接参数。
  4. 使用界面提供的连接检查,并在工具列表核对连接状态和可用工具。失败时检查服务可达性、协议、凭据有效期和权限。
  5. 在 能力配置 或会话 工具 入口启用工具,用可核对的样例执行一次,检查返回结果。

通过 MCP 仓库管理工具​

工具栏的创建菜单提供 新建仓库 和从仓库浏览的入口。已有对外服务时可直接使用 添加外部工具 完成连接。需要托管和维护 MCP 资源时,可在仓库中维护说明和配置,再按站点提供的入口将目标工具接入工作台。更新仓库内容后,请在实际使用的智能体里验证连接与调用。

配置 GitLab 凭据​

使用支持 GitLab 的工具时,按 配置 GitLab 凭据 添加和验证令牌。

按失败阶段检查​

阶段现象优先核对
配置连接连接状态异常或未加载工具列表服务 URL、SSE 或 Streamable HTTP 协议、凭据有效期与网络可达性
关联到智能体工具已连接但能力配置无法选用智能体类型、当前账号授权、工具是否启用
运行能调用但返回无权限外部系统身份、项目范围、操作权限
运行模型没有发起工具调用当前模型与配置、指令是否明确说明要用哪个工具完成什么操作

首次验证可选只读场景,例如查询一条测试记录。在会话中展开调用卡片,核对目标工具、状态和返回值。更新连接参数后用同一请求复测。