Final POS – Custom POS Builder
官方使用AI建立自訂POS系統。設計結帳流程、自助結帳機與支付終端應用程式,即時預覽並部署至真實硬體,支援刷卡付款。同時管理商店營運:商品、庫存、訂單、客戶與銷售報表。支援遠端存取與OAuth。
你可以用 Final POS – Custom POS Builder MCP 做什麼?
- 從描述建立自訂 POS 應用程式 — 請您的助理建立結帳流程,例如咖啡店自助點餐機,並取得即時預覽連結。
- 驗證並部署 POS 流程 — 要求驗證您應用程式的流程檔案,然後將最新版本推送至您的支付終端機與自助點餐機。
- 監控並管理庫存 — 檢查庫存水準、找出低庫存商品,並為您常用的供應商草擬採購訂單。
- 分析銷售表現 — 跨週比較各類別的銷售情況,或識別您的頂級客戶及其購買紀錄。
- 管理目錄與客戶 — 從包含照片的試算表新增產品,或設定指派員工的可預約服務。
託管 MCP 伺服器
npx add-mcp 'https://ai.finalpos.com/mcp'可安裝到 Claude Code、Codex、Cursor 等客戶端
文件
Final MCP 伺服器:使用 AI 建置自訂 POS 應用程式
將 Claude、ChatGPT、Gemini、Cursor、Codex 或任何 MCP 用戶端連線到 Final:
使用 Flow(結帳流程、自助結帳 kiosk、付款終端機)
建置自訂 POS 應用程式,並透過單一伺服器從 Hub 管理背後的商店。
https://ai.finalpos.com/mcp
連線 · 功能說明 · 工具參考 · 常見問題 · finalpos.com
Final MCP 伺服器是 Final 的官方 Model Context Protocol 伺服器,Final 是自訂銷售點系統的商務平台。
單一遠端端點 https://ai.finalpos.com/mcp 讓 AI 代理程式存取商家允許的每個 Final 產品:
- Flow,自訂 POS 應用程式建置器:描述一個結帳流程,代理程式會根據經過審核的畫面藍圖來建置,並以 Final 版本鎖定的 POS API 為基礎,然後驗證、回傳即時預覽連結,並部署到付款終端機、平板電腦和 kiosk。涵蓋櫃檯 POS、自助結帳、餐廳點餐、廚房顯示器和面對面付款應用程式。
- Hub,這些應用程式背後的後台:產品和目錄、庫存和採購訂單、訂單、客戶、銷售報表、團隊和角色、門市、稅務、預約。
您使用 Final 帳戶(OAuth 2.1)登入,然後選擇公司和代理程式可以執行的操作。無需在本機安裝或執行任何東西。
| 端點 | https://ai.finalpos.com/mcp |
| 傳輸方式 | Streamable HTTP |
| 驗證 | 使用 PKCE 的 OAuth 2.1(使用 Final 登入),或使用 fai_ 連線金鑰作為 Authorization: Bearer |
| 註冊表名稱 | com.finalpos/final |
| 身分 | 連線者本人,作用於單一公司,限於其允許的套件範圍內 |
| 費用 | 連線免費;代理程式的操作遵循您的 Final 方案,如同您在 Final 中自行操作 |
連線
大多數用戶端只需要 URL。它們會開啟 Final 登入頁面,您在其中選擇公司和套件,然後即可完成連線。
Claude(claude.ai、Claude Desktop)
設定 → 連接器 → 新增自訂連接器,URL 為 https://ai.finalpos.com/mcp。
ChatGPT
設定 → 應用程式與連接器 → 進階設定 → 開發者模式,然後使用 URL https://ai.finalpos.com/mcp 建立。
Claude Code
claude mcp add --transport http final https://ai.finalpos.com/mcp
在 Claude Code 中執行 /mcp 並選擇 Authenticate。或安裝外掛程式,它會將伺服器與 Final playbook 技能一起加入。在 Claude Code 內部:
/plugin marketplace add Final-Commerce/final-pos-mcp
/plugin install final@final
Gemini CLI
gemini extensions install https://github.com/Final-Commerce/final-pos-mcp
此擴充功能會加入伺服器、Final playbook 和指令:
/final-pos:stock、/final-pos:sales、/final-pos:new、/final-pos:preview、
/final-pos:validate 和 /final-pos:deploy。在 Gemini CLI 中使用
/mcp auth final 登入一次。若要只加入伺服器:
gemini mcp add --transport http final https://ai.finalpos.com/mcp
Cursor
或在 ~/.cursor/mcp.json 中:
{
"mcpServers": {
"final": { "url": "https://ai.finalpos.com/mcp" }
}
}
VS Code(GitHub Copilot)
code --add-mcp '{"name":"final","type":"http","url":"https://ai.finalpos.com/mcp"}'
Codex、指令碼和不支援 OAuth 的用戶端
在 ai.finalpos.com/connections 建立連線金鑰。
它只會顯示一次,頁面會為每個用戶端列印確切的程式碼片段。對於
Codex,請將此加入 ~/.codex/config.toml:
[mcp_servers.final]
url = "https://ai.finalpos.com/mcp"
http_headers = { "Authorization" = "Bearer fai_YOUR_KEY" }
任何其他用戶端:POST https://ai.finalpos.com/mcp 搭配
Authorization: Bearer fai_YOUR_KEY。
以
sk_(Flow)或fpm_(Hub)開頭的金鑰屬於那些產品 自己的伺服器,此處不接受。請改為建立fai_金鑰,或使用 OAuth。
檢查是否正常運作
詢問您的代理程式:*「使用 Final 告訴我您連線到哪個公司,以及您可以使用哪些套件。」*它會呼叫 get_connection 和 list_packs。
您的代理程式可以執行什麼
工具分組為套件。連線時,您選擇代理程式可以使用的套件,這些也是 OAuth 範圍。為了保持模型上下文精簡,連線一次只列出幾個套件。核心工具可以存取其餘部分:find_tools 搜尋所有允許的套件,call_tool 依名稱呼叫任何允許的工具。
| 套件 | 產品 | 涵蓋範圍 | 預設列出 |
|---|---|---|---|
catalog | Hub | 產品、變體、類別、選項、修飾項、產品照片和媒體庫 | ✓ |
inventory | Hub | 庫存水準和歷史記錄、轉移、供應商、採購訂單、補貨規則、庫存 CSV 匯入/匯出 | |
orders | Hub | 訂單、退款和電子商務訂單同步(唯讀:收銀機負責收款) | |
customers | Hub | 客戶記錄、備註、訂單歷史記錄和客戶匯入 | |
reports | Hub | 財務摘要、銷售和付款明細、員工銷售、工作階段、交易、記錄匯出 | |
team | Hub | 團隊成員、角色和權限 | |
store | Hub | 門市、工作站、稅務和 Hub 擴充功能 | |
bookings | Hub | 可預約服務:規則、資源、可用性、保留和確認 | |
build | Flow | 建置和部署 Final POS 應用程式:API 基礎、藍圖、流程檔案、預覽沙盒、驗證、部署 | ✓ |
build_data | Flow | 自訂資料表(應用程式資料庫)、密鑰保管庫和 Flow 擴充功能 |
工具名稱帶有其產品:hub_get_products、hub_find_low_stock、
flow_create_flow、flow_deploy_flow。TOOLS.md 列出每個工具,包含其套件、是否變更資料,以及其引數。
核心工具(一律列出):get_connection、list_packs、find_tools、
call_tool、enable_packs、disable_packs、switch_company。
可以詢問的事項
建置自訂 POS 應用程式(Flow)
- 「建置一個咖啡店 kiosk,包含產品網格、修飾項、購物車和卡片付款,然後給我一個預覽連結。」
- 「在我的櫃檯應用程式中加入小費畫面並驗證它。」
- 「為小型雜貨店建立一個自助結帳流程,包含條碼掃描和收據畫面。」
- 「發布我的自助結帳流程的最新版本。」
應用程式建置通常執行 flow_get_scaffold → flow_create_flow →
flow_lookup_command_frame(基礎)→ flow_get_blueprint →
flow_write_flow_files → flow_validate_flow → flow_start_preview,並
回傳即時預覽 URL。代理程式建置的所有內容也會出現在 Final 建置器中,每次檔案寫入都是一個可還原的檢查點。
經營商店(Hub)
- 「哪些產品在 Main Street 門市的補貨點以下?為常用供應商草擬一份採購訂單。」
- 「比較上週與前一週按類別劃分的銷售額。」
- 「從附加的試算表中加入這 40 個產品,包含照片。」
- 「我這個月的前十名客戶是誰,他們買了什麼?」
- 「將 45 分鐘的按摩設定為可預約服務,配備兩位治療師。」
安全與權限
-
您的角色仍然適用。 每個 Hub 呼叫都以連線者的身分執行,Hub 會在每次呼叫時檢查其即時角色。僅限擁有者的操作仍僅限擁有者。
-
套件就是權限。 代理程式只能呼叫您允許的套件中的工具。您可以隨時在 ai.finalpos.com/connections 變更套件或中斷連線, 中斷連線會立即撤銷所有權杖。
-
寫入操作有標記。 讀取工具帶有
readOnlyHint,部署和 刪除帶有destructiveHint,因此用戶端可以在執行前詢問。伺服器 會告訴代理程式在部署、刪除和大量變更前與您確認。 -
金錢留在收銀機。 收款、退款和作廢訂單 無法透過 MCP 使用。
-
密鑰絕不會經過模型。
flow_request_secret會要求您在 建置器中輸入 API 金鑰。 -
所有操作都有記錄。 Connections 頁面會即時顯示每個已連線的用戶端 及其進行的每次呼叫。
-
Flow 限制: Flow 每小時允許 30 次預覽啟動、12 次建置和部署,以及 300 次檔案寫入。
隱私與支援
- Final 保留的內容。 連線(誰建立的、公司和 套件)、用於存取 Hub 和 Flow 的權杖(加密),以及每次 工具呼叫的記錄:工具、結果、花費時間,以及 引數和結果的編輯後預覽。您可以在 Connections 頁面 看到該記錄。
- Final 看不到的內容。 您的對話。MCP 用戶端傳送工具呼叫, 而不是周圍的聊天內容。
- 中斷連線會刪除儲存的權杖,並撤銷發給該 連線的所有權杖。
- 隱私權政策 · 條款
- 支援: support@finalpos.com。若 此指南或外掛程式有問題,請開啟 issue。
Flow 的直接端點
在閘道之前建立的設定可能仍使用 https://flow.finalpos.com/api/mcp
搭配 Flow sk_ 金鑰(註冊表名稱 com.finalpos.build/final-flows)。它會繼續
運作,但新的設定應使用 https://ai.finalpos.com/mcp,其中包含
Flow。
常見問題
什麼是 Final MCP 伺服器?
它是 Final POS 的官方 MCP 伺服器。單一遠端 URL
https://ai.finalpos.com/mcp 讓 AI 助理讀取和管理
商家的 Final 後台(Hub)並建置銷售點應用程式(Flow)。
ChatGPT 或 Claude 可以管理我的 Final POS 庫存嗎?
可以。連線時允許 inventory 套件。代理程式可以檢查庫存
水準、找出低庫存、建議補貨、建立採購訂單和記錄
收貨。
AI 代理程式可以在 Final 上建置 POS 應用程式嗎?
可以。使用 build 套件,代理程式會建立流程、根據 Final
版本鎖定的 API 和經過審核的畫面藍圖撰寫應用程式、驗證它,並
回傳即時預覽 URL。您可以從 Final 建置器啟動它。
我需要 API 金鑰嗎?
不需要,如果您的用戶端支援 OAuth(Claude、ChatGPT、Claude Code、Cursor、
Gemini CLI、VS Code):只需使用 Final 登入。Codex 和指令碼使用來自 ai.finalpos.com/connections 的 fai_
金鑰。
它作用於哪個公司?
您連線時選擇的那個。如果您的帳戶有多個,代理程式可以
呼叫 switch_company。
代理程式可以收款或退款嗎?
不可以。付款、退款和作廢發生在收銀機上。訂單在 MCP 上是唯讀的。
為什麼我的代理程式只看到幾個工具?
用戶端會將每個列出的工具放入模型的上下文中,清單越長品質越差。代理程式使用 find_tools 找到其餘工具,使用
call_tool 呼叫它們,或使用 enable_packs 列出整個套件。
有費用嗎?
連線免費。代理程式的操作計費方式與您在 Final 中自行執行相同工作相同,遵循您的 Final 方案。
Final POS API 文件在哪裡?
在 finalpos.com/docs。建置應用程式的代理程式
不需要單獨的文件:build 套件會將每次呼叫建立在
Final 版本鎖定的 API 之上(flow_lookup_pos_api、
flow_lookup_command_frame)。
關於此儲存庫
此儲存庫包含公開設定指南、MCP Registry 條目
(server.json、legacy/)、Gemini CLI 擴充功能
(gemini-extension.json、GEMINI.md、commands/)、Claude Code 和
Cursor 外掛程式市集(.claude-plugin/、.cursor-plugin/ 和
plugins/final/,兩者共用)以及產生的
工具參考 及其機器可讀的孿生 catalog.json,
伺服器卡片在 https://ai.finalpos.com/.well-known/mcp/server-card.json
也會讀取。GEMINI.md 和 Claude 技能是相同的
playbook,CI 會檢查它們是否相符。伺服器本身由 Final 託管;
此儲存庫中的程式碼不會在您的機器上執行。
License
Apache-2.0 © Final Commerce