# 網店平台 MCP 工具

## 頁面定位

此頁是 Oneflash MCP 的 `ecommerce-store` 工具 detail 文件，供 AI agent、開發者及系統整合人員理解網店營運相關 endpoint 的使用範圍與治理方式。此頁不是網店平台銷售頁，而是 MCP endpoint reference page。

## Canonical URL

https://oneflash.hk/docs/mcp/tools/ecommerce-store

## Module summary

- Category: 應用程式
- Status: 設計草案
- Slug: `ecommerce-store`
- Summary: 網店平台 MCP 工具支援店舖設定、商品與分類、圖片上載、價格與促銷、庫存、客戶、棄單、訂單、付款退款、配送退貨、分析及受治理的批量匯入流程。

## Agent workflow fit

當使用者的任務涉及網店設定、商品目錄、分類、圖片、價格、promotion、庫存、客戶、棄單、訂單、付款、退款、配送、退貨或銷售分析時，可用此 module 作為 workflow 入口。典型流程應先讀取店舖、商品、庫存或訂單現況，再根據 endpoint 的 approval 與 safety 規則處理建立、更新、退款、履行或批量匯入。

## Endpoint interpretation rules

- 詳細 endpoint 清單以此 detail page 的 endpoint section 為 source of truth。
- 對商品、價格、庫存、訂單、付款、退款、配送、退貨或 bulk import 作任何 write 前，必須先讀取現有狀態。
- 涉及付款、退款、庫存扣減、訂單履行、批量匯入及顧客資料的 endpoint 應視為高影響操作，跟從頁面列明的 approval 要求。
- 分析及查詢型 endpoint 可用於理解現況，但不可推斷沒有列出的 write 能力。
- 不要創作此頁沒有列出的 endpoint 名稱、參數或權限。

## Related docs

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