Skip to content

MCP 工具 ​

除了终端和文件编辑器,Code 轮次还能调用你们自己 MCP 服务器上的工具,比如内部的工单系统或 schema 注册中心。每个连接都写明 Agent 可以用服务器上的哪几个工具。

前提 ​

  • 服务器支持 Streamable HTTP 方式的 MCP。
  • 它的主机在部署允许的连接主机列表里。云服务上这个列表由我们维护,需要时联系我们。云服务上端点必须是 HTTPS。
  • 需要凭据的话,凭据存在服务端,以引用名的方式使用(见凭据引用)。

添加连接 ​

所有者和管理员打开「设置」,在「自定义 MCP 工具」里添加:

字段填什么
「工具连接名称」给这个连接起个名字
「MCP Streamable HTTP 端点」服务器的 URL
「凭据引用(可选)」服务端密钥的引用名
「明确允许的工具名称(逗号分隔)」1 到 30 个工具名,只能用字母、数字、_ 和 -

然后把连接挂到 code 角色上:发布一个新版本的 code 角色,在「自定义工具连接」里勾上它(见修改角色)。

Agent 能看到什么 ​

一轮进行中,Agent 通过 Yi Code 在沙箱外运行的网关列出和调用工具:

  • 它只看得到角色上各个连接里允许的工具,服务器提供的其他工具一概看不到。
  • 调用其他工具会被拒绝。
  • 网关负责把凭据加到请求上,凭据不会进入沙箱,也不会进入 Agent 的上下文。
  • Agent 没法决定请求发到哪里,只能指定管理员配好的连接上的某个工具。
  • 连接在一轮开始时固定,修改连接不会影响已经在跑的轮次。

只读角色,包括 Ask,永远拿不到 MCP 工具。

通过 MCP 提供知识 ​

如果想让 MCP 服务器提供参考资料,而不是当工具用,就把它添加为 mcp 类型的知识源。见知识库。