# 添加自定义 MCP 工具

MCP 用于接入工作区需要的其他工具服务。进入“资源中心 → 工具库 → 自定义工具”，点击新建，打开 MCP 配置表单。

## 准备连接信息

向工具服务维护者确认服务 URL、传输方式、准确的工具名称和认证方式。**MCP Tool Name 必须与服务实际暴露的名称完全一致**，不能只填写 MOI 中便于阅读的显示名称。

## 填写表单

| 字段 | 填写方法 |
| --- | --- |
| 名称（必填） | 给团队使用者看的工具名称 |
| 描述（必填） | 说明能力、适用任务及输入输出 |
| URL（必填） | MCP 服务提供的接入地址 |
| MCP Tool Name（必填） | 服务定义的精确工具名称 |
| 传输方式 | 按服务支持情况选择 SSE 或 HTTP 流式传输 |
| 认证 | 按服务要求选择下表中的方式 |

## 选择认证方式


```{figure} /assets/images/agents/guide-5-hd/20-mcp-auth-options.png
:alt: MCP 配置的认证选项；选择方式后，只填写与服务要求匹配的字段。
:class: agent-guide-image
:figclass: agent-guide-shot

MCP 配置的认证选项；选择方式后，只填写与服务要求匹配的字段。
```


| 方式 | 什么时候用 |
| --- | --- |
| 无认证 | 服务明确不要求认证 |
| Bearer Token | 服务提供 Bearer 令牌 |
| API Key | 服务要求通过指定键传递 API Key |
| Basic | 服务要求用户名和密码认证 |
| 自定义 Headers | 服务要求自定义请求头名称和值 |

当前 OAuth 2.0 选项显示为不可用，不能按已支持的接入流程操作。认证信息只填入相应配置字段，不放入描述或对话提示词。

## 保存与验证

提交后检查自定义工具列表和配置详情，再在目标智能体上[绑定工具](bind-tools.md)。用一个小型查询任务验证返回内容。出现“工具不存在”时先检查 MCP Tool Name；连接失败时检查 URL、传输方式、认证和网络。

这个入口创建的是工具连接，实际能执行的操作由 MCP 服务提供。