Kết nối Pancake POS với trợ lý AI Claude qua chuẩn MCP (Model Context Protocol). Tạo đơn, tra doanh thu, kiểm tồn kho, làm voucher.
Mọi thao tác bạn vẫn làm trên Pancake POS, gõ một câu là xong.
"Tạo đơn 3 áo size M cho Hoa"
Tạo đơn mới, sửa, hủy, in vận đơn, lấy mã tracking, xử lý đơn hoàn.
"Doanh thu tuần này tổng cộng bao nhiêu?"
Báo cáo bán hàng, lợi nhuận, so sánh kỳ, top sản phẩm - không cần Excel.
"Tồn kho ở chi nhánh HCM còn những gì?"
Tồn kho theo chi nhánh, cảnh báo sắp hết, lịch sử nhập xuất, kiểm kê.
"Cập nhật giá áo thun trắng thành 220k"
Thêm sửa sản phẩm, biến thể, combo, danh mục; ẩn hiện khi hết hàng.
"Khách Lan đã mua mấy đơn rồi?"
Hồ sơ KH, hạng VIP, điểm thưởng, lịch sử mua, ghi chú chăm sóc.
"Tạo 100 voucher giảm 50k, hạn 1 tuần"
Tạo CTKM, voucher đơn lẻ hoặc hàng loạt - chạy chiến dịch trong 1 câu.
"Tạo phiếu nhập 100 hộp bánh từ NCC ABC, đơn giá 80k"
Phiếu nhập, công nợ NCC, chi phí phát sinh - quản lý đầu vào gọn gàng.
"Công nợ khách Hùng còn bao nhiêu? Ghi nhận đã thu 500k"
Sổ quỹ, tài khoản thanh toán, công nợ KH/NCC, hóa đơn điện tử.
"Đơn hoàn Shopee gần đây thế nào?"
Xem sản phẩm Shopee, đơn hoàn, đánh giá, phiên livestream.
Cài đặt một lần, sau đó mở Claude là dùng được.
Tải miễn phí từ Anthropic, cài bình thường.
Lấy API key từ Pancake POS, dán vào cấu hình Claude.
Mở Claude, gõ câu hỏi hoặc yêu cầu.
Vào trang chính thức của Anthropic, tải về và cài bình thường như cài phần mềm khác.
Tải Claude DesktopCó bản cho macOS và Windows. Đăng ký tài khoản miễn phí. Để dùng nhiều, nên mua gói Pro (~20$/tháng).
Đăng nhập Pancake POS trên web → vào Cài đặt → API & Tích hợp → bấm Tạo API key mới.
Đặt tên dễ nhớ (vd: "Claude AI"), chọn shop bạn muốn AI thao tác, lưu lại. Bạn sẽ nhận được một chuỗi dài - copy giữ ngay, sẽ dùng ở bước sau.
Mở Claude Desktop, vào Settings → Connectors → Add custom connector. Dán URL dưới đây vào ô "Remote MCP server URL", đặt tên tuỳ ý (vd: "Pancake POS"), bấm Add.
https://mcp-pos.pancake.biz/mcp
Sau khi Add, Claude Desktop tự mở browser tới trang authorize. Dán API key bạn lấy ở bước 2 vào form, bấm Authorize. Browser tự đóng, kết nối sẵn sàng.
Vào Settings → Developer → Edit Config, dán đoạn dưới vào (thay DÁN_MÃ_API_VÀO_ĐÂY bằng key bước 2). Cần Node.js cài sẵn vì dùng npx mcp-remote làm bridge.
{
"mcpServers": {
"pancake-pos": {
"command": "npx",
"args": [
"-y", "mcp-remote@0.1.18",
"https://mcp-pos.pancake.biz/mcp",
"--header", "X-Api-Key:DÁN_MÃ_API_VÀO_ĐÂY"
]
}
}
}
Đóng hoàn toàn Claude Desktop (trên macOS: Cmd+Q, đừng chỉ bấm nút X) rồi mở lại. Tạo chat mới, gõ thử:
Lần đầu, Claude sẽ hỏi bạn "có cho phép gọi công cụ này không?" - bấm Allow. Nếu thấy danh sách đơn hiện ra là xong!
Chạy 1 lệnh dưới đây trong terminal, thay DÁN_MÃ_API_VÀO_ĐÂY bằng API key bước 2.
claude mcp add --transport http -s user pancake-pos \ https://mcp-pos.pancake.biz/mcp \ --header "X-Api-Key: DÁN_MÃ_API_VÀO_ĐÂY"
Verify: claude mcp list phải thấy pancake-pos ... ✓ Connected. Trong session Claude Code, gõ /mcp xem các tool pos_*.
Codex (OpenAI) cũng hỗ trợ chuẩn MCP. Mở file ~/.codex/config.toml rồi dán đoạn dưới đây. File này dùng chung cho Codex Desktop, IDE extension và CLI.
[mcp_servers.pancake-pos]
url = "https://mcp-pos.pancake.biz/mcp"
http_headers = { "X-Api-Key" = "DÁN_MÃ_API_VÀO_ĐÂY" }
Lưu ý: Codex dùng field http_headers (khác với Claude dùng headers) - đừng copy nhầm config giữa 2 client.