# 客戶自助服務平台 MCP 工具

## 頁面定位

此頁是 Oneflash MCP 的 `customer-portal` 工具 detail 文件，供 AI agent、開發者及系統整合人員理解客戶 portal、權限、服務紀錄及文件互動相關 endpoint。此頁不是客戶平台銷售頁，而是 MCP reference page。

## Canonical URL

https://oneflash.hk/docs/mcp/tools/customer-portal

## Module summary

- Category: 應用程式
- Status: 設計草案
- Slug: `customer-portal`
- Summary: 客戶自助服務平台 MCP 工具支援客戶帳戶、portal 使用者、角色權限、2FA、服務紀錄、項目進度、訂單預約、文件版本、發票付款、服務請求、FAQ、表單、通知、資料同步、同意紀錄、access logs 及 audit。

## Agent workflow fit

當任務涉及客戶登入、portal 使用者、角色權限、服務紀錄、項目狀態、文件版本、訂單預約、發票付款、服務請求、FAQ、表單、通知、同意紀錄或 access log 時，可用此 module。典型 workflow 是先確認客戶、使用者與權限，再讀取相關服務、文件、付款或請求狀態，最後按 approval rules 作出通知、同步或資料更新。

## Endpoint interpretation rules

- 詳細 endpoint 清單以此 detail page 的 endpoint section 為 source of truth。
- 權限、2FA、同意紀錄、文件版本、付款及 access log 相關操作必須先讀現況與 audit context。
- 涉及帳戶、角色、權限、通知、付款或客戶文件的 write 操作，不應在未確認 approval 要求下執行。
- 如 endpoint 要求 read-first context，必須先完成對應讀取，避免覆蓋客戶資料或錯誤通知。
- 不要創作此頁沒有列出的 endpoint 名稱、參數或權限。

## Related docs

- MCP tools catalog: https://oneflash.hk/docs/mcp