MCP (Model Context Protocol) là chuẩn mở để trợ lý AI gọi công cụ bên ngoài. Máy chủ MCP của Pancake POS đưa Open API thành các công cụ mà Claude, Codex, Cursor… dùng được: bạn nói yêu cầu bằng câu thường ngày, AI tự gọi đúng API trên cửa hàng của bạn và trả lời bằng kết quả thật.
Text
https://mcp-pos.pancake.biz/mcpAI làm được gì
| Bạn nói | AI làm |
|---|---|
| "Tạo đơn 3 áo size M cho chị Hoa" | Tạo, sửa, hủy đơn; in vận đơn, lấy mã vận đơn, xử lý đơn hoàn |
| "Doanh thu tuần này bao nhiêu, so với tuần trước?" | Báo cáo bán hàng, lợi nhuận, so sánh kỳ, sản phẩm bán chạy |
| "Kho chi nhánh Hồ Chí Minh còn những gì?" | Tồn kho theo kho, hàng sắp hết, lịch sử nhập xuất, kiểm kê |
| "Đổi giá áo thun trắng thành 220k" | Thêm, sửa sản phẩm, mẫu mã, combo, danh mục |
| "Chị Lan đã mua mấy đơn rồi?" | Hồ sơ khách hàng, hạng thành viên, điểm thưởng, lịch sử mua |
| "Tạo 100 voucher giảm 50k, hạn 1 tuần" | Chương trình khuyến mãi, voucher đơn lẻ hoặc hàng loạt |
| "Tạo phiếu nhập 100 hộp bánh từ nhà cung cấp ABC, giá 80k" | Phiếu nhập, nhà cung cấp, công nợ |
| "Công nợ anh Hùng còn bao nhiêu?" | Sổ quỹ, công nợ khách hàng và nhà cung cấp, hóa đơn điện tử |
| "Đơn hoàn từ sàn gần đây thế nào?" | Sản phẩm và đơn trên sàn thương mại điện tử, phiên livestream |
AI chỉ làm được những gì API key của bạn được phép (xem Quyền & bảo mật).
Cách hoạt động
- Bạn thêm máy chủ MCP vào client (Claude Desktop, Claude Code, Codex, Cursor…) kèm API key của Pancake POS. Xem Kết nối.
- Client nhận danh sách tool: mỗi nghiệp vụ một tool, ví dụ
pos_orderđể đọc đơn,pos_order_writeđể tạo và sửa đơn. Xem Danh sách tool. - Khi bạn hỏi, AI chọn tool, tra tham số cần thiết bằng
pos_describe, rồi gọi Open API với key của bạn. - Thao tác ghi dữ liệu: client hỏi bạn xác nhận trước khi chạy (tuỳ cài đặt của client).
Máy chủ MCP không lưu dữ liệu cửa hàng; mỗi lần gọi đi thẳng tới Open API và trả kết quả cho AI.
Chọn cách tích hợp
| Bạn cần | Dùng |
|---|---|
| Hỏi đáp, thao tác nhanh trên cửa hàng qua trợ lý AI | MCP (trang này) |
| Đồng bộ dữ liệu tự động giữa POS và hệ thống khác | Open API |
| Thêm nút, khối thông tin, trang riêng ngay trong giao diện POS | POS Apps |
| Nhờ AI viết POS App cho bạn | MCP của bộ công cụ POS Apps (pos-app mcp), xem Làm app với AI |