Final POS – Custom POS Builder
ทางการสร้างระบบ POS ที่กำหนดเองด้วย AI ออกแบบขั้นตอนการชำระเงิน ตู้คิดเงินด้วยตนเอง และแอปเครื่องชำระเงิน พรีวิวแบบเรียลไทม์ และนำไปใช้งานกับฮาร์ดแวร์จริงพร้อมการชำระด้วยบัตร รองรับการจัดการร้านค้า: สินค้า สต็อก คำสั่งซื้อ ลูกค้า และรายงานยอดขาย ใช้งานระยะไกล ผ่าน OAuth
คุณทำอะไรได้บ้างด้วย Final POS – Custom POS Builder MCP?
- Build custom POS apps from a description — Ask your assistant to create a checkout flow, like a coffee-shop kiosk, and get a live preview link.
- Validate and deploy POS flows — Request validation of your app's flow files, then ship the latest version to your payment terminals and kiosks.
- Monitor and manage inventory — Check stock levels, find low-stock items, and draft purchase orders for your usual suppliers.
- Analyze sales performance — Compare sales by category across weeks or identify your top customers and their purchases.
- Manage catalog and customers — Add products from a spreadsheet with photos, or set up bookable services with assigned staff.
เซิร์ฟเวอร์ MCP แบบโฮสต์
npx add-mcp 'https://ai.finalpos.com/mcp'ติดตั้งลง Claude Code, Codex, Cursor และอื่นๆ
เอกสาร
เซิร์ฟเวอร์ MCP อย่างเป็นทางการ: สร้างแอป POS แบบกำหนดเองด้วย AI
เชื่อมต่อ Claude, ChatGPT, Gemini, Cursor, Codex หรือไคลเอนต์ MCP ใดๆ เข้ากับ Final:
สร้างแอป POS แบบกำหนดเองด้วย Flow (ขั้นตอนการชำระเงิน, ตู้คิดเงินแบบบริการตนเอง, เครื่องชำระเงิน)
และจัดการร้านค้าที่อยู่เบื้องหลังแอปเหล่านั้นจาก Hub ผ่านเซิร์ฟเวอร์เดียว
https://ai.finalpos.com/mcp
เชื่อมต่อ · สิ่งที่ทำได้ · เอกสารอ้างอิงเครื่องมือ · คำถามที่พบบ่อย · finalpos.com
เซิร์ฟเวอร์ Final MCP เป็นเซิร์ฟเวอร์ Model Context Protocol อย่างเป็นทางการสำหรับ
Final แพลตฟอร์มการค้าสำหรับจุดขายแบบกำหนดเอง
ปลายทางระยะไกลหนึ่งแห่ง https://ai.finalpos.com/mcp ให้เอเจนต์ AI เข้าถึง
ผลิตภัณฑ์ Final ทุกตัวที่ผู้ค้าอนุญาต:
- Flow ตัวสร้างแอป POS แบบกำหนดเอง: อธิบายขั้นตอนการชำระเงิน แล้วเอเจนต์จะสร้าง จากบลูพริ้นท์หน้าจอที่ผ่านการตรวจสอบ โดยอ้างอิงจาก POS API ที่ล็อกเวอร์ชันของ Final จากนั้นตรวจสอบความถูกต้อง ส่งลิงก์พรีวิวสด และปรับใช้กับเครื่องชำระเงิน แท็บเล็ต และตู้คิดเงิน POS หน้าร้าน, บริการตนเอง, การสั่งอาหารร้านอาหาร, จอแสดงผลในครัว และแอปชำระเงินแบบพบหน้า
- Hub แบ็กออฟฟิศที่อยู่เบื้องหลังแอปเหล่านั้น: สินค้าและแคตตาล็อก, สต็อกและ ใบสั่งซื้อ, คำสั่งซื้อ, ลูกค้า, รายงานยอดขาย, ทีมและบทบาท, สาขา, ภาษี, การจอง
คุณลงชื่อเข้าด้วยบัญชี Final ของคุณ (OAuth 2.1) และเลือกบริษัทและสิ่งที่ เอเจนต์อาจทำได้ ไม่ต้องติดตั้งหรือรันอะไรในเครื่อง
| ปลายทาง | https://ai.finalpos.com/mcp |
| การส่งข้อมูล | Streamable HTTP |
| การรับรองความถูกต้อง | OAuth 2.1 พร้อม PKCE (ลงชื่อเข้าด้วย 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
รัน /mcp ใน Claude Code และเลือก รับรองความถูกต้อง หรือติดตั้งปลั๊กอิน
ซึ่งเพิ่มเซิร์ฟเวอร์พร้อมกับทักษะ 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 ลงชื่อเข้าครั้งเดียวด้วย
/mcp auth final ภายใน Gemini CLI หากต้องการเพิ่มเฉพาะเซิร์ฟเวอร์:
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)
ติดตั้งใน VS Code หรือ:
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)
- "สร้างตู้คิดเงินร้านกาแฟที่มีกริดสินค้า ตัวปรับแต่ง ตะกร้าสินค้า และการชำระด้วยบัตร แล้วให้ลิงก์พรีวิวฉัน"
- "เพิ่มหน้าจอทิปให้แอปเคาน์เตอร์ของฉันและตรวจสอบความถูกต้อง"
- "สร้างโฟลว์บริการตนเองสำหรับร้านขายของชำขนาดเล็กที่มีการสแกนบาร์โค้ดและหน้าจอใบเสร็จ"
- "ส่งเวอร์ชันล่าสุดของโฟลว์บริการตนเองของฉัน"
การสร้างแอปมักจะรัน 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 คืออะไร?
มันคือเซิร์ฟเวอร์ MCP อย่างเป็นทางการสำหรับ Final POS URL ระยะไกลหนึ่งแห่ง
https://ai.finalpos.com/mcp ให้ผู้ช่วย AI อ่านและจัดการ
แบ็กออฟฟิศ Final ของผู้ค้า (Hub) และสร้างแอปจุดขาย (Flow)
ChatGPT หรือ Claude จัดการสินค้าคงคลัง Final POS ของฉันได้ไหม?
ได้ อนุญาตแพ็ก inventory เมื่อคุณเชื่อมต่อ เอเจนต์สามารถตรวจสอบระดับ
สต็อก ค้นหาสต็อกต่ำ แนะนำการสั่งซื้อซ้ำ สร้างใบสั่งซื้อ และบันทึก
สินค้าที่ได้รับ
เอเจนต์ AI สร้างแอป POS บน Final ได้ไหม?
ได้ ด้วยแพ็ก build เอเจนต์สร้างโฟลว์ เขียนแอปกับ
API ที่ล็อกเวอร์ชันของ Final และบลูพริ้นท์หน้าจอที่ผ่านการตรวจสอบ ตรวจสอบความถูกต้อง และ
ส่งคืน URL พรีวิวสด คุณเปิดใช้งานจากตัวสร้าง Final
ฉันต้องมีคีย์ API หรือไม่?
ไม่ หากไคลเอนต์ของคุณรองรับ OAuth (Claude, ChatGPT, Claude Code, Cursor,
Gemini CLI, VS Code): เพียงลงชื่อเข้าด้วย Final Codex และสคริปต์ใช้คีย์ fai_
จาก ai.finalpos.com/connections
มันดำเนินการกับบริษัทใด?
บริษัทที่คุณเลือกเมื่อเชื่อมต่อ หากบัญชีของคุณมีหลายบริษัท เอเจนต์สามารถ
เรียก switch_company
เอเจนต์รับชำระเงินหรือออกคืนเงินได้ไหม?
ไม่ได้ การชำระเงิน การคืนเงิน และการยกเลิกเกิดขึ้นที่เครื่องคิดเงิน คำสั่งซื้อเป็นแบบอ่านอย่างเดียวผ่าน MCP
ทำไมเอเจนต์ของฉันเห็นเพียงไม่กี่เครื่องมือ?
ไคลเอนต์ใส่ทุกเครื่องมือที่แสดงในบริบทของโมเดล และคุณภาพลดลงเมื่อ
รายการยาว เอเจนต์ค้นหาส่วนที่เหลือด้วย find_tools เรียกด้วย
call_tool หรือแสดงรายการทั้งแพ็กด้วย enable_packs
มีค่าใช้จ่ายหรือไม่?
การเชื่อมต่อฟรี สิ่งที่เอเจนต์ทำถูกเรียกเก็บเหมือนงานเดียวกันที่ทำใน Final ด้วยตัวเอง ภายใต้แผน Final ของคุณ
เอกสาร POS API ของ Final อยู่ที่ไหน?
ที่ finalpos.com/docs เอเจนต์ที่สร้างแอป
ไม่จำเป็นต้องใช้แยกต่างหาก: แพ็ก build อ้างอิงทุกการเรียกกับ
API ที่ล็อกเวอร์ชันของ Final (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