Model Context Protocol Server · v1
Pancake POS MCP
Bộ MCP server bao bọc REST API của Pancake POS — cho phép Claude và các trợ lý AI khác vận hành toàn bộ nghiệp vụ POS thương mại điện tử Việt Nam thông qua 23 công cụ chuyên biệt và 7 tài nguyên tham chiếu.
01 ·Quy mô bộ công cụ
23
MCP Tools
Trải khắp 5 phase nghiệp vụ POS
7
Reference Resources
Status, sources, webhooks, error codes…
3
Transports
stdio · Streamable HTTP · CF Workers
5
Domain Phases
Core · Supply · Sales · CRM · Ops
1k/min
Rate Limit
Token-bucket, exponential backoff
02 ·Kiến trúc tổng thể
Ctrl/Cmd + cuộn để zoom · kéo để pan · double-click để fit
Loading…
03 ·23 tools theo 5 domain
Phase 1 · Core POS
Bán hàng cốt lõi
CRUD đơn hàng, sản phẩm, khách hàng, tồn kho — bộ "tim" của mọi hệ POS.
manage_orders
manage_products
manage_customers
manage_inventory
Phase 2 · Supply Chain
Chuỗi cung ứng
Kho bãi, nhà cung cấp, nhập hàng, chuyển kho, kiểm kê thực tế.
manage_warehouses
manage_suppliers
manage_purchases
manage_transfers
manage_stocktaking
Phase 3 · Sales
Khuyến mãi & hậu mãi
Đổi/trả, combo, chiến dịch giảm giá %, voucher mã.
manage_returns
manage_combos
manage_promotions
manage_vouchers
Phase 4 · CRM & Multi-channel
Khách hàng & đa kênh
Pipeline bán hàng, hoạt động, đồng bộ Shopee/Lazada/TikTok, livestream.
manage_crm_contacts
manage_crm_deals
manage_crm_activities
manage_ecommerce
manage_livestream
Phase 5 · Operations
Vận hành & dữ liệu
Nhân viên, webhook, thống kê, hồ sơ shop, tra cứu địa chỉ VN (tỉnh → huyện → xã).
manage_employees
manage_webhooks
get_statistics
get_shop_info
lookup_address
04 ·Bảng tra cứu chi tiết
| Tool | Phase | Mô tả |
|---|---|---|
manage_orders | 1 | Tạo · đọc · cập nhật · xoá · in · giao hàng · đổi trạng thái đơn |
manage_products | 1 | Catalog sản phẩm với biến thể (variations) và bậc giá |
manage_customers | 1 | CRUD khách hàng, điểm thưởng, lịch sử giao dịch |
manage_inventory | 1 | Báo cáo tồn kho lọc theo kho · nhóm · NCC |
manage_warehouses | 2 | CRUD kho và cấu hình |
manage_suppliers | 2 | Quản lý liên hệ và hồ sơ nhà cung cấp |
manage_purchases | 2 | Đơn nhập hàng, hàng nhập kho |
manage_transfers | 2 | Chuyển kho nội bộ giữa các warehouse |
manage_stocktaking | 2 | Phiên kiểm kê tồn vật lý |
manage_returns | 3 | Xử lý đơn trả & đổi hàng |
manage_combos | 3 | Combo bundle & ưu đãi giới hạn thời gian |
manage_promotions | 3 | Chiến dịch giảm giá theo % hoặc số tiền |
manage_vouchers | 3 | Sinh mã voucher & theo dõi sử dụng |
manage_crm_contacts | 4 | Quản lý contact CRM & quan hệ |
manage_crm_deals | 4 | Pipeline cơ hội bán hàng và stage |
manage_crm_activities | 4 | Cuộc gọi · họp · task · note gắn vào contact/deal |
manage_ecommerce | 4 | Đồng bộ Shopee · Lazada · TikTok |
manage_livestream | 4 | Quản lý phiên livestream & lịch phát |
manage_employees | 5 | Nhân viên & phân quyền theo kho |
manage_webhooks | 5 | Đăng ký event & cấu hình webhook |
get_statistics | 5 | Phân tích tồn kho · doanh thu · đơn hàng theo nhóm |
get_shop_info | 5 | Hồ sơ shop & cấu hình chung |
lookup_address | 5 | Hệ thống địa chỉ VN: tỉnh → huyện → xã |
05 ·7 tài nguyên tham chiếu
order-statuses
16 mã trạng thái đơn — tên VN/EN
order-sources
Mã kênh bán: Facebook · Shopee · Lazada · …
sort-options
22 tuỳ chọn sắp xếp khi liệt kê đơn
webhook-events
order.created · order.updated · …
error-codes
Tham chiếu mã lỗi HTTP
rate-limits
1.000/phút · 10.000/giờ
shipping-partners
Đối tác vận chuyển — cache từ API live
06 ·3 cách triển khai
i.
stdio
Mặc định cho Claude Desktop. Đơn giản nhất — chạy local, không cần auth.
bun run src/index.ts
ii.
Streamable HTTP
Cho remote access & multi-client. Hỗ trợ Bearer token (
MCP_AUTH_TOKEN), endpoint /mcp & health check /health.bun run src/index.ts --http
PORT=3000 MCP_AUTH_TOKEN=…
iii.
Cloudflare Workers
Edge serverless, low-latency toàn cầu. 8s timeout/upstream, 2 retries, free tier 100k req/ngày. Kết nối Claude qua
mcp-remote.bun run dev:workers
bun run deploy
07 ·Trụ cột kỹ thuật
Token-bucket rate limiting
Tự co giãn theo giới hạn API gốc
1000/min, 10000/hour. Tránh ban IP khi LLM gọi quá nhanh.Exponential backoff retry
3 lần thử lại có chiến lược, xử lý lỗi mạng tạm thời mà không khiến agent loop vô hạn.
Zod discriminated unions
Mỗi tool có schema chặt — runtime validation cho mọi input trước khi chạm API.
z.coerce.number() để dung nạp số dạng chuỗi từ LLM.Bearer token auth
Trên HTTP & Workers transport — bảo vệ shop khỏi truy cập trái phép khi expose ra internet.
Structured errors
Mọi lỗi trả về có
code + message để AI tự sửa lỗi mà không cần con người dò log.VN-first design
Tên trạng thái song ngữ, lookup địa chỉ Việt Nam, multi-channel sync với marketplace nội địa.