跳转到文档内容
进入工作台
文档目录MCP 工具接入

MCP 工具接入

为助手连接外部 MCP 服务,在对话中调用已授权的查询与业务工具。

本页目录

了解 MCP 工具#

MCP 是连接 AI 与外部工具的协议。文件、业务接口、数据库、搜索等能力由所连接的服务提供,并通过该服务的授权范围使用。

工具地址必须是支持 MCP 的服务端点;普通业务 API 地址不能直接代替 MCP 地址。

创建工具或关联已有工具#

打开助手的 MCP 工具标签,可以选择:

  • 创建工具:填写新服务的连接配置。
  • 关联已有工具:使用组织已经配置好的工具。

填写清楚的名称与说明,便于识别工具用途,再选择连接类型并保存。

配置远程连接#

SSE 连接

字段 说明
URL MCP 服务的 SSE 地址,必填
请求头 服务要求的认证或其他请求头
事件读取超时 等待事件的时间,默认 60 秒
连接超时 建立连接的等待时间,默认 30 秒

HTTP 连接

字段 说明
URL MCP 服务地址,必填
请求头 服务要求的认证或内容类型
请求超时 默认 30 秒
关闭时终止 会话结束时是否终止连接

从服务提供方取得端点和认证方式。外部连接使用 HTTPS,并根据服务响应速度设置超时。

共用组织工具#

组织内可以让多个助手关联同一工具,集中维护连接配置。更新共用工具后,所有关联助手都会使用新设置。

工具属于所在组织,只有该组织成员能够访问。调整前检查有哪些助手正在使用,避免影响其他接待任务。

查看工具状态#

状态 含义
已启用 助手会加载工具,并可在对话中使用
已停用 保留配置,不加载;可重新启用
错误 初始化或连接失败,需要检查地址、认证与配置

测试与排查#

  1. 保存工具后,检查连接状态。
  2. 在助手预览中发送确实需要该工具的问题。
  3. 核对工具返回内容、响应时间和失败提示。
  4. 认证失败时检查密钥、请求头和服务权限。
  5. 超时时检查服务可用性与网络,再调整合理的等待时间。

每个助手最多关联 10 个 MCP 工具,单次工具执行超时上限为 300 秒。只启用需要的工具,避免无关调用和等待。

管理工具授权#

只授予接待需要的访问权限,查询场景优先使用只读账号。定期更新密钥,并检查工具调用与访问情况。

工具能力和数据范围取决于外部服务授权。给助手编写清晰的使用说明后,继续通过测试与预览检查实际处理效果。