Final POS – Custom POS Builder
chính thứcXây dựng POS tùy chỉnh với AI. Thiết kế luồng thanh toán, ki-ốt tự thanh toán và ứng dụng thiết bị thanh toán, xem trước trực tiếp và triển khai lên phần cứng thực với thanh toán thẻ. Cũng vận hành cửa hàng: sản phẩm, kho, đơn hàng, khách hàng và báo cáo bán hàng. Từ xa, OAuth.
Bạn có thể làm gì với Final POS – Custom POS Builder MCP?
- Từ mô tả, xây dựng ứng dụng POS tùy chỉnh — Yêu cầu trợ lý tạo luồng thanh toán, như ki-ốt quán cà phê, và nhận liên kết xem trước trực tiếp.
- Xác thực và triển khai luồng POS — Yêu cầu xác thực các tệp luồng của ứng dụng, sau đó phát hành phiên bản mới nhất tới thiết bị thanh toán và ki-ốt của bạn.
- Theo dõi và quản lý hàng tồn kho — Kiểm tra mức tồn kho, tìm mặt hàng sắp hết và soạn đơn đặt hàng cho nhà cung cấp thường dùng.
- Phân tích hiệu quả bán hàng — So sánh doanh số theo danh mục qua các tuần hoặc xác định khách hàng hàng đầu và giao dịch mua của họ.
- Quản lý danh mục và khách hàng — Thêm sản phẩm từ bảng tính kèm ảnh, hoặc thiết lập dịch vụ đặt lịch với nhân viên được phân công.
Máy chủ MCP được lưu trữ
npx add-mcp 'https://ai.finalpos.com/mcp'Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác
Tài liệu
Máy chủ MCP chính thức: xây dựng ứng dụng POS tùy chỉnh bằng AI
Kết nối Claude, ChatGPT, Gemini, Cursor, Codex hoặc bất kỳ máy khách MCP nào với Final:
xây dựng ứng dụng POS tùy chỉnh với Flow (luồng thanh toán, ki-ốt tự thanh toán, thiết bị đầu cuối thanh toán)
và vận hành cửa hàng phía sau chúng từ Hub, thông qua một máy chủ duy nhất.
https://ai.finalpos.com/mcp
Kết nối · Những gì nó có thể làm · Tham chiếu công cụ · Câu hỏi thường gặp · finalpos.com
Máy chủ MCP Final là máy chủ Giao thức Ngữ cảnh Mô hình chính thức cho
Final, nền tảng thương mại dành cho điểm bán hàng tùy chỉnh.
Một điểm cuối từ xa, https://ai.finalpos.com/mcp, cung cấp cho tác nhân AI quyền truy cập vào
mọi sản phẩm Final mà người bán cho phép:
- Flow, trình xây dựng ứng dụng POS tùy chỉnh: mô tả một quy trình thanh toán và tác nhân sẽ xây dựng nó từ các bản thiết kế màn hình đã được kiểm duyệt, dựa trên các API POS được khóa phiên bản của Final, sau đó xác thực nó, trả về liên kết xem trước trực tiếp và triển khai nó lên các thiết bị đầu cuối thanh toán, máy tính bảng và ki-ốt. POS quầy, tự thanh toán, đặt món nhà hàng, màn hình bếp và ứng dụng thanh toán trực tiếp.
- Hub, văn phòng hậu cần phía sau các ứng dụng đó: sản phẩm và danh mục, tồn kho và đơn đặt hàng, đơn hàng, khách hàng, báo cáo bán hàng, nhóm và vai trò, cửa hàng, thuế, đặt chỗ.
Bạn đăng nhập bằng tài khoản Final của mình (OAuth 2.1) và chọn công ty cũng như những gì tác nhân có thể làm. Không có gì để cài đặt hoặc chạy cục bộ.
| Điểm cuối | https://ai.finalpos.com/mcp |
| Truyền tải | HTTP có thể phát trực tuyến |
| Xác thực | OAuth 2.1 với PKCE (đăng nhập bằng Final) hoặc khóa kết nối fai_ dưới dạng Authorization: Bearer |
| Tên đăng ký | com.finalpos/final |
| Hoạt động như | Người đã kết nối nó, trên một công ty, trong các gói họ đã cho phép |
| Chi phí | Miễn phí để kết nối; những gì tác nhân làm tuân theo gói Final của bạn, như thể bạn tự làm trong Final |
Kết nối
Hầu hết các máy khách chỉ cần URL. Họ mở trang đăng nhập Final nơi bạn chọn công ty và các gói, sau đó họ được kết nối.
Claude (claude.ai, Claude Desktop)
Cài đặt → Trình kết nối → Thêm trình kết nối tùy chỉnh, URL https://ai.finalpos.com/mcp.
ChatGPT
Cài đặt → Ứng dụng & Trình kết nối → Cài đặt nâng cao → Chế độ nhà phát triển, sau đó
Tạo với URL https://ai.finalpos.com/mcp.
Claude Code
claude mcp add --transport http final https://ai.finalpos.com/mcp
Chạy /mcp trong Claude Code và chọn Xác thực. Hoặc cài đặt plugin,
plugin này thêm máy chủ cùng với kỹ năng sổ tay Final. Bên trong 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
Tiện ích mở rộng thêm máy chủ, sổ tay Final và các lệnh:
/final-pos:stock, /final-pos:sales, /final-pos:new, /final-pos:preview,
/final-pos:validate và /final-pos:deploy. Đăng nhập một lần bằng
/mcp auth final bên trong Gemini CLI. Để chỉ thêm máy chủ:
gemini mcp add --transport http final https://ai.finalpos.com/mcp
Cursor
Hoặc trong ~/.cursor/mcp.json:
{
"mcpServers": {
"final": { "url": "https://ai.finalpos.com/mcp" }
}
}
VS Code (GitHub Copilot)
Cài đặt trong VS Code, hoặc:
code --add-mcp '{"name":"final","type":"http","url":"https://ai.finalpos.com/mcp"}'
Codex, tập lệnh và máy khách không có OAuth
Tạo khóa kết nối tại ai.finalpos.com/connections.
Khóa chỉ được hiển thị một lần và trang sẽ in đoạn mã chính xác cho từng máy khách. Đối với
Codex, thêm phần này vào ~/.codex/config.toml:
[mcp_servers.final]
url = "https://ai.finalpos.com/mcp"
http_headers = { "Authorization" = "Bearer fai_YOUR_KEY" }
Bất kỳ máy khách nào khác: POST https://ai.finalpos.com/mcp với
Authorization: Bearer fai_YOUR_KEY.
Các khóa bắt đầu bằng
sk_(Flow) hoặcfpm_(Hub) thuộc về máy chủ riêng của các sản phẩm đó và không được chấp nhận ở đây. Tạo khóafai_thay thế, hoặc sử dụng OAuth.
Kiểm tra rằng nó hoạt động
Hỏi tác nhân của bạn: "Sử dụng Final để cho tôi biết bạn đang kết nối với công ty nào và
bạn có thể sử dụng những gói nào." Nó gọi get_connection và list_packs.
Những gì tác nhân của bạn có thể làm
Các công cụ được nhóm thành các gói. Khi bạn kết nối, bạn chọn những gói mà
tác nhân có thể sử dụng và đó cũng là các phạm vi OAuth. Để giữ ngữ cảnh của mô hình
nhỏ, một kết nối chỉ liệt kê một vài gói tại một thời điểm. Các công cụ cốt lõi truy cập phần
còn lại: find_tools tìm kiếm mọi gói được phép và call_tool gọi bất kỳ
công cụ được phép nào theo tên.
| Gói | Sản phẩm | Nội dung bao gồm | Được liệt kê mặc định |
|---|---|---|---|
catalog | Hub | Sản phẩm, biến thể, danh mục, tùy chọn, bộ điều chỉnh, ảnh sản phẩm và thư viện phương tiện | ✓ |
inventory | Hub | Mức tồn kho và lịch sử, chuyển kho, nhà cung cấp, đơn đặt hàng, quy tắc đặt hàng lại, nhập/xuất CSV tồn kho | |
orders | Hub | Đơn hàng, hoàn tiền và đồng bộ đơn hàng thương mại điện tử (chỉ đọc: quầy thu ngân xử lý thanh toán) | |
customers | Hub | Hồ sơ khách hàng, ghi chú, lịch sử đơn hàng và nhập khách hàng | |
reports | Hub | Tóm tắt tài chính, phân tích doanh số và thanh toán, doanh số nhân viên, phiên, giao dịch, xuất bản ghi | |
team | Hub | Thành viên nhóm, vai trò và quyền hạn | |
store | Hub | Cửa hàng, trạm, thuế và tiện ích mở rộng Hub | |
bookings | Hub | Dịch vụ có thể đặt: quy tắc, tài nguyên, tình trạng sẵn có, giữ chỗ và xác nhận | |
build | Flow | Xây dựng và triển khai ứng dụng POS Final: nền tảng API, bản thiết kế, tệp luồng, hộp cát xem trước, xác thực, triển khai | ✓ |
build_data | Flow | Bảng tùy chỉnh (cơ sở dữ liệu ứng dụng), kho bí mật và tiện ích mở rộng Flow |
Tên công cụ mang sản phẩm của chúng: hub_get_products, hub_find_low_stock,
flow_create_flow, flow_deploy_flow. TOOLS.md liệt kê mọi
công cụ, với gói của nó, liệu nó có thay đổi dữ liệu hay không và các đối số của nó.
Công cụ cốt lõi (luôn được liệt kê): get_connection, list_packs, find_tools,
call_tool, enable_packs, disable_packs, switch_company.
Những điều cần hỏi
Xây dựng ứng dụng POS tùy chỉnh (Flow)
- "Xây dựng ki-ốt quán cà phê với lưới sản phẩm, bộ điều chỉnh, giỏ hàng và thanh toán bằng thẻ, sau đó cung cấp cho tôi liên kết xem trước."
- "Thêm màn hình tiền tip vào ứng dụng quầy của tôi và xác thực nó."
- "Tạo luồng tự thanh toán cho cửa hàng tạp hóa nhỏ với quét mã vạch và màn hình biên nhận."
- "Gửi phiên bản mới nhất của luồng tự thanh toán của tôi."
Một bản dựng ứng dụng thường chạy flow_get_scaffold → flow_create_flow →
flow_lookup_command_frame (nền tảng) → flow_get_blueprint →
flow_write_flow_files → flow_validate_flow → flow_start_preview, và
trả về URL xem trước trực tiếp. Mọi thứ tác nhân xây dựng cũng xuất hiện trong
trình xây dựng Final, nơi mọi ghi tệp là một điểm kiểm tra có thể khôi phục.
Vận hành cửa hàng (Hub)
- "Sản phẩm nào dưới điểm đặt hàng lại tại cửa hàng Main Street? Soạn đơn đặt hàng cho nhà cung cấp thông thường."
- "So sánh doanh số tuần trước theo danh mục với tuần trước đó."
- "Thêm 40 sản phẩm này từ bảng tính đính kèm, kèm ảnh."
- "Ai là mười khách hàng hàng đầu của tôi trong tháng này và họ đã mua gì?"
- "Thiết lập dịch vụ mát-xa 45 phút có thể đặt với hai nhà trị liệu."
An toàn và quyền hạn
- Vai trò của bạn vẫn được áp dụng. Mọi cuộc gọi Hub chạy với tư cách là người đã kết nối và Hub kiểm tra vai trò trực tiếp của họ trên mỗi cuộc gọi. Các hành động chỉ dành cho chủ sở hữu vẫn chỉ dành cho chủ sở hữu.
- Các gói là quyền hạn. Tác nhân chỉ có thể gọi các công cụ trong các gói bạn đã cho phép. Bạn có thể thay đổi gói hoặc ngắt kết nối bất cứ lúc nào tại ai.finalpos.com/connections và việc ngắt kết nối thu hồi mọi mã thông báo cùng một lúc.
- Các ghi được gắn nhãn. Các công cụ đọc mang
readOnlyHintvà các triển khai và xóa mangdestructiveHint, để máy khách có thể hỏi trước khi hành động. Máy chủ yêu cầu tác nhân xác nhận các triển khai, xóa và thay đổi hàng loạt với bạn. - Tiền vẫn ở trên quầy thu ngân. Nhận thanh toán, hoàn tiền và hủy đơn hàng không khả dụng qua MCP.
- Bí mật không bao giờ đi qua mô hình.
flow_request_secretyêu cầu bạn nhập khóa API trong trình xây dựng. - Mọi thứ đều được ghi lại. Trang Kết nối hiển thị từng máy khách đã kết nối và mọi cuộc gọi nó thực hiện, trực tiếp.
- Giới hạn Flow: Flow cho phép 30 lần khởi động xem trước, 12 bản dựng và triển khai, và 300 ghi tệp mỗi giờ.
Quyền riêng tư và hỗ trợ
- Những gì Final giữ lại. Kết nối (ai đã tạo, công ty và các gói), mã thông báo nó sử dụng để truy cập Hub và Flow (được mã hóa) và nhật ký của mỗi cuộc gọi công cụ: công cụ, kết quả, thời gian thực hiện và bản xem trước đã được biên tập lại của các đối số và kết quả. Bạn thấy nhật ký đó trên Trang Kết nối.
- Những gì Final không thấy. Cuộc trò chuyện của bạn. Máy khách MCP gửi các cuộc gọi công cụ, không phải cuộc trò chuyện xung quanh chúng.
- Ngắt kết nối xóa mã thông báo đã lưu và thu hồi mọi mã thông báo được cấp cho kết nối đó.
- Chính sách quyền riêng tư · Điều khoản
- Hỗ trợ: support@finalpos.com. Đối với các vấn đề với hướng dẫn này hoặc plugin, hãy mở một vấn đề.
Điểm cuối trực tiếp của Flow
Các thiết lập được tạo trước cổng có thể vẫn sử dụng https://flow.finalpos.com/api/mcp
với khóa Flow sk_ (tên đăng ký com.finalpos.build/final-flows). Nó vẫn
hoạt động, nhưng các thiết lập mới nên sử dụng https://ai.finalpos.com/mcp, bao gồm
Flow.
Câu hỏi thường gặp
Máy chủ MCP Final là gì?
Đây là máy chủ MCP chính thức cho Final POS. Một URL từ xa,
https://ai.finalpos.com/mcp, cho phép trợ lý AI đọc và quản lý
văn phòng hậu cần Final của người bán (Hub) và xây dựng các ứng dụng điểm bán hàng (Flow).
ChatGPT hoặc Claude có thể quản lý tồn kho Final POS của tôi không?
Có. Cho phép gói inventory khi bạn kết nối. Tác nhân có thể kiểm tra mức tồn kho,
tìm hàng tồn kho thấp, đề xuất đặt hàng lại, tạo đơn đặt hàng và ghi nhận
hàng đã nhận.
Tác nhân AI có thể xây dựng ứng dụng POS trên Final không?
Có. Với gói build, tác nhân tạo một luồng, viết ứng dụng dựa trên
các API được khóa phiên bản của Final và các bản thiết kế màn hình đã được kiểm duyệt, xác thực nó và
trả về URL xem trước trực tiếp. Bạn khởi chạy nó từ trình xây dựng Final.
Tôi có cần khóa API không?
Không, nếu máy khách của bạn hỗ trợ OAuth (Claude, ChatGPT, Claude Code, Cursor,
Gemini CLI, VS Code): chỉ cần đăng nhập bằng Final. Codex và tập lệnh sử dụng khóa fai_
từ ai.finalpos.com/connections.
Nó hoạt động trên công ty nào?
Công ty bạn chọn khi kết nối. Nếu tài khoản của bạn có nhiều công ty, tác nhân có thể
gọi switch_company.
Tác nhân có thể nhận thanh toán hoặc phát hành hoàn tiền không?
Không. Thanh toán, hoàn tiền và hủy xảy ra trên quầy thu ngân. Đơn hàng chỉ đọc qua MCP.
Tại sao tác nhân của tôi chỉ thấy một vài công cụ?
Máy khách đặt mọi công cụ được liệt kê vào ngữ cảnh của mô hình và chất lượng giảm với
danh sách dài. Tác nhân tìm phần còn lại với find_tools, gọi chúng với
call_tool hoặc liệt kê toàn bộ gói với enable_packs.
Có chi phí không?
Kết nối miễn phí. Những gì tác nhân làm được tính phí như công việc tương tự được thực hiện trong Final bởi chính bạn, theo gói Final của bạn.
Tài liệu API Final POS ở đâu?
Tại finalpos.com/docs. Một tác nhân xây dựng ứng dụng
không cần chúng riêng biệt: gói build nền tảng mọi cuộc gọi dựa trên
các API được khóa phiên bản của Final (flow_lookup_pos_api,
flow_lookup_command_frame).
Về kho lưu trữ này
Kho lưu trữ này chứa hướng dẫn thiết lập công khai, các mục đăng ký MCP
(server.json, legacy/), tiện ích mở rộng Gemini CLI
(gemini-extension.json, GEMINI.md, commands/), các chợ plugin Claude Code và
Cursor (.claude-plugin/, .cursor-plugin/ và
plugins/final/, mà cả hai chia sẻ) và
tham chiếu công cụ được tạo với bản song hành có thể đọc bằng máy catalog.json,
mà thẻ máy chủ tại https://ai.finalpos.com/.well-known/mcp/server-card.json
cũng đọc. GEMINI.md và kỹ năng Claude là cùng một
sổ tay và CI kiểm tra rằng chúng khớp. Máy chủ được lưu trữ bởi Final;
không có mã từ kho lưu trữ này chạy trên máy của bạn.
Giấy phép
Apache-2.0 © Final Commerce