Đơn hàng & thanh toán
9 công cụTra, tạo, sửa đơn; đổi trạng thái; mã QR chuyển khoản; trường tùy chọn của cửa hàng.
- list_orders
- get_order
- get_order_settings
- create_order
- update_order
- set_order_status
- create_order_payment_qr
MCPK nối Claude, ChatGPT, Cursor… với dữ liệu SieuTroLy: đơn hàng, tồn kho, khách hàng, hội thoại đa kênh, giao hàng, đăng bài. Dán một địa chỉ, đăng nhập một lần — không cần tạo API key.
https://mcpk.vn/mcp
| DH20261120-014 · Lê Văn Thịnh | 32.000đ |
| DH20261120-021 · Phạm Thu Hà | 27.000đ |
| DH20261120-027 · Ngô Minh Khôi | 41.000đ |
Bạn muốn tôi gọi tài xế cho cả 3 đơn không?
MCPK là máy chủ MCP từ xa (remote MCP) theo đặc tả Authorization mới nhất — cùng cơ chế Meta dùng cho Meta Ads MCP. Ứng dụng AI tự phát hiện cách đăng nhập, bạn chỉ việc bấm «Cho phép».
Trong Claude, ChatGPT, Cursor hay VS Code, thêm máy chủ MCP mới với địa chỉ https://mcpk.vn/mcp.
Cửa sổ đăng nhập mở ra. Chọn workspace, tick đúng những quyền muốn giao cho AI — mặc định chỉ xem.
Hỏi doanh thu, kiểm kho, soạn đơn, trả lời khách. Mọi thao tác ghi thật đều cần bạn yêu cầu rõ và đều có nhật ký.
AI chỉ thấy những công cụ thuộc quyền bạn đã cấp. Cấp «chỉ xem» thì không một công cụ ghi nào xuất hiện.
Tra, tạo, sửa đơn; đổi trạng thái; mã QR chuyển khoản; trường tùy chọn của cửa hàng.
Danh mục, sản phẩm, tồn theo chi nhánh, thẻ kho, kiểm kê có chạy thử.
Tìm theo SĐT (cả số phụ), hồ sơ, nhãn, ghi chú chăm sóc.
Zalo, Facebook, TikTok, Shopee… đọc tin, tìm câu hỏi, đổi trạng thái, gửi tin và ảnh sản phẩm.
Tìm địa chỉ có tọa độ, báo phí Ahamove / AllinGo / Viettel Post, gọi và hủy giao.
Nhà cung cấp, phiếu nhập nháp → gửi duyệt → cộng kho, công nợ và trả nợ NCC.
Facebook, YouTube, TikTok, Instagram, X: soạn nháp, hẹn giờ, đăng, xem số liệu.
AI dựng quy trình từ đầu tới cuối: chọn bước, nối nhánh, kiểm tra, bật chạy.
Đọc và ghi dữ liệu sống của cửa hàng KiotViet đã kết nối với SieuTroLy.
Tuần này món nào bán chạy nhất ở cả 2 chi nhánh? So với tuần trước.list_orders → get_order
Liệt kê nguyên liệu dưới mức tồn tối thiểu và lập phiếu nhập nháp cho nhà cung cấp quen.list_stock → list_suppliers → create_purchase
Tìm các khách hỏi “còn size M không” mà bot chưa trả lời được trong 7 ngày qua.search_messages → get_conversation_messages
Soạn bài giới thiệu combo cuối tuần, hẹn đăng Facebook và TikTok lúc 19:00 thứ Sáu.import_content_media → create_content_post
Khách 0912 345 678 muốn đổi địa chỉ giao đơn hôm qua sang công ty, người nhận là chị Hà.search_customers → update_order
Dựng quy trình: đơn hoàn thành thì gửi Zalo cảm ơn kèm mã giảm 10% sau 2 ngày.list_workflow_step_types → create_workflow
Ứng dụng nào hỗ trợ MCP từ xa có OAuth đều dùng được. Cần tài khoản SieuTroLy (gói Miễn phí cũng được).
# Tên MCPK # Remote MCP server URL https://mcpk.vn/mcp
# MCP Server URL https://mcpk.vn/mcp # Authentication OAuth
claude mcp add --transport http mcpk https://mcpk.vn/mcp
{
"mcpServers": {
"mcpk": { "url": "https://mcpk.vn/mcp" }
}
}
// .vscode/mcp.json { "servers": { "mcpk": { "type": "http", "url": "https://mcpk.vn/mcp" } } }
Đăng nhập bằng OAuth 2.1 với PKCE. Token truy cập sống 1 giờ, tự làm mới; máy chủ chỉ lưu bản băm SHA-256.
20 nhóm quyền (xem đơn, sửa đơn, gửi tin, gọi giao hàng…). Không cấp được quyền vượt quá quyền của chính bạn trong workspace.
Thao tác của AI được ghi tên kết nối «MCPK · ứng dụng», có giới hạn tần suất và kích hoạt webhook như API thường.
Mỗi kết nối hiện ở trang API Key của SieuTroLy. Tắt hoặc xóa là ứng dụng AI mất quyền ngay lập tức.
Streamable HTTP không giữ phiên, trả JSON. Xác thực theo MCP Authorization (2025-06-18): RFC 9728, RFC 8414, Dynamic Client Registration RFC 7591, PKCE S256, resource indicator RFC 8707.
| Bước | Yêu cầu | Kết quả |
|---|---|---|
| 1 | POST /mcp không có token | 401 + WWW-Authenticate: Bearer resource_metadata="https://mcpk.vn/.well-known/oauth-protected-resource/mcp" |
| 2 | GET /.well-known/oauth-protected-resource/mcp | resource, authorization_servers: ["https://mcpk.vn"], scopes |
| 3 | GET /.well-known/oauth-authorization-server | authorize, token, register, revoke; code_challenge_methods_supported: ["S256"] |
| 4 | POST /oauth/register | client_id công khai (token_endpoint_auth_method: none) |
| 5 | GET /oauth/authorize?response_type=code&code_challenge=… | Trang đăng nhập + đồng ý → về redirect_uri?code=…&state=…&iss=… |
| 6 | POST /oauth/token (code + code_verifier) | access_token 1 giờ, refresh_token 90 ngày, xoay mỗi lần làm mới |
| 7 | POST /mcp + Authorization: Bearer … | tools/list chỉ gồm công cụ trong scope đã cấp |
Máy chủ không có giao diện người dùng vẫn dùng được API key của SieuTroLy: Authorization: Bearer sk_live_… gửi tới cùng địa chỉ https://mcpk.vn/mcp. Danh sách công cụ và tham số: docs.sieutroly.ai.
Model Context Protocol là chuẩn mở để ứng dụng AI gọi công cụ bên ngoài. Thay vì chép dữ liệu vào khung chat, AI tự hỏi đúng hệ thống, đúng lúc, với đúng quyền bạn cấp.
MCPK dùng hạn mức của gói SieuTroLy bạn đang dùng, không tính phí riêng. Mỗi lần AI gọi một công cụ tính như một yêu cầu API (mặc định 60 yêu cầu/phút mỗi kết nối).
Chỉ khi bạn cấp quyền ghi tương ứng và yêu cầu rõ. Các công cụ ghi thật được đánh dấu để ứng dụng AI hỏi lại bạn trước khi chạy. Muốn an toàn tuyệt đối, chỉ cấp quyền «xem».
Được. Mỗi người đăng nhập bằng tài khoản của mình và chỉ cấp được những quyền mình đang có — nhân viên chỉ xem đơn thì AI của họ cũng chỉ xem đơn.
Mỗi kết nối gắn với một workspace. Thêm MCPK lần nữa (đặt tên khác) để nối workspace thứ hai.
MCPK chỉ trả dữ liệu cho ứng dụng AI bạn kết nối, theo từng yêu cầu. Chính sách lưu trữ và huấn luyện là của nhà cung cấp ứng dụng AI đó — hãy kiểm tra cài đặt dữ liệu trong tài khoản AI của bạn.
Một địa chỉ cho mọi ứng dụng AI. Dữ liệu vẫn nằm trong SieuTroLy, quyền vẫn nằm trong tay bạn.
https://mcpk.vn/mcp