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

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

概覽

Oneflash MCP 并非公开下载的 server marketplace，而是 Oneflash 商业系统内的受治理 connector layer。AI agents 可在租户权限范围内读取业务资料、准备变更、上载档案，并透过 MCP tools 提交受权限及审批机制管理的写入请求。

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/		已可用66Website pages, collections, metadata, Google schema, upload sessions, global content, and deploy-oriented content workflows.

ContentGrowth

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

EducationCenter

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

ProductCatalog

/docs/mcp/tools/		已可用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