MCP Connector Reference for AI Agent Workflows

This documentation outlines the Oneflash MCP runtime, governance rules, module capabilities, and representative tools available to private-tenant AI agents.

MCP Runtime Design

Oneflash MCP is not a public server marketplace. It is a governed connection layer inside the Oneflash business platform. AI agents can read business data, prepare content changes, upload files, and submit governed write requests within the permissions of a private tenant.

1160

MCP tools currently documented

24

Modules with MCP support

Allow / Review / Reject

Governed execution modes

Authentication and Approval Flow

AI agents should call Oneflash MCP through the fixed MCP endpoint with API key authentication. Write actions are controlled by approval and governance rules.

Endpoint
POST /api/mcp
Authentication
x-api-key
Tenant Resolution
Tenant context is derived from the API key. Callers should not submit tenant or workspace identity themselves.
Execution Mode
Private-tenant MCP with governed write actions.

Approval Flow

Read the data and structure before writing. If pending_approval is returned, poll the action request status instead of resubmitting the same write.

read -> write -> pending_approval -> core.get_action_request_status

Basic Rules

Use the MCP endpoint, not tenant headers

Agents should call the JSON-RPC MCP endpoint. Tenant context is derived from the API key; callers must not self-report tenant or workspace headers.

POST /api/mcp with x-api-key

Read before write

Before calling a write tool, agents should read the relevant structure, item keys, language keys, and base version token from the matching read tool.

read content -> prepare write -> handle approval or status polling

Do not retry pending writes

If a write tool returns pending_approval, agents should poll the action request instead of submitting the same write again.

core.get_action_request_status

Upload is a two-step flow

Agents should create an upload session, upload the file, then read the upload session result. The result is the source of truth for media_id, URL, and file format.

create_upload_session -> HTTP upload -> media.get_upload_session_result

MCP Module Directory

24 MCP modules

網頁設計及管理

/docs/mcp/tools/website-design

Website Design MCP tools follow the real WebsiteManager manifest, supporting site discovery, page and global content, collections, media uploads, SEO meta, Google Schema, AI-readable documents, analytics, sync validation, deployment, and approval status tracking.

View Module Documentation

網店平台

/docs/mcp/tools/ecommerce-store

E-commerce Store MCP tools support store settings, products and categories, media uploads, pricing and promotions, inventory, customers, abandoned carts, orders, payments and refunds, fulfilment and returns, analytics, and governed bulk imports.

View Module Documentation

客戶自助服務平台

/docs/mcp/tools/customer-portal

Customer Portal MCP tools support customer accounts, portal users, roles and permissions, 2FA, service records, project status, orders and bookings, document versions, invoices and payments, service requests, FAQs, forms, notifications, data sync, consent records, access logs, and audit trails.

View Module Documentation

線上課程管理

/docs/mcp/tools/online-course-platform

Online Course Platform MCP tools support branded course portals, courses, modules, lessons, materials, video protection, live sessions and replays, students, enrolments, payments, subscription expiry, access activation, learning progress, quizzes and assignments, submissions and grading, discussions, certificates, notifications, analytics, and audit logs.

View Module Documentation

B2B 下單系統

/docs/mcp/tools/b2b-ordering-system

B2B Ordering MCP tools support wholesale customers, customer groups, customer-specific price lists, MOQ, credit limits and payment terms, quotations and official PDFs, bulk orders, stock reservations, backorder allocation, delivery, e-invoices, packing slips, payment records, monthly statements, and operations analytics.

View Module Documentation

AI SEO 內容生成器

/docs/mcp/tools/ai-seo-content-generator

AI SEO Content Generator MCP tools support content campaigns, brand voice, keyword and SERP research, content gaps, claim rules, writing briefs, article drafts, SEO metadata, AEO structure, internal links, AI images, multilingual translation, batch generation, publishing schedules, performance tracking, and AI answer citation checks.

View Module Documentation

電郵推廣

/docs/mcp/tools/email-marketing-software

Email Marketing System MCP tools support sending configuration, SPF/DKIM/DMARC, customer lists, segmentation, consent and unsubscribe handling, bounce cleanup, templates, AI copy, campaign drafts, A/B testing, dynamic product recommendations, automation workflows, scheduled sending, deliverability, clicks, revenue attribution, and performance analysis.

View Module Documentation

SMS 營銷

/docs/mcp/tools/sms-marketing-tool

SMS Marketing System MCP tools support Sender ID, SMS gateways, send quota, frequency caps, customer segmentation, phone and consent records, opt-out lists, SMS templates, 70-character content previews, short links, cost previews, campaign drafts, scheduled sending, behavior triggers, OTP, delivery status, resends, click tracking, and conversion tracking.

View Module Documentation

Google 購物廣告

/docs/mcp/tools/google-shopping-integration

Google Shopping Search Optimisation MCP tools support Merchant Center status, products and variants, feed quality, title and image fixes, price and stock sync, local inventory, promotions and ratings, exclusion rules, sync submission, diagnostics reprocessing, performance collection, and approval-gated writes.

View Module Documentation

社交媒體自動發佈

/docs/mcp/tools/social-media-scheduler

Social Media Auto Publishing MCP tools support social accounts and permissions, brand rules, campaign briefs, products and media, AI copy, layout previews, hashtags, product tags, team approvals, batch scheduling, Reels, auto-replies, unified inbox, performance, and conversion tracking.

View Module Documentation

POS 系統

/docs/mcp/tools/cloud-pos-system

POS System MCP tools support stores, registers and hardware, staff permissions, product pricing, promotions, member points, inventory sync, O2O pickup, sales payments, refunds and exchanges, shifts, cash movement, offline sync, daily Z-Reports, analytics, and operation audit logs.

View Module Documentation

CRM 客戶關係管理

/docs/mcp/tools/crm-software

CRM MCP tools support tenant-scoped lead intake, deduplication, qualification, contacts, companies, deal pipelines, activities, tasks, consent records, and import governance.

View Module Documentation

預約平台

/docs/mcp/tools/online-booking-system

Online Booking System MCP tools support services, locations, staff and resources, available slots, deposits and payments, rescheduling and cancellations, reminders, package session deduction, waitlists, attendance and no-shows, capacity utilisation, revenue analytics, and approval-gated slot release workflows.

View Module Documentation

項目管理

/docs/mcp/tools/project-management-tool

Project Management MCP tools support signed quote handoff, client briefs, SOP templates, project tasks, owners and deadlines, dependencies, milestones, file versions, comments and decisions, risks, time and cost tracking, client portal approvals, progress alerts, milestone invoicing, close-out reports, and audit logs.

View Module Documentation

電子發票系統

/docs/mcp/tools/invoicing-software

Invoicing System MCP tools support quotes, orders, service records, invoice drafts, approvals, sending, payments, refunds, credit notes, payment reminders, recurring invoices, tax, accounting exports, and audit.

View Module Documentation

開支管理

/docs/mcp/tools/expense-management

Expense Management MCP tools support mobile receipts, OCR, claims, policy checks, budget alerts, approvals, reimbursement batches, project costing, accounting exports, and audit.

View Module Documentation

WhatsApp Business API

/docs/mcp/tools/whatsapp-business-api

WhatsApp Business API MCP tools support official numbers, business profiles, contacts, segments, consent records, team inbox, 24-hour sessions, template approval, broadcasts, interactive buttons, auto-replies, webhooks, delivery reports, and audit.

View Module Documentation

招聘管理

/docs/mcp/tools/applicant-tracking-system

Applicant Tracking System MCP tools support job requisitions, website job publishing, multi-channel CV intake, screening questions, candidate profiles, talent-pool tagging, interview self-booking, WhatsApp reminders, team scoring, offer/e-signature workflows, onboarding handoff, source analytics, privacy retention, and audit logs.

View Module Documentation

員工請假管理

/docs/mcp/tools/leave-management-system

Leave Management System MCP tools support employees and departments, leave types, annual-leave accrual, start-date pro-rating, carry-forward, public holidays, mobile requests, sick-leave proof, balances, team rosters, conflict checks, manager approvals, TOIL, monthly payroll exports, notifications, and audit logs.

View Module Documentation

進銷存管理系統

/docs/mcp/tools/inventory-management-system

Inventory Management System MCP tools support products/SKUs, barcodes, warehouses and locations, Excel/CSV opening imports, real-time stock, stock movement ledgers, batch and expiry tracking, safety stock, low-stock alerts, sales velocity, replenishment suggestions, suppliers, purchase orders, receiving, warehouse transfers, mobile/offline stocktakes, returns and damaged goods, valuation, and audit logs.

View Module Documentation

食品批發系統

/docs/mcp/tools/food-wholesale-system

Food Wholesale System MCP tools support wholesale customers, customer-specific price lists, food products, batch and expiry tracking, cold-chain rules, sellable stock, cut-off windows, order validation, FEFO lot allocation, backorders, pick lists, delivery routes, delivery execution, invoice batches, collections, returns and claims, recall traceability, margin and wastage reporting, and audit logs.

View Module Documentation

教育中心管理系統

/docs/mcp/tools/education-centre-system

Education Centre System MCP tools follow the real EducationCenter manifest, supporting students, courses, classes, enrolments, attendance, make-up lessons, invoices, payment proofs, payment records, learning resources, notices, student events, and leave review workflows.

View Module Documentation

共享辦公室管理系統

/docs/mcp/tools/coworking-space-system

Coworking Space System MCP tools support multi-location space setup, members and company accounts, plans and contracts, desks and meeting rooms, live availability, space bookings, visitor passes, access permissions, access events, repair/service tickets, SLA assignment, monthly invoicing, deposits, usage charges, payments, overdue follow-up, member notices, occupancy, revenue, renewal risk, and audit logs.

View Module Documentation

女傭中介管理系統

/docs/mcp/tools/domestic-helper-system

Domestic Helper Agency System MCP tools support employer requirements, consultant follow-up, helper profiles, skills and availability, documents and expiry dates, medical and training status, match recommendations, interview scheduling, placement stages, contract documents, visa and immigration workflows, insurance, payments and pass-through charges, refunds, arrival handover, post-placement follow-up, replacement cases, and audit logs.

View Module Documentation