MCP 服務 / MCP 程式設計
於 7.6.0 版本新增
「MCP 程式設計」是 DataFlux Func 的一個用於支援 AI Agent 在 Func 中編寫、管理指令碼的功能。
使用者可以透過 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 |
| 示例:OpenCode 配置 | |
|---|---|
1 2 3 4 5 6 7 8 9 10 11 12 | |
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 編寫的程式碼