Final POS – Custom POS Builder

chính thức

Xâ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

Final

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

MCP Registry: com.finalpos/final Add to Cursor Install in VS Code License: Apache-2.0

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ốihttps://ai.finalpos.com/mcp
Truyền tảiHTTP có thể phát trực tuyến
Xác thựcOAuth 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

Add to 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ặc fpm_ (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óa fai_ 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óiSản phẩmNội dung bao gồmĐược liệt kê mặc định
catalogHubSả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✓
inventoryHubMứ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
ordersHubĐơ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)
customersHubHồ sơ khách hàng, ghi chú, lịch sử đơn hàng và nhập khách hàng
reportsHubTó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
teamHubThành viên nhóm, vai trò và quyền hạn
storeHubCửa hàng, trạm, thuế và tiện ích mở rộng Hub
bookingsHubDị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
buildFlowXâ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_dataFlowBả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 readOnlyHint và các triển khai và xóa mang destructiveHint, để 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_secret yê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