Panduan Pengguna BigSeller MCP

Panduan ini membantu Anda menghubungkan BigSeller MCP ke AI Agent seperti Codex, Claude Code, dan WorkBuddy, sehingga Anda dapat mengambil data pesanan, inventaris, transaksi, dan data lainnya dengan cepat melalui layanan MCP untuk keperluan analisis data.

1. Apa Itu MCP?

MCP (Model Context Protocol) adalah protokol standar yang memungkinkan AI Agent terhubung dengan berbagai tools eksternal.

Setelah terhubung, AI dapat secara otomatis mendeteksi kemampuan yang disediakan oleh MCP. Anda cukup menggunakan bahasa alami untuk meminta AI menjalankan fungsi tersebut sesuai dengan kebutuhan bisnis Anda.

2. Apa yang Dapat Anda Lakukan Setelah Menghubungkan BigSeller MCP?

Saat ini, BigSeller MCP mendukung kemampuan berikut:

• Memperoleh pesanan

• Memperoleh pesanan pengembalian

• Memperoleh pesanan pembelian

• Memperoleh laporan keuntungan — data keuntungan berdasarkan pesanan dan SKU

• Memperoleh transaksi wallet

Kemampuan tersebut mencakup berbagai skenario bisnis, termasuk pesanan, inventaris, pembelian, analisis data, dan WMS.

Untuk informasi lebih lanjut, silakan hubungi Customer Service BigSeller.
 

3. Cara Menghubungkan BigSeller MCP ke AI Client Anda

Langkah 1. Dapatkan URL, APP ID, dan APP KEY Anda

Hubungi Customer Service BigSeller untuk mendapatkannya.

• URL (sama untuk semua pengguna):
  https://mcp.bigseller.pro/mcp

• APP ID dan APP KEY:
  Dibuat secara manual dan diberikan kepada Anda oleh BigSeller.

Langkah 2. Instal BigSeller MCP di AI Client Anda

Contoh di bawah ini menggunakan Codex dan WorkBuddy.

2.1 Menginstal MCP di Codex

[Masukkan screenshot langkah instalasi Codex di sini]

2.2 Menginstal MCP di WorkBuddy

2.2.1 Instalasi MCP melalui JSON

WorkBuddy menginstal MCP melalui JSON.

Salin JSON berikut ke pengaturan MCP Anda, kemudian ganti nilai url, app-id, dan app-key dengan informasi yang diberikan oleh BigSeller.

Konfigurasi JSON WorkBuddy MCP

{
  "mcpServers": {
    "bigseller": {
      "type": "streamable-http",
      "url": "Masukkan URL yang diberikan oleh BigSeller",
      "headers": {
        "app-id": "Masukkan APP ID Anda",
        "app-key": "Masukkan APP KEY Anda"
      },
      "disabled": false
    }
  }
}

2.2.2 Jalur Pengaturan

[Masukkan screenshot jalur pengaturan WorkBuddy di sini]

2.3 Menginstal MCP di AI Client Lain

Anda dapat langsung meminta bantuan melalui jendela chat AI Client Anda.

Pesan yang dapat digunakan:

Saya ingin menginstal remote MCP pihak ketiga. Tolong beri tahu saya langkah-langkah instalasi untuk versi Anda saat ini.

Kemudian, ikuti instruksi yang diberikan oleh AI.

4. Verifikasi MCP Setelah Instalasi

Buka percakapan baru di AI Client Anda dan masukkan:

Prompt Verifikasi

Panggil BigSeller MCP dan gunakan jalur minimal untuk memastikan apakah layanan MCP dapat dijangkau. Jika dapat dijangkau, beri tahu saya kemampuan apa saja yang didukung.

Jika AI dapat memanggil BigSeller MCP dan menampilkan kemampuan yang didukung, berarti MCP telah berhasil terhubung.

5. Contoh Penggunaan BigSeller MCP

Tugas Terjadwal untuk Pengambilan dan Analisis Data

Jika Anda perlu mengambil data BigSeller secara berkala sesuai jadwal, Anda dapat meminta AI seperti berikut:

Prompt Tugas Terjadwal

Saya ingin memanggil BigSeller MCP setiap hari pada pukul 09.00 untuk mengambil data xxx, menganalisis dan merangkumnya, lalu mengirimkan laporan analisis ke grup xxx setelah selesai. Bagaimana cara menerapkannya? Tolong buatkan rencananya.

Untuk contoh penerapan lengkap, silakan lihat Panduan Skenario Penggunaan MCP.

6. Catatan Penting

• Jaga keamanan APP ID dan APP KEY Anda. Jangan membagikannya kepada orang lain.

• Jika API mengembalikan code: 10100002 dan message: Too many request, berarti API dipanggil terlalu sering. Silakan tunggu 30 detik, kemudian coba lagi.

• Sebagian besar waktu yang dikembalikan oleh API BigSeller menggunakan UTC. Agar data yang diperoleh konsisten dengan data yang Anda lihat di aplikasi BigSeller, beri tahu AI mengenai pasar penjualan (sales market) akun BigSeller Anda. Kemudian minta AI untuk mengonversi waktu yang Anda tanyakan dari zona waktu pasar penjualan tersebut ke UTC sebelum melakukan query.