MCP 服务 / AI 编程

于 7.6.0 版本新增

MCP 服务是 DataFlux Func 的一个用于支持 AI Agent 工具调用的功能。

用户可以通过 MCP 服务的方式，允许 AI Agent 参与 DataFlux Func 中函数的编写

1. 接入步骤

可以按照如下步骤，将 MCP 客户端 / AI Agent 接入 DataFlux Func 的 MCP Coding 服务

1.1 创建 Access Token

访问 DataFlux Func 的 MCP Coding 服务需要创建 Access Token，并开启「MCP 编程」功能

并可以在规则中指定所需开放函数（如：按脚本集 ID）

1.2 权限规则

权限规则可以手工编辑，从上到下依次匹配，按照首个命中的规则确定权限。

示例如下：

规则（精确匹配 ID）	匹配对象	匹配 ID	权限
scriptSet:mytest:r	脚本集	mytest	读取
scriptSet:mytest:rw	脚本集	mytest	读取、修改
scriptSet:mytest:rwx	脚本集	mytest	读取、修改、执行
scriptSet:mytest:rwxp	脚本集	mytest	读取、修改、执行、发布
script:mytest__demo:r	脚本	mytest__demo	读取

规则（通配 ID）	匹配对象	通配 ID	权限
scriptSet:my*:r	脚本集	按 my* 通配	读取
script:mytest__de*:r	脚本	按 mytest__de* 通配	读取

1.3 配置 MCP 客户端

DataFlux Func 的 MCP 服务遵循 MCP 规范

在实际对接前，推荐使用 MCP Inspector 进行调试

在 MCP 客户端 / AI Agent 中添加如下配置：

配置项	值
URL 地址	{DataFlux Func 访问地址}/mcp/coding
请求头	X-Dff-Access-Token: atk-xxxxx:xxxxx

{
  "mcp": {
    "dataflux-func-mcp-coding": {
      "enabled": true,
      "type"   : "remote",
      "url"    : "{DataFlux Func 访问地址}/mcp/coding",
      "headers": {
        "X-Dff-Access-Token": "atk-xxxxx:xxxxx"
      }
    },
  }
}

1.4 初始化本地协作说明

最新版 MCP Coding 服务的 help 工具已经包含推荐的本地 AGENTS.md 协作说明，不需要用户手工创建。

接入后，建议让 AI Agent 先调用 MCP 服务 dataflux-func-testing 的 help 工具，并根据返回的建议进行初始化。

2. 实际操作示例

MCP Coding 中已经内置了大量面向 Func 开发的提示词和工具说明。输入提示词时，可以直接以「AI Agent 已经充分了解 Func 的最佳使用方式」为前提描述目标。

例如：

• 根据 MCP 服务 dataflux-func-testing 建议进行初始化
• 同步脚本集 demo 的所有代码

首先请先确认 AI Agent 是否成功连接到 DataFlux Func 的 MCP Coding 服务：

之后，正常输入提示词即可

AI Agent 完成后，在 DataFlux Func 中刷新即可看到 AI 编写的代码