提示:1. 概述
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 4.2.20.3 | 1）支持将部分定时任务读写能力开放给 AI 客户端 2）用户完成 Token 配置后，可以在 AI 客户端中查询任务、解释任务、查看调度，并在具备写入权限时发起创建任务（数据同步）、修改调度、复制任务、写回注释等操作 |
1.2 应用场景
针对定时任务，用户不需要先学会所有菜单和配置项，只需要用自然语言描述目标，AI 就可以调用 FDL 的 MCP 能力完成查询、分析和受控写入。
| 场景 | 该功能作用 |
|---|---|
| 已有较多离线任务的客户 | 快速理解历史任务，降低交接和排查成本 |
| 调度维护压力大的客户 | 用自然语言查询、创建、开关和修改调度，减少找菜单和记配置成本 |
| 需要批量搭建同步任务的客户 | 把重复性 DB 到 DB 同步任务交给 AI 生成，用户只确认计划 |
| 任务文档和注释缺失的客户 | 让 AI 根据任务结构生成维护注释，沉淀到任务内 |
| 需要复制模板任务的客户 | 用已有任务作为模板，批量复制到指定目录 |
1.3 功能简介
1）用户安装「FDL MCP Gateway」插件后，在 FDL 工程中完成 Token 配置。如下图所示：
2）用户将 Token 粘贴到 AI 客户端中，AI 客户端识别 FDL 工程，可使用 AI 工具查看定时任务的任务调度、任务依赖、注释位置等；或者复制定时任务、删除时间调度、创建时间调度、修改时间调度等。
1.4 当前适用范围与边界
| 场景 | 适用范围 |
|---|---|
| 任务范围 | 当前以离线任务为主，不覆盖实时任务、数据服务和离线管道任务 |
| 查询默认逻辑 | 未指定环境时，优先读取发布环境；发布环境不存在时，再回退开发环境 |
| 时间调度能力 | 支持查看、查找、创建、开启、关闭、修改和删除时间调度。修改调度不调整绑定任务 |
| 任务依赖能力 | 支持解释事件调度和调用任务依赖；时间调度不在依赖工具中展示，需要单独查询 |
| 同步任务创建能力 | 支持 DB→DB，同步源支持表或 SQL，目标支持已有表或自动建表；PostgreSQL 系列目标支持按数据源能力选择 JDBC、COPY 装载或并行装载 |
| 目录处理 | 指定目录不存在时，会按路径自动创建；批量创建同步任务如果某个自动创建路径下全部任务失败，会清理空目录 |
| 数据连接权限 | 批量创建同步任务会校验来源和目标数据连接权限，避免用户只凭连接名绕过平台授权 |
| 注释写回 | 只写开发态任务，不自动发布；默认不覆盖已有注释，用户明确要求覆盖时才覆盖 |
| 操作保护 | 所有写操作都需要确认；涉及重名对象时会先返回候选，不直接执行 |
2. 操作步骤
2.1 安装插件
1）填写 表单，获取 FineDataLink MCP 优先体验资格。
2）参考 插件管理 文档，安装插件。
2.2 MCP 配置
1）点击「MCP配置」Tab，再点击「立即生成」按钮，生成用于连接 AI 客户端的访问凭证，可定时任务能力开放给 AI 客户端。如下图所示：
| 设置项 | 说明 | ||||||
|---|---|---|---|---|---|---|---|
| 有效期 | 1）用于控制 Token 可使用时间；根据实际情况设置
2）到期后，AI 客户端继续使用旧配置会鉴权失败，用户需重新生成并复制配置 3）若想修改有效期，点击「重置」按钮即可，不重新生成 Token，旧 Token 依然生效
| ||||||
| MCP接口权限 | 1）权限分为读取能力和写入能力；具体权限说明可到产品界面内查看
2）若想修改权限，需要点击「重新生成」按钮，生成新的 Token，旧 Token 会失效
| ||||||
| Token说明 | 1）如果 AI 工具是 Codex/Claude Code，产品界面提供了完整配置（下图中第二个复制按钮），可将其复制到Codex/Claude Code 的配置文件中 2）如果是其他 AI 工具，复制 MCP 服务的身份认证信息（点击下图中第一个复制按钮），将其填写到 AI 工具 MCP 配置中的 Authorization 请求头中
| ||||||
| 其他说明 | 1）Token 归属于当前 FDL 登录用户 2）每个用户仅有一个当前有效 Token 3）Token 权限由读取能力、写入能力决定，同时受用户自身 FDL 权限约束 |
2）MCP Token 生成后，界面如下图所示：
2.3 示例：Codex 中使用
注：本节以 Codex 为例，讲解使用步骤。
1）复制 Token。如下图所示：
2）将 Token 粘贴到 Codex 配置文件 config.toml 中；手动粘贴或者让 Codex 自行配置。如下图所示：
3）读取示例：使用 Codex 查询某个定时任务的调度配置信息。如下图所示：
4）写入示例：使用 Codex 复制定时任务。
FDL 工程中可查看到名称为「测试1」的定时任务。
上一篇：回收站
