跳到主要内容

MCP 客户端

**模型上下文协议（MCP）**是向 AI 模型开放工具的开放标准。许多服务都提供 MCP 服务器，您也可以自己编写。AI MCP 客户端将 MonoChat 连接到一个 MCP 服务器，这样该服务器提供的工具就可以交给您的 AI 节点和 AI 智能体使用，与您在 MonoChat 中编写的 AI 工具函数并用。

您可以在设置 › 自动化 › AI MCP 客户端中管理它们。

工作原理​

  1. 您添加 MCP 服务器的地址并连接。MonoChat 会读取该服务器提供的内容：工具、资源、资源模板和提示词。
  2. 保存时，MonoChat 会将该列表保留为客户端的内容。
  3. 在创建 AI 聊天补全节点或 AI 智能体节点中，您可以选择希望该节点拥有的工具，并可以为模型重写每个工具的描述。
  4. 在对话过程中，由模型决定何时调用工具；MonoChat 会调用 MCP 服务器，并将结果返回给模型。

节点只能使用您添加到该节点的工具，因此每个节点只会看到它所需要的内容。

添加 MCP 客户端​

  1. 前往设置 › 自动化 › AI MCP 客户端，点击 +（创建）。

  2. 填写各字段：

    字段描述
    名称服务器的名称，在节点抽屉中显示在其每个工具的旁边。
    描述可选的备注。
    版本MonoChat 连接时向服务器声明的客户端版本，例如 1.0.0。
    端点MCP 服务器的基础 URL。MonoChat 通过 <Endpoint>/sse 使用 SSE 传输进行连接，因此请输入不带 /sse 的地址。
    认证类型None、Basic（需填写用户名和密码）或 Bearer（需填写令牌）。凭据会随客户端一并保存。

  3. 点击连接。MonoChat 会连接到服务器，并在各标签页中显示它找到的内容：

    • 服务器信息：服务器的名称、版本、协议版本和说明。
    • 工具：每个工具的名称和描述。
    • 资源、资源模板和提示词（如果服务器提供的话）。

  4. 如果列表看起来没问题，点击保存。如需更改地址并重试，请点击旁边的断开连接按钮。

提示

如果连接失败，请检查该端点是否可从互联网访问、服务器是否支持 SSE 传输，以及 URL 末尾是否已经带有 /sse。

更新工具列表​

当 MCP 服务器新增或更改了工具时，请通过更新打开该客户端。MonoChat 会重新连接并显示当前内容；点击更新即可保存新的列表。

删除客户端也会删除其内容，因此节点会失去来自该客户端的工具。

为节点提供工具​

创建 AI 聊天补全节点​

  1. 打开该节点并滚动到 AI MCP 客户端内容工具设置。
  2. 点击设置 AI MCP 客户端内容工具。AI MCP 客户端内容工具抽屉会列出已添加到该节点的工具。
  3. 点击 +（创建），然后在 AI MCP 客户端内容工具中选择一个工具。工具以 <client name> - <tool name> 的格式列出。
  4. 描述会自动填入工具自身的描述。如果您想更精确地告诉模型何时使用该工具，可以进行编辑，例如“用它按订单号查询订单”。描述为必填项。
  5. 对每个工具重复上述操作，然后保存该节点。

您可以在同一个抽屉中更新工具的描述，或将其从节点中移除。

AI 智能体节点​

AI 智能体节点在其工具设置部分有同样的设置 AI MCP 客户端内容工具按钮。在每个 Harness 上，所选的 MCP 工具都会与该节点的 AI 范围和 AI 工具一起提供给智能体。请参阅 AI 智能体。

信息

智能体运行时会检查该节点上的每个 MCP 工具是否仍存在于您的工作区中。如果您删除了某个节点正在使用的 MCP 客户端，该节点的运行将失败，并提示 “An AI scope or MCP tool was not found in this workspace.”，直到您将该工具从节点中移除。

权限​

访问权限由角色权限 Read / Create / Update / Delete AI MCP clients in automation 和 Read AI MCP client contents in automation 控制。请参阅角色。