MCP 工具接入
为助手连接外部 MCP 服务,在对话中调用已授权的查询与业务工具。
本页目录
了解 MCP 工具#
MCP 是连接 AI 与外部工具的协议。文件、业务接口、数据库、搜索等能力由所连接的服务提供,并通过该服务的授权范围使用。
工具地址必须是支持 MCP 的服务端点;普通业务 API 地址不能直接代替 MCP 地址。
创建工具或关联已有工具#
打开助手的 MCP 工具标签,可以选择:
- 创建工具:填写新服务的连接配置。
- 关联已有工具:使用组织已经配置好的工具。
填写清楚的名称与说明,便于识别工具用途,再选择连接类型并保存。
配置远程连接#
SSE 连接
| 字段 | 说明 |
|---|---|
| URL | MCP 服务的 SSE 地址,必填 |
| 请求头 | 服务要求的认证或其他请求头 |
| 事件读取超时 | 等待事件的时间,默认 60 秒 |
| 连接超时 | 建立连接的等待时间,默认 30 秒 |
HTTP 连接
| 字段 | 说明 |
|---|---|
| URL | MCP 服务地址,必填 |
| 请求头 | 服务要求的认证或内容类型 |
| 请求超时 | 默认 30 秒 |
| 关闭时终止 | 会话结束时是否终止连接 |
从服务提供方取得端点和认证方式。外部连接使用 HTTPS,并根据服务响应速度设置超时。
查看工具状态#
| 状态 | 含义 |
|---|---|
| 已启用 | 助手会加载工具,并可在对话中使用 |
| 已停用 | 保留配置,不加载;可重新启用 |
| 错误 | 初始化或连接失败,需要检查地址、认证与配置 |
测试与排查#
- 保存工具后,检查连接状态。
- 在助手预览中发送确实需要该工具的问题。
- 核对工具返回内容、响应时间和失败提示。
- 认证失败时检查密钥、请求头和服务权限。
- 超时时检查服务可用性与网络,再调整合理的等待时间。
每个助手最多关联 10 个 MCP 工具,单次工具执行超时上限为 300 秒。只启用需要的工具,避免无关调用和等待。
管理工具授权#
只授予接待需要的访问权限,查询场景优先使用只读账号。定期更新密钥,并检查工具调用与访问情况。
工具能力和数据范围取决于外部服务授权。给助手编写清晰的使用说明后,继续通过测试与预览检查实际处理效果。