Kết nối ngay
Model Context Protocol · cho người bán hàng Việt

Cho AI agent làm việc thật với cửa hàng của bạn

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.

MCP URL https://mcpk.vn/mcp
84công cụ MCP
20nhóm quyền tách bạch
OAuth 2.1PKCE, không lộ khóa
Claude · kết nối MCPK
Hôm nay chi nhánh Quận 3 còn bao nhiêu đơn giao chưa gọi ship? Báo phí Ahamove cho từng đơn.
list_orders branch=Q3 · order_type=delivery · status=confirmed
quote_order_shipping × 3 đơn
Còn 3 đơn giao hôm nay chưa gọi ship:
DH20261120-014 · Lê Văn Thịnh32.000đ
DH20261120-021 · Phạm Thu Hà27.000đ
DH20261120-027 · Ngô Minh Khôi41.000đ

Bạn muốn tôi gọi tài xế cho cả 3 đơn không?

Cách hoạt động

Ba bước, không một dòng mã

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».

Thêm địa chỉ MCP

Trong Claude, ChatGPT, Cursor hay VS Code, thêm máy chủ MCP mới với địa chỉ https://mcpk.vn/mcp.

Đăng nhập SieuTroLy

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.

Giao việc bằng tiếng Việt

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ý.

Công cụ

84 công cụ, phủ trọn việc của một cửa hàng

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.

Đơ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

Sản phẩm & kho

10 công cụ

Danh mục, sản phẩm, tồn theo chi nhánh, thẻ kho, kiểm kê có chạy thử.

  • list_products
  • list_stock
  • list_stock_movements
  • update_product
  • stocktake

Khách hàng

7 công cụ

Tìm theo SĐT (cả số phụ), hồ sơ, nhãn, ghi chú chăm sóc.

  • search_customers
  • get_customer
  • list_labels
  • update_customer
  • add_customer_note

Hội thoại đa kênh

7 công 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.

  • list_conversations
  • search_messages
  • send_message
  • send_product_images

Giao hàng

9 công cụ

Tìm địa chỉ có tọa độ, báo phí Ahamove / AllinGo / Viettel Post, gọi và hủy giao.

  • search_address
  • quote_shipping
  • ship_order
  • create_shipment

Nhập hàng & NCC

16 công cụ

Nhà cung cấp, phiếu nhập nháp → gửi duyệt → cộng kho, công nợ và trả nợ NCC.

  • list_suppliers
  • list_purchases
  • create_purchase
  • submit_purchase
  • pay_supplier

Đăng bài đa nền tảng

10 công cụ

Facebook, YouTube, TikTok, Instagram, X: soạn nháp, hẹn giờ, đăng, xem số liệu.

  • list_content_posts
  • get_content_analytics
  • create_content_post
  • publish_content_post

Quy trình tự động

12 công cụ

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.

  • list_workflow_step_types
  • validate_workflow
  • create_workflow
  • run_workflow

KiotViet

3 công cụ

Đọc và ghi dữ liệu sống của cửa hàng KiotViet đã kết nối với SieuTroLy.

  • list_kiotviet_operations
  • kiotviet_read
  • kiotviet_write
Chỉ đọcGhi thật — AI chỉ làm khi bạn yêu cầu rõ
Thử hỏi

Những câu chủ shop hay giao cho AI

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
Kết nối

Chọn ứng dụng AI bạn đang dùng

Ứ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).

  1. Mở Cài đặt → Connectors (claude.ai hoặc ứng dụng Claude).
  2. Bấm Add custom connector, đặt tên MCPK.
  3. Dán địa chỉ https://mcpk.vn/mcp, để trống phần OAuth nâng cao.
  4. Bấm Connect → đăng nhập SieuTroLy → chọn workspace và quyền → Cho phép.
# Tên
MCPK
# Remote MCP server URL
https://mcpk.vn/mcp
Bảo mật

AI được làm gì là do bạn quyết

Không có khóa bí mật để lộ

Đă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.

Quyền tách theo việc

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.

Mọi lần gọi đều có nhật ký

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.

Thu hồi trong một cú bấm

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.

Nhà phát triển

Chuẩn mở, tự phát hiện

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ướcYêu cầuKết quả
1POST /mcp không có token401 + WWW-Authenticate: Bearer resource_metadata="https://mcpk.vn/.well-known/oauth-protected-resource/mcp"
2GET /.well-known/oauth-protected-resource/mcpresource, authorization_servers: ["https://mcpk.vn"], scopes
3GET /.well-known/oauth-authorization-serverauthorize, token, register, revoke; code_challenge_methods_supported: ["S256"]
4POST /oauth/registerclient_id công khai (token_endpoint_auth_method: none)
5GET /oauth/authorize?response_type=code&code_challenge=…Trang đăng nhập + đồng ý → về redirect_uri?code=…&state=…&iss=…
6POST /oauth/token (code + code_verifier)access_token 1 giờ, refresh_token 90 ngày, xoay mỗi lần làm mới
7POST /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.

Hỏi đáp

Câu hỏi thường gặp

MCP là gì?

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 có tính phí không?

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).

AI có tự ý tạo đơn, gửi tin cho khách không?

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».

Nhân viên trong workspace có dùng được không?

Đượ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.

Dùng nhiều workspace thì sao?

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.

Dữ liệu có bị dùng để huấn luyện AI không?

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.

Giao việc cho AI ngay hôm nay

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.

MCP URL https://mcpk.vn/mcp