AI Agent 内置 MCP Tool 节点

功能说明

AI Agent 内置 MCP Tool 节点用于在 Agent 画布中选择平台已经提供的 MCP 工具动作，并让 Agent 在运行过程中按需调用。

本文只说明 AI Agent 画布中的内置工具节点，不是以下两项能力：

MCP Auth：为 MCP 调用配置认证方式和凭证。

MCP 网关：发布和管理面向外部客户端的 MCP 服务与 Tool。

三者名称相近，但使用入口、服务对象和验证方式不同，不能使用“MCP SERVER”作为同一个概念混写。

适用场景

Agent 需要调用平台当前已经提供的内置 MCP 动作。

需要由 Agent 根据对话上下文决定何时调用工具。

需要把用户输入、上下文变量或模型生成值传给工具参数。

需要在 Agent 运行记录中检查工具调用和返回结果。

如果目标是把连接流或 API 发布为供外部 MCP Client 调用的服务，应使用 MCP 网关，而不是本文的画布节点。

添加内置 MCP Tool

AI Agent 画布中的内置 MCP Tool 节点示例

打开 Agent 画布

进入需要配置的 AI Agent，并打开流程或画布编辑页面。

添加工具节点

在工具分类中选择 MCP，并进入当前租户可用的内置工具列表。

选择内置服务

选择 Agent 需要调用的内置 MCP 服务。一个节点只配置当前选择的一个服务。

添加动作

在该服务下添加一个或多个 Agent 可能调用的动作。只保留当前业务实际需要的动作。

配置参数

逐项设置参数来源，可以使用固定值、上下文变量或页面当前提供的 AI 生成方式。

保存节点

保存 Agent 配置，并确认节点与当前 Agent 的绑定关系已经建立。

当前租户可见的服务、动作和参数类型取决于版本、许可证和租户配置。不要根据其他环境的截图承诺某个工具一定存在。

参数配置

配置每个动作参数时，应先确认参数语义，再选择值来源：

固定值：适合环境、范围或枚举等不随对话变化的参数。

上下文变量：适合使用上游节点或用户输入中已经明确取得的值。

AI 生成：适合允许模型根据上下文整理的文本或简单结构化值。

对账号 ID、组织 ID、时间范围、删除开关等高风险参数，不应只依赖模型自由生成。应使用受控变量、枚举或前置校验。

如果当前页面对 JSON 等复杂类型不提供 AI 生成方式，应改用固定结构或经过校验的上游变量，不能在文档中承诺所有参数类型都支持模型自动生成。

保存与运行

节点保存后，还需要运行整个 Agent 才能验证工具是否会被调用。该工具节点不是独立的连接测试页面。

准备测试输入

使用能明确触发目标动作的测试问题，并避免包含真实 Secret 或客户敏感数据。

运行 Agent

从 Agent 的实际运行入口发起对话或测试。

检查调用决策

确认 Agent 在需要时选择了正确的服务和动作，没有调用无关或高风险动作。

检查入参

在运行记录中核对工具入参是否来自预期变量，格式和范围是否正确。

检查返回结果

确认工具返回被 Agent 正确理解，并在最终回答或后续节点中按预期使用。

验证失败路径

分别验证参数缺失、权限不足、服务不可用、超时和工具返回错误时的表现。

变更影响

修改服务、动作或参数后，应重新发布或保存 Agent，并重新执行回归验证。

重点检查：

删除动作后，Agent 不再尝试调用旧动作。

修改参数名或类型后，现有变量映射仍然有效。

新增高风险动作后，是否需要更严格的提示、权限或人工确认。

服务升级后，动作返回结构是否变化。

不能把“节点保存成功”当作“所有动作均已执行成功”。

安全要求

只添加 Agent 实际需要的动作。

高风险动作使用最小权限账号和明确参数约束。

不在提示词、截图或运行记录中暴露 Token、Secret、Cookie 或客户数据。

涉及删除、发送、授权或大范围查询时，应设计人工确认或业务保护。

MCP Auth 中的凭证配置与本文的工具选择分开管理。

面向外部 MCP Client 的访问控制在 MCP 网关中单独验证。

验证清单

文档标题和正文明确这是 AI Agent 内置 MCP Tool 节点。

没有把内置工具节点写成 MCP 网关服务。

没有把 MCP Auth 凭证配置写成节点参数。

节点只包含当前业务需要的服务和动作。

每个参数的来源、类型和约束均已核对。

Agent 能在正确场景调用工具。

参数缺失、权限不足、超时和返回错误均有可解释结果。

运行日志和截图已经脱敏。

常见问题

为什么节点保存后看不到独立测试结果？

内置 MCP Tool 由 Agent 在运行时调用，应运行整个 Agent，并在运行记录中检查工具调用和返回。

可以在一个节点中连接多个 MCP 服务吗？

当前文档按一个节点选择一个内置服务编写；同一服务下可以配置多个动作。目标租户如有不同交互，应以当前页面为准。

自定义 MCP 服务是否一定可选？

不一定。可用服务类型受版本、许可证和租户配置影响，应以当前 Agent 画布实际列表为准。

什么时候使用 MCP 网关？

当目标是把平台能力发布成供外部 MCP Client 发现和调用的服务时，使用 MCP 网关，而不是 AI Agent 内置工具节点。

当前页面参考

先从 AI 连接流列表进入包含 MCP Tool 的流程。

画布展示节点编排上下文；MCP Tool 的节点参数以本文专用截图和当前页面为准。

功能说明#

适用场景#

添加内置 MCP Tool#

参数配置#

保存与运行#

变更影响#

安全要求#

验证清单#

常见问题#

当前页面参考#