反馈已提交

网络繁忙

FineDataLink产品能力MCP化

  • 文档创建者:Wendy123456
  • 历史版本:26
  • 最近更新:Naya 于 2026-10-13
  • icon提示:
    填写 表单,抢先体验FineDataLink MCP!

    1. 概述

    1.1 版本

    FineDataLink 版本
    功能变动
    4.2.20.3&5.0.13.3

    1)支持将部分定时任务读写能力开放给 AI 客户端

    2)用户完成 Token 配置后,可以在 AI 客户端中查询任务、解释任务、查看调度,并在具 备写入权限时发起创建任务(数据同步)、修改调度、复制任务、写回注释等操作

    4.2.21.1&5.0.14.1

    需要更新插件版本为 1.0.0.2

    1)支持通过 AI 查看、管理和删除事件调度
    2)支持查找数据连接资源、查看表或视图结构及预览少量数据
    3)支持查看定时任务数据表血缘
    4)支持查询已发布任务运行记录、日志及运行配置快照
    5)MCP 页面、Token 和调用统一接入 FDL MCP 使用权限控制

    4.2.21.2&5.0.14.21)支持修改已有数据同步、SQL 脚本、参数赋值节点
    2)支持新增和修改调用任务节点,并支持节点启停、连线新增、条件修改及删除
    3)支持执行开发态或发布态任务,可执行整个任务、单节点或节点及下游
    4)支持查询和管理任务参数,创建多层目录以及移动任务和文件夹
    4.2.21.3&5.0.14.31)定时任务资源支持按文件夹浏览和搜索,可查看直接子项或全部后代,并支持资源类型筛选和分页
    2)运行记录支持跨任务查询,可按状态、时间、触发方式、脏数据等条件筛选
    3)大型事件调度配置支持分页查看
    4.2.22.1&5.0.15.1 

    1)任务执行新增「执行至此节点」,可执行目标节点及其全部上游
    2)支持按任务或精确实例批量终止运行
    3)支持查询历史版本,并完成发布、从发布态还原开发态、回滚历史版本
    4)时间调度支持增加、移除或整体替换成员任务
    5)支持任务和文件夹重命名,以及任务描述、画布备注和节点名称等内容维护

    4.2.22.2&5.0.15.21)定时任务资源支持通过任务 ID、精确名称和名称模糊匹配查询,并优化批量查询性能
    2)优化定时任务创建、发布、删除及控制属性管理等批量操作,单次最多支持 50 个任务;批量创建数据同步任务最多支持 500 个同步节点
    3)优化任务调度、运行记录等大数据量场景下的查询性能
    4)增强事件调度及运行记录查询的异常兼容能力,提升 AI 对任务状态和异常信息的判断准确性
    4.2.22.4&5.0.15.41)支持批量创建和修改 Shell、BAT、Python 脚本节点,单次最多支持 50 个节点;
    2)支持批量配置脚本节点的连接、路径、参数、字符集及超时等属性;
    3)增强脚本节点上下游参数引用能力,可自动识别上游参数来源;
    4)完善脚本节点详情查询能力,支持查看配置、参数引用及来源信息

    1.2 应用场景

    针对定时任务,用户不需要先学会所有菜单和配置项,只需要用自然语言描述目标,AI 就可以调用 FDL 的 MCP 能力完成查询、分析和受控写入。

    场景
    该功能作用
    已有较多离线任务的客户快速理解历史任务,降低交接和排查成本
    调度维护压力大的客户用自然语言查询、创建、开关和修改调度,减少找菜单和记配置成本
    需要批量搭建同步任务的客户把重复性 DB 到 DB 同步任务交给 AI 生成,用户只确认计划
    任务文档和注释缺失的客户让 AI 根据任务结构生成维护注释,沉淀到任务内
    需要复制模板任务的客户用已有任务作为模板,批量复制到指定目录
    需要快速排查任务异常的客户查询最近失败、运行中或存在脏数据的任务实例,并结合运行日志和当次配置快照定位问题
    想要批量高效创建数据开发任务的客户通过自然语言创建数据同步、SQL 脚本、参数赋值等节点,并完成节点连线和配置修改
    需要优化调整已有任务的客户无需删除并重新创建节点,可直接修改数据同步、SQL 脚本、参数赋值及调用任务节点配置
    需要管理任务版本的客户查看历史发布版本,对比开发态、发布态和历史版本,并完成发布、还原或回滚

    1.3 功能简介

    1)用户安装「FDL MCP Gateway」插件后,在 FDL 工程中完成 Token 配置。如下图所示:

    11.png

    2)用户将 Token 粘贴到 AI 客户端中,AI 客户端识别 FDL 工程,可使用 AI 工具查看定时任务的任务调度、任务依赖、注释位置等;或者复制定时任务、管理时间调度、快速完成数据开发任务的查看、编辑与编排等。

    1784104676261514.png

    1.4 当前适用范围与边界

    场景
    适用范围与边界
    任务范围当前以离线任务为主,不覆盖实时任务、数据服务和离线管道任务
    任务执行与终止
    • 支持执行整个任务、单个节点、节点及下游,以及执行至指定节点

    • 开发态和发布态执行必须明确选择;发布态整体执行可控制是否触发事件调度下游

    • 支持按任务批量终止运行实例,也支持按精确实例终止;两种终止方式分别沿用主业务接口语义

    • 预览后实例自然结束时按实际状态返回提示,不误报为终止失败

    任务版本管理
    • 支持查询历史版本列表,并通过任务上下文读取指定历史版本

    • 支持发布、还原发布态、回滚到历史版本

    • 发布、还原和回滚前展示节点、连线、参数、任务说明及清洗引用等差异,确认后执行

    • 历史版本读取明确区分「历史配置」和「当前是否已发布」的状态语义

    查询默认逻辑未指定环境时,优先读取发布环境;发布环境不存在时,再回退开发环境
    时间调度能力支持查看、查找、创建、开启、关闭、修改和删除时间调度。修改调度不调整绑定任务
    时间调度成员管理
    • 支持在已有共享时间调度计划中增加、移除或整体替换成员任务

    • 复用前端的任务资格、权限、计划类型和时间规则校验

    • 修改前展示成员变化,确认时重新校验计划和任务状态

    任务资源和画布管理
    • 支持创建多层目录、移动任务或目录,以及任务、目录改名

    • 支持节点改名、画布备注内容修改、清空和删除

    • 保留任务 ID、发布状态、调度关系、事件调度归属、血缘和历史记录,不通过删除重建实现移动或改名

    • 保存后沿用统一的任务保存日志和事件通知语义

    任务依赖能力支持解释事件调度和调用任务依赖;事件调度不在依赖工具中展示,需要单独查询
    同步任务创建能力支持 DB→DB,同步源支持表或 SQL,目标支持已有表或自动建表;PostgreSQL 系列目标支持按数据源能力选择 JDBC、COPY 装载或并行装载
    目录处理指定目录不存在时,会按路径自动创建;批量创建同步任务如果某个自动创建路径下全部任务失败,会清理空目录
    数据连接权限批量创建同步任务会校验来源和目标数据连接权限,避免用户只凭连接名绕过平台授权
    注释写回只写开发态任务,不自动发布;默认不覆盖已有注释,用户明确要求覆盖时才覆盖
    操作保护所有写操作都需要确认;涉及重名对象时会先返回候选,不直接执行
    任务数量限制
    • 创建、发布、删除任务以及查看或管理控制属性时,单次最多处理 50 个任务 

    • 文件夹递归删除不受 50 个任务的数量限制,但仍需要进行权限和依赖检查

    操作次数限制新增节点、连接节点或删除节点时,单次最多处理 50 项操作
    批量操作
    • 批量操作可能出现部分成功,系统会分别返回成功项和失败项,用户只需重新处理失败项

    • 多个连续操作之间不属于同一个整体事务。如果中途某一步失败,之前已经成功完成的操作不会自动撤销

    大数据量查询和分页
    • 事件调度资源、时间调度计划和数据连接查询增加结构化分页信息,包括当前返回数量、总量、是否还有下一页和下一页位置

    • 事件调度上下文续页绑定配置指纹,防止任务组、成员或连线变化后拼接出不存在的关系图

    • 对不同查询范围的分页参数进行明确校验,错误组合直接给出可理解的提示

    • 查询只补充当前页需要的详细信息;时间调度成员、目录信息和权限判断改为批量读取,减少重复查询

    任务定位与权限语义统一
    • 所有定时任务 Tool 统一支持任务 ID 和精确任务名定位

    • 任务名去除首尾空格后区分大小写精确匹配;模糊名称先通过资源查询 Tool 获取稳定 ID

    • 同时提供 ID 和名称时必须指向同一任务;历史重名时返回候选 ID

    • 统一权限失败和资源不存在的提示,避免不同 Tool 对同一名称给出不同结果

    • 批量操作复用一次授权任务索引,避免逐任务重复鉴权

    2. 操作步骤

    2.1 安装插件

    1)填写 表单,获取 FineDataLink MCP 优先体验资格。

    2)参考 插件管理 文档,安装插件。

    注:若工程升级到 4.2.21.1 及之后版本,需要更新插件版本为 1.0.0.2

    2.2 MCP 配置

    注:从 4.2.21.1 起,使用 MCP 前需要管理员为对应用户开放「管理系统 > FDL MCP > 使用」权限。用户仍需同时具备所操作任务、目录和数据连接等资源权限

    1)点击「MCP配置」Tab,再点击「立即生成」按钮,生成用于连接 AI 客户端的访问凭证,可定时任务能力开放给 AI 客户端。如下图所示:

    14.png

    设置项
    说明
    有效期

    1)用于控制 Token 可使用时间;根据实际情况设置 

    1784105562462699.png

    2)到期后,AI 客户端继续使用旧配置会鉴权失败,用户需重新生成并复制配置

    3)若想修改有效期,点击「重置」按钮即可,不重新生成 Token,旧 Token 依然生效

    1784106046149356.png

    MCP接口权限

    1)权限分为读取能力和写入能力;具体权限说明可到产品界面内查看 

    1784105770740631.png

    权限
    说明
    读取

    查找数据连接资源、查看表或视图结构、预览数据、查找定时任务资源、查看定时任务控制属性、查看任务结构、查看定时任务画布、解释任务、查看任务调度、查看任务依赖、查找事件调度资源、查看事件调度配置、读取可注释位置、查找调度、查看数据同步连接类型、查找定时任务数据表、查看定时任务数据表血缘、查看定时任务运行记录、查看定时任务开发态运行日志、查看定时任务运行日志、查看定时任务运行配置快照

    4.2.22.1 及之后版本,新增:查看定时任务参数、查看定时任务历史版本、查找实时管道目录、查找实时管道任务、查看实时管道任务结构、解释实时管道任务、查看实时管道状态、查看实时管道表级指标、查看实时管道数据连接、查看实时管道表、查看实时管道创建选项、查看实时管道表结构、校验实时管道配置

    4.2.22.4 及之后版本,新增:查看定时任务参数、查看同步字段映射预览、查询定时任务历史版本、

    写入

    添加数据同步节点、添加参数赋值节点、添加 SQL 脚本节点、连接定时任务节点、删除定时任务节点、批量管理事件调度组(创建、修改、开启、关闭)、批量管理事件调度连线(新增、删除)、批量删除事件调度组、批量创建同步任务(会校验用户对来源和目标数据连接的权限)、批量创建定时任务、批量发布定时任务、批量管理定时任务控制属性、删除定时任务资源、复制任务、创建时间调度(只支持已发布任务)、启停时间调度、删除时间调度、修改时间调度、写回任务注释

    4.2.22.1 及之后版本,新增:添加调用任务节点、修改数据同步节点、修改参数赋值节点、修改 SQL 脚本节点、修改调用任务节点、管理定时任务节点连线、启用或禁用定时任务节点、执行定时任务、整理定时任务资源、管理定时任务参数、管理定时任务版本、批量终止定时任务运行、管理任务注释与节点名称、创建实时管道目录、创建实时管道任务、追加实时管道表、修改实时管道表映射

    4.2.22.4 及之后版本,新增:批量创建脚本节点、批量修改脚本节点

    涉及创建、修改、删除、复制、写回注释等操作时,AI 不会直接执行。系统会先返回识别结果、影响范围和执行计划;用户明确确认后才会真正写入

    2)若想修改权限,需要点击「重新生成」按钮,生成新的 Token,旧 Token 会失效 

    1784106084651629.png

    Token说明

    1)如果 AI 工具是 Codex/Claude Code,产品界面提供了完整配置(下图中第二个复制按钮),可将其复制到Codex/Claude Code 的配置文件中

    2)如果是其他 AI 工具,复制 MCP 服务的身份认证信息(点击下图中第一个复制按钮),将其填写到 AI 工具 MCP 配置中的 Authorization 请求头中

    24.png

    其他说明

    1)Token 归属于当前 FDL 登录用户 

    2)每个用户仅有一个当前有效 Token

    3)Token 权限由读取能力、写入能力决定,同时受用户自身 FDL 权限约束

    2)MCP Token 生成后,界面如下图所示:

    1784167737239433.png

    2.3 操作安全保障

    步骤
    说明
    执行前预览与确认
    • 创建、发布、删除、连接节点和修改控制属性等操作,默认会先返回操作预览

    • 用户确认后,系统才会正式执行,从而确保实际执行内容与用户看到的预览一致

    • 如果确认前任务内容、画布结构、目录或依赖关系发生变化,原确认信息会失效,系统会要求重新预览和确认,避免基于过期状态执行操作

    权限校验
    • 系统只会返回当前用户有权限查看的任务和文件夹

    • 在执行创建、发布、删除、画布编辑和控制属性管理时,还会再次校验对应权限,避免用户通过 AI 操作无权访问的资源

    • MCP 页面、Token 管理和 MCP 调用本身也受「FDL MCP > 使用」权限控制

    • 已经生成的 Token 不能绕过 FDL 权限,管理员取消权限后,已有 Token 也无法继续调用

    操作记录
    • 任务创建、保存、发布和删除会记录相应的生命周期事件

    • 创建、保存和删除等操作也会记录业务操作日志,便于后续审计和问题追踪 

    2.4 示例:Codex 中使用

    注:本节以 Codex 为例,讲解使用步骤。

    1)复制 Token。如下图所示:

    1784106298382899.png

    2)将 Token 粘贴到 Codex 配置文件 config.toml 中;手动粘贴或者让 Codex 自行配置。如下图所示:

    1784106569191675.png

    3)读取示例:使用 Codex 查询某个定时任务的调度配置信息。如下图所示:

    1784106639889734.png

    4)写入示例:使用 Codex 复制定时任务。

    1784107018471071.png

    FDL 工程中可查看到名称为「测试1」的定时任务。

    1784107100210139.png

    3. 详细功能介绍

    场景
    AI 中如何描述
    查找定时任务和文件夹

    帮我查找名称中包含“订单同步”的定时任务

     找到“销售数据同步”任务所在的完整目录

     查看“财务数据”文件夹下有哪些任务

    查询数据连接和表结构

    找一下“业务库”这个数据连接
    查看 orders 表有哪些字段和主键
    预览 orders 表的几条数据

    查看数据表血缘找到 ods_order 表,并查看它上游 3 层有哪些表和任务
    哪些定时任务使用了 customer_info 表
    批量创建定时任务

    用户可以一次创建一个或多个空白定时任务,并指定任务名称及所在目录。创建完成后,可以继续通过自然语言向任务中添加节点和配置执行流程,无须逐个进入任务页面手动搭建

    例如:

    在“数据同步/财务”目录下创建“应收数据同步”和“应付数据同步”两个定时任务

    查看和编辑任务画布

    用户可以查看定时任务当前的节点、连线和执行顺序,并通过 AI 对任务画布进行基础编辑。目前支持新增数据同步、SQL脚本、参数赋值3类节点 

    例如:

    在“订单同步”任务中增加一个数据同步节点,将业务库的 orders 表同步到数仓。 在数据同步节点后增加一个 SQL 脚本节点,并把两个节点连接起来。 删除任务中的“测试SQL”节点。

    用户还可以:连接不同节点,设置任务执行顺序; 删除指定节点及其关联连线; 查看调整后的任务结构; 在编辑完成后发布任务

    配置数据同步范围

    通过 AI 创建数据同步节点时,可以进一步指定需要同步的数据范围 

    例如:

    只同步 orders 表中 status 等于 1 的数据。 只同步 id、name 和 status 三个字段。 将源表主键作为目标表主键,并自动创建目标表

    发布定时任务

    任务编排完成后,用户可以让 AI 执行发布前检查并发布任务 

    例如:

    检查“订单同步”任务是否可以发布

     发布“订单同步”和“客户同步”两个任务

     对比这个任务的开发态和发布态有什么变化

    运行定时任务执行“订单同步”开发态任务
    只运行“订单清洗”节点
    执行到“数据入仓”节点为止
    终止任务运行找出“订单同步”当前正在运行的实例并停止
    终止这个 executionId 对应的运行实例
    管理任务控制属性

    用户可以通过自然语言查看或修改定时任务的控制属性,不需要完整填写所有配置。控制属性支持仅保存、仅发布、保存并发布三种操作方式,支持管理的属性主要包括:

    属性类别
    可配置内容
    结果通知
    是否通知、通知内容、接收人及通知渠道
    重试与容错超时设置、失败重试、脏数据容错
    日志设置自定义日志等级
    执行设置任务优先级、集群分发方式和执行策略

    例如: 

    把“订单同步”任务优先级调整为高

     开启任务失败重试,失败后重试3次 

     任务执行失败时,通过邮件通知张三 

     将任务日志等级调整为详细。 修改配置后直接保存并发布

    删除任务和文件夹

    用户可以删除指定任务,也可以递归删除某个文件夹及其下属资源 

    例如:

    删除“测试订单同步”任务

     删除“历史测试任务”文件夹及其中的所有任务

    任务运行异常快速定位

    AI 自动查询任务运行记录和执行日志,定位异常节点和失败原因并给出排查建议

    例如:

    帮我分析订单同步这个任务失败的原因

    管理事件调度

    AI 展示任务组关系、触发条件和上下游编排关系,帮助理解复杂调度链路

    例如:

    查看“订单同步”属于哪个事件调度组
    把“订单校验”加入这个任务组
    查看该事件调度组的上下游关系

    批量排查异常任务

    AI 查询任务运行状态,快速筛选异常任务,帮助运维人员集中处理问题

    例如:

    帮我查看今天有哪些任务运行失败或者存在脏数据

    根据数据表定位关联任务及上下游链路

    AI 根据数据表定位引用该表的任务,进一步查询相关任务的依赖关系和上下游链路,帮助用户快速了解数据流转过程和影响范围

    例如:

    帮我查看 customer_info 表被哪些任务使用,以及这些任务的上下游关系

    查看和管理历史版本

    查看“订单同步”的历史发布版本
    对比当前开发态和最新发布态
    把任务回滚到版本 XXX
    用当前发布态还原开发态

    MCP 扩展能力

    MCP 不仅可以让 AI 客户端直接查询和操作 FDL,也可以将 FDL 能力接入飞书等其他平台,拓展更多使用方式






    附件列表


    主题: MCP配置
    • 有帮助
    • 没帮助
    • 只是浏览
    中文(简体)

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭

    文
    档
    AI
    助
    手
    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问 或 前往服务平台 获取技术支持