AI Agent 工作流程的 MCP Connector 參考文件

本文件概述 Oneflash MCP runtime、治理規則、模組能力，以及可供私有租戶 AI agent 工作流程使用的代表性工具。

概覽

Oneflash MCP 並非公開下載的 server marketplace，而是 Oneflash 商業系統內的受治理 connector layer。AI agents 可在租戶權限範圍內讀取業務資料、準備變更、上載檔案，並透過 MCP tools 提交受權限及審批機制管理的寫入請求。

237

目前 repo 內 MCP 工具

8

已支援 MCP 的模組

allow / check / disallow

受治理執行模式

Runtime 合約

Oneflash MCP tools 透過私有租戶 runtime 執行。本頁說明使用規則；tool-level 清單則由 CMS collection 獨立維護。

查看公開工具清單

Runtime 合約

端點
POST /api/mcp
認證
x-api-key
模式
私有租戶 MCP，寫入受治理機制管理

AI Agents 基本規則

以下規則比工具清單更重要。Agents 在提出讀取、寫入、上載或審批請求前，應先遵守相關規則。

使用 MCP endpoint，不要自行傳 tenant headers

Agents 應該呼叫 JSON-RPC MCP endpoint。租戶 context 由 API key 推導，caller 不應自行聲稱 tenant 或 workspace headers。

POST /api/mcp with x-api-key

寫入前先讀取

呼叫 write tool 之前，agents 應先用對應 read tool 讀取 schema、item keys、language keys 及 base version token。

list/get -> prepare write -> approval/status

不要重試等待審批的寫入

如果 write tool 回傳 pending_approval，agent 應查詢 action request 狀態，而不是再次提交相同寫入。

core.get_action_request_status

Upload 是兩步流程

Agents 應先建立 upload session、上載檔案，再呼叫 media.get_upload_session_result。該結果才是 media_id、URL 及檔案格式的最終依據。

create_upload_session -> HTTP upload -> media.get_upload_session_result

已支援 MCP 的模組

公開索引應先呈現模組能力，再連結至各模組的工具參考。

模組狀態工具讀取寫入能力說明

WebsiteManager

/docs/mcp/tools/website-manager		已可用66Website pages, collections, metadata, Google schema, upload sessions, global content, and deploy-oriented content workflows.

ContentGrowth

/docs/mcp/tools/content-growth		已可用58Campaigns, claim rules, personal insights, content records, online listings, tracking configs, and append-only tracking results.

EducationCenter

/docs/mcp/tools/education-center		已可用42Students, courses, classes, enrollments, attendance, invoices, payment proofs, learning resources, notices, and leave requests.

ProductCatalog

/docs/mcp/tools/product-catalog		已可用17Product items, categories, product types, price and stock updates, media attachment, and archive flows.

Connector 可用狀態

此表區分已實作 MCP tools、應用程式 connector 規劃及 industry connector 規劃。規劃中項目描述的是 connector 類別方向，並非可呼叫的 production endpoints。

Website Builder and CMS

應用 / WebsiteManager

已可用
MCP 工具
66 個 WebsiteManager tools
AI 可讀描述
已提供受治理 MCP tools，支援網站內容、collections、metadata、schema、upload 及 deploy 工作流程。
備註
以真實 WebsiteManager tool reference 為準。

AI SEO / Content Operations

應用 / ContentGrowth

已可用
MCP 工具
58 個 ContentGrowth tools
AI 可讀描述
可用於 campaign memory、claim rules、content records、online listings 及 AEO tracking 工作流程。
備註
以真實 ContentGrowth tool reference 為準。

Education Center Operations

行業 / EducationCenter

已可用
MCP 工具
42 個 EducationCenter tools
AI 可讀描述
可用於學生、課程、出席、發票、付款證明審核、資源、公告及請假流程。
備註
以真實 EducationCenter tool reference 為準。

Product Catalog

應用 / ProductCatalog

已可用
MCP 工具
17 個 ProductCatalog tools
AI 可讀描述
可用於產品 items、分類、產品類型、價格與庫存更新、媒體附件及封存流程。
備註
以真實 ProductCatalog tool reference 為準。

CRM 客戶關係管理

應用 / 銷售工作流程

規劃中
MCP 工具
0 個已公開 MCP tools
AI 可讀描述
規劃中的 connector family，涵蓋 leads、customers、follow-up tasks、pipeline updates 及 sales approval workflows。
備註
未實作前，不應描述成可呼叫 MCP endpoints。

WhatsApp Business API

應用 / 溝通工作流程

規劃中
MCP 工具
0 個已公開 MCP tools
AI 可讀描述
規劃中的 connector family，涵蓋訊息準備、對話 context、提醒及需人工確認的客戶溝通。
備註
面向客戶的發送動作應保持 approval-controlled。

Online Booking

應用 / 預約排程工作流程

規劃中
MCP 工具
0 個已公開 MCP tools
AI 可讀描述
規劃中的 connector family，涵蓋 availability checks、booking preparation、schedule changes 及 approval-safe reminders。
備註
實作前不應發布虛構 booking tool names。

Inventory Management

應用 / 營運工作流程

規劃中
MCP 工具
0 個已公開 MCP tools
AI 可讀描述
規劃中的 connector family，涵蓋 stock lookup、reorder preparation、low-stock alerts 及受治理庫存更新。
備註
如 stock fields 最先透過 ProductCatalog 實作，之後可連到 ProductCatalog。

零售及批發方案

行業

設計草案
MCP 工具
0 個已公開 MCP tools
AI 可讀描述
設計中的 workflow area，用於訂單、catalog、定價、客戶及庫存 connector planning。
備註
只可描述為 industry workflow planning，不可描述為已可用 MCP tools。

餐飲管理方案

行業

設計草案
MCP 工具
0 個已公開 MCP tools
AI 可讀描述
設計中的 workflow area，用於餐牌、預約、訂單、庫存、發票及提醒 connector planning。
備註
只可描述為 industry workflow planning，不可描述為已可用 MCP tools。

工作流程範例

網站內容更新

AI agents 透過 WebsiteManager MCP tools 編輯網站內容時，可使用以下安全流程。

  1. 1呼叫 website.list_websites，選定 website_id。
  2. 2呼叫 website.list_pages 及 website.get_page_content，讀取準確頁面。
  3. 3使用 read response 內的 section_key、field_key、language 及 base_version_token。
  4. 4呼叫對應 write tool；如結果是 pending_approval，就查詢 action request 狀態。

媒體上載

在把圖片或檔案 reference 寫入內容欄位前，應先完成安全的 upload flow。

  1. 1先讀取目標 page、collection item 或 product item。
  2. 2為目標欄位建立正確的 upload session。
  3. 3將檔案上載到回傳的 upload_url。
  4. 4呼叫 media.get_upload_session_result，並以回傳的 media_id 或 URL 作最終依據。

AI 可讀檔案

視覺文件頁應與 Markdown 及 manifest routes 配合，讓 AI agents 不依賴版面亦可讀取同一組資訊。

/llms.txt
/llms-full.txt
/docs/mcp/index.md
/docs/mcp/manifest.json
/docs/mcp/tools/website-manager.md
/docs/mcp/tools/content-growth.md