Hướng dẫn sử dụng BigSeller MCP

I. Giới thiệu về MCP

MCP (Model Context Protocol) là giao thức tiêu chuẩn dùng để kết nối AI Agent với các công cụ bên ngoài.
Sau khi kết nối BigSeller MCP, AI Agent có thể tự động nhận diện các chức năng mà BigSeller MCP cung cấp. Bạn chỉ cần mô tả nhu cầu bằng ngôn ngữ tự nhiên, AI có thể gọi dữ liệu BigSeller để truy vấn, phân tích và xử lý theo yêu cầu mà không cần tự gọi API.

 

II. BigSeller MCP có thể làm gì?

Hiện tại, BigSeller MCP hỗ trợ truy vấn các loại dữ liệu như Đơn hàng, Phiếu nhập kho hàng trả về, Đơn đặt hàng, Báo cáo lợi nhuận (theo đơn hàng và theo SKU), Lịch sử giao dịch ví.
Để xem chi tiết các chức năng được hỗ trợ, vui lòng tham khảo Danh sách chức năng BigSeller MCP.

 

III. Kết nối BigSeller MCP

1. Lấy URL, APP ID và APP KEY

Vui lòng liên hệ CS BigSeller để nhận thông tin kết nối MCP.

• URL: https://mcp.bigseller.pro/mcp, do BigSeller tạo và cung cấp.
• APP ID: Do BigSeller tạo và cung cấp
• APP KEY: Do BigSeller tạo và cung cấp

2. Cài đặt BigSeller MCP trên AI Client

Dưới đây lấy Codex và WorkBuddy làm ví dụ.

2.1 Cài đặt MCP trên Codex

Thực hiện cấu hình MCP theo cách cài đặt MCP của phiên bản Codex hiện tại, sau đó thêm URL, APP ID và APP KEY do BigSeller cung cấp.

2.2 Cài đặt MCP trên WorkBuddy

2.2.1 Cấu hình MCP

WorkBuddy sử dụng JSON để cấu hình MCP. Bạn hãy sao chép JSON bên dưới vào phần cấu hình MCP, sau đó thay url, app-id và app-key bằng thông tin do BigSeller cung cấp:
{
  "mcpServers": {
    "bigseller": {
      "type": "streamable-http",
      "url": "Điền URL do BigSeller cung cấp",
      "headers": {
        "app-id": "Điền APP ID của bạn",
        "app-key": "Điền APP KEY của bạn"
      },
      "disabled": false
    }
  }
}

2.2.2 Đường dẫn cấu hình



2.3 Cài đặt MCP trên các AI Client khác

Cách cài đặt MCP có thể khác nhau tùy theo từng AI Client. Bạn có thể trực tiếp hỏi AI:

"Tôi muốn cài đặt một MCP từ xa của bên thứ ba, hãy hướng dẫn tôi cách cài đặt trên phiên bản hiện tại."

Sau đó, thực hiện cài đặt theo hướng dẫn mà AI cung cấp.
 

IV. Kiểm tra BigSeller MCP có hoạt động hay không

Sau khi hoàn tất cài đặt, bạn nên kiểm tra trước xem MCP đã có thể kết nối và gọi thành công hay chưa.

1. Thực hiện kiểm tra

Mở một cuộc trò chuyện mới trên AI Client và nhập:

"Gọi BigSeller MCP và sử dụng cách đơn giản nhất để xác nhận MCP có thể kết nối thành công hay không. Nếu có, hãy cho tôi biết BigSeller MCP hỗ trợ những chức năng nào."


2. Xác nhận kết quả

Nếu AI xác nhận BigSeller MCP đã kết nối thành công và có thể nhận diện các chức năng mà BigSeller MCP hỗ trợ, nghĩa là cấu hình đã hoàn tất.

Sau đó, bạn có thể tiếp tục yêu cầu AI truy vấn và phân tích dữ liệu theo nhu cầu thực tế.

 

V. Ví dụ về cách sử dụng MCP

Định kỳ lấy dữ liệu BigSeller để phân tích

Nếu muốn định kỳ lấy dữ liệu từ BigSeller, bạn có thể trực tiếp mô tả nhu cầu cho AI. Ví dụ:

Tôi muốn mỗi ngày lúc 9 giờ sáng định kỳ gọi BigSeller MCP để lấy dữ liệu XXX và phân tích, tổng hợp dữ liệu. Sau khi hoàn tất, hãy gửi báo cáo phân tích vào nhóm XXX. Hãy cho tôi biết nên thực hiện như thế nào và lập giúp tôi một phương án.

AI có thể dựa trên nhu cầu của bạn để hỗ trợ lên kế hoạch cho toàn bộ quy trình, bao gồm thiết lập tác vụ định kỳ, lấy dữ liệu, phân tích và gửi kết quả.

 

VI. Lưu ý

1. Bảo quản APP ID và APP KEY

APP ID và APP KEY là thông tin xác thực để gọi BigSeller MCP. Vui lòng bảo quản cẩn thận và không cung cấp cho người khác.
 

2. Giới hạn tần suất gọi API

Nếu API trả về lỗi: code: 10100002, message: Too many request, có nghĩa là tần suất gọi API quá cao.

Khi gặp lỗi này, bạn nên chờ 30 giây rồi thử gọi lại.
 

3. Lưu ý về múi giờ

Thời gian được trả về từ API BigSeller phần lớn sử dụng UTC. Nếu muốn dữ liệu truy vấn có thời gian hiển thị giống với trên giao diện BigSeller, vui lòng cung cấp cho AI thị trường bán hàng của tài khoản BigSeller.

AI sẽ dựa trên thị trường bán hàng của bạn để chuyển thời gian bạn muốn truy vấn sang thời gian của thị trường đó, sau đó chuyển sang UTC để thực hiện truy vấn.