# Tổng quan

**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](/developers/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/mcp
```

## AI 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](/developers/mcp/permissions)).

## Cách hoạt động

1. 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](/developers/mcp/connect).
2. 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](/developers/mcp/tools).
3. 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.
4. 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](/developers/api) |
| Thêm nút, khối thông tin, trang riêng ngay trong giao diện POS | [POS Apps](/developers/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](/developers/apps/ai-guide) |