MCP 网关

一句话概述：本文介绍如何在「连接中心 > AI 连接流」中，将一条编排好的连接流发布为标准的 MCP 服务，供外部 AI Agent 发现并调用，帮助集成工程师完成「一个服务、多个工具、各自独立处理逻辑」的搭建。

概述

平台在「AI 连接流」模块下提供「MCP 搭建」能力，只要把触发节点设置为 MCP Server 类型，系统就会自动生成一个可被 Agent 访问的服务地址，并允许在该服务下挂载多个可调用的「工具」（MCP Tool），每个工具对应一段具体的业务逻辑（例如调用某个 HTTP 接口查询订单）。

发布后，平台通过当前版本已验证的 Streamable HTTP 路径提供 MCP 服务。目标客户端是否兼容、鉴权是否满足安全要求，需要在接入前单独验证，不能仅以“支持 MCP 协议”作为可直接使用的结论。

📌

核心价值：无需编写服务端代码，通过可视化编排即可把内部接口、业务逻辑封装为标准 MCP 工具，一键对外发布给 AI Agent 调用。

适用对象

角色	关注点
集成工程师	编排连接流，配置 MCP Server / Tool 节点、动作节点与返回变量
AI 应用开发者	获取发布后的服务地址，将 MCP 服务接入自己的 Agent
平台管理员	管理连接流的上下线状态，保障线上服务稳定

核心概念与流程结构

一条 MCP Server 类型的连接流通常由四类节点组成，理解它们的关系是使用该功能的关键。

节点类型	作用	是否承载业务逻辑
MCP Server 节点	把当前流程发布为一个 MCP Server，配置服务名称、描述与自动生成的服务地址	否，仅为声明入口
MCP Tool 节点	真正对外暴露、可被 Agent 调用的「工具」，定义工具名称、描述与入参 Schema	否，定义工具契约
动作节点	工具被调用后实际执行的业务步骤，最常见为 HTTP 节点，可串联多个	是
MCP 返回变量节点	定义本次工具调用最终返回给 Agent 的结果内容	是，组装返回

一个 MCP Server 节点下可挂载多个 MCP Tool 节点（即一个服务暴露多个工具），每个 MCP Tool 节点后再各自连接自己的一套动作节点和返回变量节点，从而实现「一个服务、多个工具、各自独立处理逻辑」的结构。

图 1：MCP Server 连接流的节点结构关系

6.7.1 中完成节点编排后的 MCP 连接流画布（流程名称已脱敏）

前提条件

已具备「连接中心 > AI 连接流」的访问与编辑权限

已明确要对外暴露的工具能力及其对应的业务接口（如订单查询 HTTP 接口）

已准备好每个工具的入参定义（参数名、类型、是否必填、取值方式等）

6.7.1 已验证能力与使用边界

当前版本已完成以下协议调用验证：

方法	当前验证结果
`initialize`	可建立会话并返回服务能力
`ping`	可用于会话存活检查
`tools/list`	可返回当前服务暴露的工具清单与输入 Schema
`tools/call`	可调用已发布工具，并校验必填参数

initialized 通知可被服务接受。业务调用使用平台生成的 Streamable HTTP 地址和 POST 请求；当前验证中 GET、DELETE 返回 405，不应把它们当作可用调用方式。

最佳实践：使用 MCP 网关功能配置数据库查询 MCP SERVER

说明：以下步骤演示搭建一条「数据库数据查询」MCP 服务的完整链路：创建连接流 → 配置 MCP Server → 添加 MCP Tool → 配置节点动作 → 配置返回变量 → 发布上线。

步骤 1：创建 MCP Server 连接流

在左侧导航进入 连接中心 > AI 连接流 页面

点击右上角「创建连接流」按钮，在弹出选项中选择「手动创建」，进入空白画布编辑页

点击画布中央的「添加触发节点」提示框，弹出「选择入口类型」面板

选择 MCP Server 入口（用于构建可被 Agent 发现和调用的 MCP Server）

图 2：选择入口类型

入口类型	说明
自动化触发器	创建普通的连接流自动化流程
MCP Server 入口	构建可被 Agent 调用的 MCP Server（本文重点）
第三方 MCP Server	标注「后续版本支持」，当前尚不可用

在「选择 MCP Server 入口」子面板中选择「MCP 触发器」，展开后选择 自定义 MCP 触发器（生成 MCP Server，并挂载多个 MCP Tool）

图 2：选择入口类型

步骤 2：配置 MCP Server 节点

点击 MCP 触发器节点打开「节点配置」面板。面板分三栏：左侧「选择变量」（Server 节点作为起点通常为空）、中间参数配置区、右侧「节点测试」区。

在中间配置区填写以下字段：

字段	是否必填	说明与填写指南
`MCP Server 名称`	必填	提供给人类阅读的服务名称，用于在列表和管理界面中识别该服务
`MCP 描述`	必填	说明该服务具备哪些能力、适用什么场景。该描述会提供给 AI Agent，帮助其理解服务能提供哪些工具，建议写得清晰具体
`MCP Server 地址`	只读	占位提示为「保存并发布后生成」，由平台在流程发布上线后自动生成，是外部 Agent 接入调用的入口 URL，无法手动填写

图 3：MCP 触发器节点配置

重要：MCP 描述 直接决定 AI Agent 能否正确理解并选择调用该服务，请用简洁准确的自然语言说明适用场景，避免空泛表述。

步骤 3：配置第一个 MCP Tool ：查询数据库详情信息

在 MCP Server 节点下方点击圆形「+」按钮继续添加节点。

在弹出的「选择 MCP 工具」面板中，点击「MCP 触发器」分类右侧的展开箭头

选择 MCP Tool（定义 MCP Server 对外暴露的工具）

添加完成后，画布上将新增一个带「MCP Tool」标签的节点，与上方 MCP Server 节点以虚线相连

4. 点击该节点打开配置面板，填写以下三项必填内容：

字段	说明
`工具调用名`	Agent 实际调用时使用的技术名称，仅允许小写字母、数字和下划线，例如 `query_sql_item`，机器可读标识
`工具显示名`	面向人类的可读名称，用于界面展示
`工具描述`	Agent 判断「是否应调用该工具」的主要依据，需准确概括使用场景，写得越清楚 Agent 调用准确率越高

配置完成后，在右侧「节点测试」区点击「开始测试」，测试通过后显示绿色「测试成功」，并以 JSON 形式展示模拟返回结果

提示：工具描述 和参数的 描述 字段是 Agent 理解与填参的唯一依据，务必逐一填写清楚。

MCP Tool 节点配置成完成后，需要进行动作节点的配置，在 MCP Tool 节点下方点击圆形「+」按钮继续添加动作节点, 这里我们选择「查询数据库元数据」节点。

点击授权配置，点击「创建新账号」按钮，在弹窗中完成数据库的连接信息的配置。

对象类型参数这里默认使用「表/视图」即可，随后点击右侧的「开始测试」按钮，若数据库信息配置无误，调试结果中将展示详细的数据库表结构信息

随后再次点击「+」按钮，添加「MCP 返回变量」节点，定义这个 MCP 工具的返回参数。在一个完整的数据库查询场景中，Agent 将基于查询到的数据库信息，并结合客户的实际诉求，进行 SQL 语句的编写。

6.7.1 绕行方法：在 MCP 返回变量节点选择上游变量时，搜索框可能无法检索到 MCP Tool 返回值。请展开变量选择器中的 MCP 网关 分类，从分类树中选择目标工具结果，再执行节点测试。

MCP 返回变量节点测试成功（测试数据已脱敏）

步骤 4：配置第二个 MCP Tool ：执行数据库查询

重复与上文相同步骤，添加一个新的 MCP Tool 节点。

定义 MCP Tool 节点的基础信息，与上文一致。

由于在这个工具中，我们需要让 Agent 基于数据库信息进行数据库数据的查询，因此我们需要在工具参数 Schema 中定义 Agent 需要从对话信息中提取的参数，这里我们仅需 Agent 提供 SQL 语句即可，按下图所示进行配置。(Schema 中参数的详细定义以及使用方式详见下文附录说明)

提示：模拟值仅作为当前节点调试时使用，并不代表 MCP 实际执行结果

随后添加「自定义 SQL」节点，选择刚刚使用的授权配置，然后引用 MCP tool 节点定义的参数，如下图所示，若调试正常，可以看到测试结果中根据刚刚配置的模拟值，查询到了正确的数据。

最后添加「 MCP 返回变量」节点，按照上文相同方式，定义当前 MCP 的返回内容。

步骤 5：保存、发布与上线

确认所有节点配置无误后，点击「发布」使流程变为「已上线」状态

发布成功后，MCP Server 节点里的「MCP Server 地址」字段会自动生成真实可用的服务 URL，将其提供给 AI 应用开发者接入

MCP 连接流发布后的上线状态（流程名称、时间和创建人已脱敏）

重要：一旦「已上线」，页面提示「当前流为只读模式，如需编辑，请下线流程」，此时所有节点均不可修改。需先执行「下线」回到可编辑状态修改后，再重新上线，以保证线上服务运行期间配置的稳定性。

步骤 6：测试 MCP SERVER

将获取到的 MCP SERVER 地址配置到 Agent 中进行测试

Agent 将自动基于用户需求进行分析，获取完整数据并返回。

参考：工具参数 Schema 字段说明

在 MCP Tool 节点的「工具参数 Schema」区域，点击「添加工具参数 Schema」可逐个添加参数。每个参数展开后包含以下配置项：

通用配置项（所有类型参数适用）

配置项	说明
`名称`	映射到 `inputSchema.properties` 的 key
`显示名`	人类可读的参数名
`类型`	可选 string、number、integer、boolean、array
`必填`	开关控件，是否必须传入
`取值`	下拉可选「AI 识别」或「固定值」。AI 识别表示由 Agent 根据上下文自动填充，固定值表示写死一个值
`模拟值`	仅用于节点调试测试，不会进入真正的 MCP inputSchema
`示例值`	映射到 `inputSchema.properties.{name}.examples`，帮助 Agent 理解取值范例
`默认值`	Agent 未传值时的回退取值，仅对非必填参数生效
`描述`	Agent 理解该参数含义的唯一依据，务必填写清楚

约束配置项（string / number / integer 类型可按需选填）

验证与测试

平台每个节点右侧都配有独立的「节点测试」面板。建议在正式对外发布前，按从上到下的顺序逐一测试：

验证阶段	验证方法	预期结果
MCP Tool 节点	利用「模拟值」触发测试	入参解析符合预期，返回绿色「测试成功」
HTTP 等动作节点	点击「开始测试」发起真实请求	外部接口正确返回数据，展示状态码/响应头/响应体
MCP 返回变量节点	点击「开始测试」验证整条链路	最终返回内容的结构和字段符合工具描述中承诺的效果
连接流整体	发布上线后查看服务地址	「MCP Server 地址」生成真实可用 URL

检查

这种分节点、分层验证的方式可以有效降低发布后 Agent 调用出错的概率。建议先在草稿状态下完成全部节点配置和自测，确认无误后再执行发布。

连接流列表管理

回到「AI 连接流」列表页，每条流程显示名称、创建时间、更新时间、创建人和状态，操作列提供以下入口：

操作	说明
查看	打开连接流详情/编辑页
上线 / 下线	根据当前状态显示对应按钮
发布	针对「未发布」状态
日志	查看调用日志
复制 / 导出	复用或导出连接流配置
删除	删除连接流

提示：页面右上角提供按名称搜索的输入框，方便对大量连接流进行统一管理和检索。

最佳实践

描述字段决定 Agent 调用准确率

MCP Server 的「描述」、MCP Tool 的「工具描述」、参数的「描述」三处，直接决定 AI Agent 能否正确理解并选择调用。请用简洁准确的自然语言说明适用场景，避免空泛表述。

先自测再发布，减少上下线

线上（已上线）状态下流程不可编辑。建议先在草稿状态完成全部节点配置和分层自测，确认无误后再发布，减少频繁上下线对线上调用的影响。

推荐：为需要精确解析的参数配合「示例值」「格式约束」「正则表达式」，提高 Agent 参数解析的准确性。

不推荐：工具描述写成「查询数据」这类空泛表述，会导致 Agent 无法判断何时应调用该工具。

常见问题

Q：点击右上角的「+」按钮无法添加子节点怎么办？

Q：MCP Server 地址一直显示「保存并发布后生成」？

Q：为什么已上线的流程无法编辑节点？

Q：MCP Tool 节点为什么显示黄色感叹号？

Q：「模拟值」会影响真实的工具入参吗？

Q：「默认值」为什么没有生效？

概述#

适用对象#

核心概念与流程结构#

前提条件#

6.7.1 已验证能力与使用边界#

最佳实践：使用 MCP 网关功能配置数据库查询 MCP SERVER#

参考：工具参数 Schema 字段说明#

验证与测试#

连接流列表管理#

最佳实践#

常见问题#

概述

适用对象

核心概念与流程结构

前提条件

6.7.1 已验证能力与使用边界

最佳实践：使用 MCP 网关功能配置数据库查询 MCP SERVER

参考：工具参数 Schema 字段说明

验证与测试

连接流列表管理

最佳实践

常见问题