AI làm được tới đâu
AI chỉ làm được những gì API key cho phép:
| API key | AI làm được |
|---|---|
| API key tài khoản (khuyến nghị) | Đúng quyền của bạn trong từng cửa hàng: vai trò, kho, bộ phận, giờ làm, IP được phép |
| API key cửa hàng | Toàn quyền trên Open API của cửa hàng đó |
Muốn AI chỉ xem dữ liệu, tạo API key từ một tài khoản chỉ có quyền xem, hoặc dùng quyền đọc khi kết nối bằng OAuth (bên dưới).
Đọc và ghi
Mỗi nghiệp vụ có tool đọc và tool ghi tách riêng (pos_order và pos_order_write, xem Danh sách tool). Tool được đánh dấu theo chuẩn MCP:
- Tool đọc (
readOnlyHint): chỉ xem dữ liệu. Client có thể cho phép tự chạy. - Tool ghi: tạo, sửa, hủy dữ liệu. Một số thao tác không hoàn tác được, ví dụ gọi điện tự động cho khách (
pos_auto_voice). Client được đánh dấu để hỏi bạn trước khi chạy.
Nên giữ chế độ client hỏi xác nhận trước mỗi thao tác ghi, và đọc kỹ tham số AI định gửi trước khi đồng ý, nhất là thao tác hàng loạt.
Hai cách xác thực
| Cách | Dùng khi | Giới hạn |
|---|---|---|
| OAuth | Claude Desktop (Connectors) và client hỗ trợ OAuth: client mở trang xác nhận, bạn dán API key | Client xin quyền pos:read (đọc) và/hoặc pos:write (ghi); trang xác nhận ghi rõ quyền. Máy chủ chặn tool ngoài quyền đã cấp |
Header X-Api-Key |
Claude Code, Codex, Cursor, cấu hình bằng file | Toàn bộ quyền của API key, không tách đọc/ghi phía máy chủ MCP |
Với OAuth, API key được mã hóa trong token do máy chủ MCP cấp; client không đọc được key gốc.
Dữ liệu đi đâu
- 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 rồi trả kết quả cho client.
- Kết quả trả về (đơn hàng, khách hàng, doanh thu…) được client gửi cho nhà cung cấp mô hình AI (Anthropic, OpenAI…) theo chính sách của nhà cung cấp đó. Cân nhắc trước khi cho AI đọc dữ liệu nhạy cảm của khách hàng.
Thu hồi kết nối
- Thu hồi API key: Tài khoản › API Key (key tài khoản) hoặc xóa trong Cấu hình › Ứng dụng › Webhook/API (key cửa hàng). Mọi client dùng key đó mất quyền ngay.
- Gỡ máy chủ khỏi client: xóa connector trong Claude Desktop,
claude mcp remove pancake-postrong Claude Code, hoặc xóa đoạn cấu hình trong Codex, Cursor.
Mỗi client nên dùng một API key riêng để thu hồi từng nơi khi cần.