1. MCP 功能
专属集成平台
  • 快速开始
    • 集成平台概览
  • 身份与用户管理
    • 用户管理
      • 用户与组织架构管理
      • 上下游用户关系视图
    • 角色管理
      • 角色管理配置说明
    • 属性管理
      • 属性管理配置说明
      • IDAAS 扩展物理字段使用说明
    • 上游身份数据集成
      • 通讯录身份集成概述
      • 删除治理与待处理列表功能说明
      • 集成连接器配置指南
        • 通讯录集成-泛微
        • 通讯录集成-飞书
        • 通讯录集成-企业微信
        • 通讯录集成-AD
        • 通讯录集成-睿人事
        • 通讯录集成-北森
        • 通讯录集成-SCIM
        • 通讯录集成-用友EHR
        • 通讯录集成-Azure AD
        • 通讯录集成-致远
        • 通讯录集成-LDAP
        • 通讯录集成-数据库
        • 通讯录集成-钉钉
          • 基础说明
          • 钉钉集成连接器如何配置属性映射
      • 通过连接流实现身份集成
        • 在连接流画布中完成身份集成配置
      • 身份集成常见问题
        • 常见问题 & 排错指南
        • 如何实现已停用用户的自动恢复能力
    • 下游身份数据同步
      • 通讯录同步概述
      • 同步连接器配置指南
        • 通讯录同步-企业微信
        • 通讯录同步-AD
        • 通讯录同步-用友U8C
        • 通讯录同步-钉钉
          • 基础说明
          • 如何配置部门职位扩展字段
      • 通过连接流实现身份同步
        • 使用连接流实现身份下游同步
      • 身份同步常见问题
        • 常见问题 & 排错指南
        • 使用代理网关进行身份同步
  • 认证源管理
    • 认证源基础说明
      • 认证源选型说明
      • 认证源管理概述
    • 认证源配置指南
      • 基础协议配置
        • 认证源-CAS协议
        • 认证源-OIDC协议
        • 认证源-OAuth2协议
      • 三方认证源配置手册
        • 认证源-钉钉
        • 认证源-AD
        • 认证源-飞书
        • 认证源-LDAP
        • 认证源-微信
        • 认证源-微信公众号
        • 认证源-Google Workspace
        • 认证源-AD Azure
        • 认证源-美云智数
        • 认证源-企业微信
  • 应用管理
    • 基础说明
      • 应用管理概述
      • 应用创建与配置
    • 应用单点登录
      • 单点登录概述
      • 单点登录配置
      • 单点登出配置
      • 授权范围配置
      • 自定义集成单点登录配置说明
      • 应用密码代填
      • 应用网关
      • 单点登录配置指南
        • 单点登录-OIDC
        • 单点登录-SAML协议
        • 单点登录-OAuth2
        • 单点登录-CAS协议
        • 单点登录-钉钉SSO
        • 单点登录-分贝通
        • 单点登录-用友NCC
        • 单点登录-宜搭
        • 单点登录-泛微OA
        • 单点登录-致远OA
        • 单点登录-金蝶云星空
        • 单点登录-中国电子云邮箱
        • 单点登录-阿里云控制台(RAM)
        • 单点登录-纷享销客应用
        • 单点登录-纷享销客待办
        • 单点登录-Exchange
        • 单点登录-网易企业邮箱
        • Exchange-双入口配置指南
    • 应用授权管理
      • 应用授权概述
      • 基于组织架构和用户授权
      • 基于角色授权(RBAC)
      • 基于用户属性授权(ABAC)
      • 用户自主申请应用(OA审批授权)权限
    • 应用分发
      • 企业应用分发
      • ABM应用分发
    • 使用应用调用集成平台 OPENAPI
      • M2M接口授权
      • 接口调用权限配置说明
  • 连接中心
    • 产品概述
      • 什么是 AI 连接流
      • AI 连接流的典型使用场景
    • 基础功能
      • 流程运行日志
      • 功能概览
      • 如何创建 AI 工作流
      • 授权凭证管理
      • 错误处理
    • 节点说明
      • 节点基础类型说明
      • 数据处理节点
        • 文本处理节点
        • 数组处理
        • 数据集合节点
      • 文件处理节点
        • 「Base64 转 URL」动作说明
        • 「PPT分页切割」动作说明
      • 应用节点
        • Teambition
        • 金蝶云 K3Cloud
      • 内置节点
        • 子流程调用
        • 缓存处理
        • 分支节点
        • 循环执行
        • MYSQL 触发动作说明
        • 数字签名
        • Webhook触发
        • 缓存列表处理
        • 条件分支
        • FTP
        • 延时节点
        • 模型子节点
        • MCP SERVER 工具
        • 邮件发送
        • 存储子节点
        • 工具子节点
        • HTTP 请求
        • 变量节点
        • 加解密节点
        • 返回变量
      • 运维管理节点
        • 数据校验节点
      • AI节点
        • 构建你的第一个 AI Agent
        • AI 浏览器操作节点
        • AI Agent节点使用指南
        • AI 消息对话节点 & 组件嵌入
    • MCP 功能
      • MCP 网关
  • 审计日志
    • 管理员行为日志
    • 用户变更日志
    • 接口调用日志
    • 用户行为日志
    • 消息发送日志
  • 权限中心
    • 管理员账号管理
    • 管理员角色管理
  • 品牌设置
    • 登录页设置
      • 登录页面配置
      • 登录页CSS自定义页面样式
      • CSS定制页面内容:样式修改指南及故障排除
    • 短信设置
      • 短信模板配置
      • 短信服务使用及签名修改使用指南
      • 短信服务-自定义连接流配置
      • 阿里云短信网关配置指引
    • 邮件设置
      • 邮件模板配置
      • 通过自定义连接流发送邮件
      • SMTP 配置与测试支持文档
    • 企业消息设置
      • 企业消息配置
      • 企业消息(钉钉_飞书)配置
    • 分发页面设置
      • 分发页面设置
  • 平台设置
    • 功能概述
    • 授权管理
    • 代理网关
    • 授权信息
    • 登录策略配置
      • 弱密码检测功能说明
      • 登录流程配置
      • 自动登录功能配置
    • MFA 配置
      • MFA基础配置
      • 使用连接流自定义 MFA 策略
      • 实现 MFA 与专属钉钉的设备管理联动配置
    • 运维日志
      • 运维日志下载
  • 最佳实践
    • MCP Auth 使用指南
    • AD-LDAP接入指南
    • 第三方平台应用创建指南
      • 钉钉
        • 钉钉全套集成指南
        • 创建钉钉开放平台应用
      • 飞书
        • 飞书全套集成指南
        • 创建飞书开放平台应用
      • 企微
        • 企业微信全套集成指南
        • 创建企业微信开放平台应用
  • 开放接口
    • 鉴权认证
      • 获取access_token(请求体方式)
      • 获取access_token(Basic认证方式)
    • 用户管理
      • 查询用户
      • 创建用户
      • 根据多个条件过滤并查询用户信息
      • 根据用户帐号获取用户信息
      • 修改用户
      • 启用/禁用用户
      • 删除用户
      • 修改用户密码
    • 组织部门
      • 获取组/部门的列表
      • 创建组/部门
      • 根据组/部门ID获取组/部门的信息
      • 修改组/部门
      • 删除组/部门
      • 根据组/部门ID获取下级组/部门信息
      • 过滤部门信息
    • 角色管理
      • 创建角色
      • 获取单个角色详情
      • 修改角色
      • 删除角色
      • 查询角色列表
      • 根据应用ID和用户ID获取角色列表
      • 查看角色所对应的用户列表
      • 给多个用户添加静态角色
      • 删除用户静态角色
      • 获取用户的角色信息
    • 连接中心
      • Webhook启动连接流
    • 事件通知
      • 连接器事件通知
  1. MCP 功能

MCP 网关

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

概述#

平台在「AI 连接流」模块下提供「MCP 搭建」能力,只要把触发节点设置为 MCP Server 类型,系统就会自动生成一个可被 Agent 访问的服务地址,并允许在该服务下挂载多个可调用的「工具」(MCP Tool),每个工具对应一段具体的业务逻辑(例如调用某个 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 节点后再各自连接自己的一套动作节点和返回变量节点,从而实现「一个服务、多个工具、各自独立处理逻辑」的结构。
image.png
图 1:MCP Server 连接流的节点结构关系

前提条件#

已具备「连接中心 > AI 连接流」的访问与编辑权限
已明确要对外暴露的工具能力及其对应的业务接口(如订单查询 HTTP 接口)
已准备好每个工具的入参定义(参数名、类型、是否必填、取值方式等)

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

说明:以下步骤演示搭建一条「数据库数据查询」MCP 服务的完整链路:创建连接流 → 配置 MCP Server → 添加 MCP Tool → 配置节点动作 → 配置返回变量 → 发布上线。
1
步骤 1:创建 MCP Server 连接流
1.
在左侧导航进入 连接中心 > AI 连接流 页面
2.
点击右上角「创建连接流」按钮,在弹出选项中选择「手动创建」,进入空白画布编辑页
3.
点击画布中央的「添加触发节点」提示框,弹出「选择入口类型」面板
4.
选择 MCP Server 入口(用于构建可被 Agent 发现和调用的 MCP Server)
image.png
图 2:选择入口类型
入口类型说明
自动化触发器创建普通的连接流自动化流程
MCP Server 入口构建可被 Agent 调用的 MCP Server(本文重点)
第三方 MCP Server标注「后续版本支持」,当前尚不可用
5.
在「选择 MCP Server 入口」子面板中选择「MCP 触发器」,展开后选择 自定义 MCP 触发器(生成 MCP Server,并挂载多个 MCP Tool)
image.png
图 2:选择入口类型
2
步骤 2:配置 MCP Server 节点
点击 MCP 触发器节点打开「节点配置」面板。面板分三栏:左侧「选择变量」(Server 节点作为起点通常为空)、中间参数配置区、右侧「节点测试」区。
在中间配置区填写以下字段:
字段是否必填说明与填写指南
MCP Server 名称必填提供给人类阅读的服务名称,用于在列表和管理界面中识别该服务
MCP 描述必填说明该服务具备哪些能力、适用什么场景。该描述会提供给 AI Agent,帮助其理解服务能提供哪些工具,建议写得清晰具体
MCP Server 地址只读占位提示为「保存并发布后生成」,由平台在流程发布上线后自动生成,是外部 Agent 接入调用的入口 URL,无法手动填写
Xnip Helper 2026-07-05 16.37.22.png
图 3:MCP 触发器节点配置
重要:MCP 描述 直接决定 AI Agent 能否正确理解并选择调用该服务,请用简洁准确的自然语言说明适用场景,避免空泛表述。
3
步骤 3:配置第一个 MCP Tool :查询数据库详情信息
在 MCP Server 节点下方点击圆形「+」按钮继续添加节点。
1.
在弹出的「选择 MCP 工具」面板中,点击「MCP 触发器」分类右侧的展开箭头
image.png
2.
选择 MCP Tool(定义 MCP Server 对外暴露的工具)
3.
添加完成后,画布上将新增一个带「MCP Tool」标签的节点,与上方 MCP Server 节点以虚线相连
image.png
4. 点击该节点打开配置面板,填写以下三项必填内容:
字段说明
工具调用名Agent 实际调用时使用的技术名称,仅允许小写字母、数字和下划线,例如 query_sql_item,机器可读标识
工具显示名面向人类的可读名称,用于界面展示
工具描述Agent 判断「是否应调用该工具」的主要依据,需准确概括使用场景,写得越清楚 Agent 调用准确率越高
5.
配置完成后,在右侧「节点测试」区点击「开始测试」,测试通过后显示绿色「测试成功」,并以 JSON 形式展示模拟返回结果
image.png
提示:工具描述 和参数的 描述 字段是 Agent 理解与填参的唯一依据,务必逐一填写清楚。
6.
MCP Tool 节点配置成完成后, 需要进行动作节点的配置, 在 MCP Tool 节点下方点击圆形「+」按钮继续添加动作节点, 这里我们选择「查询数据库元数据」节点。
image.png
7.
点击授权配置,点击「创建新账号」按钮,在弹窗中完成数据库的连接信息的配置。
image.png
8.
对象类型参数这里默认使用「表/视图」即可, 随后点击右侧的「开始测试」按钮,若数据库信息配置无误,调试结果中将展示详细的数据库表结构信息
image.png
9.
随后再次点击「+」按钮,添加 「MCP 返回变量」节点,定义这个 MCP 工具的返回参数。 在一个完整的数据库查询场景中,Agent 将基于查询到的数据库信息,并结合客户的实际诉求,进行 SQL 语句的编写。
image.png
4
步骤 4:配置第二个 MCP Tool :执行数据库查询
1.
重复与上文相同步骤,添加一个新的 MCP Tool 节点。
image.png
2.
定义 MCP Tool 节点的基础信息,与上文一致。
image.png
3.
由于在这个工具中,我们需要让 Agent 基于数据库信息进行数据库数据的查询,因此我们需要在工具参数 Schema 中定义 Agent 需要从对话信息中提取的参数,这里我们仅需 Agent 提供 SQL 语句即可,按下图所示进行配置。(Schema 中参数的详细定义以及使用方式详见下文附录说明)
image.png
提示:模拟值仅作为当前节点调试时使用,并不代表 MCP 实际执行结果
4.
随后添加「自定义 SQL」节点,选择刚刚使用的授权配置,然后引用 MCP tool 节点定义的参数,如下图所示,若调试正常,可以看到测试结果中根据刚刚配置的模拟值,查询到了正确的数据。
image.png
5.
最后添加「 MCP 返回变量」节点,按照上文相同方式,定义当前 MCP 的返回内容。
image.png
5
步骤 5:保存、发布与上线
1.
确认所有节点配置无误后,点击「发布」使流程变为「已上线」状态
2.
发布成功后,MCP Server 节点里的「MCP Server 地址」字段会自动生成真实可用的服务 URL,将其提供给 AI 应用开发者接入
image.png
重要:一旦「已上线」,页面提示「当前流为只读模式,如需编辑,请下线流程」,此时所有节点均不可修改。需先执行「下线」回到可编辑状态修改后,再重新上线,以保证线上服务运行期间配置的稳定性。
6
步骤 6:测试 MCP SERVER
1.
将获取到的 MCP SERVER 地址配置到 Agent 中进行测试
2.
Agent 将自动基于用户需求进行分析,获取完整数据并返回。
image.png

参考:工具参数 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:「默认值」为什么没有生效?
修改于 2026-07-05 10:14:06
上一页
AI 消息对话节点 & 组件嵌入
下一页
管理员行为日志
Built with