Server MCP

Apa itu server MCP SocialGO?

Server MCP SocialGO membuka panel sebagai sekumpulan tool untuk agen AI melalui Model Context Protocol. Setelah terhubung, asisten dapat menjelajahi katalog layanan, membuat dan melacak pesanan, meminta refill, dan mengelola saldo. Tanpa kode perekat khusus. Ini adalah lapisan tipis baca-dan-aksi di atas API yang sama dengan yang digunakan dasbor Anda, sehingga agen tetap berada dalam batasan dan harga akun Anda.

Ini bekerja dengan klien apa pun yang mendukung MCP, termasuk Claude Desktop, Claude Code, Cursor, dan agen Anda sendiri yang dibangun di atas MCP SDK.

Tambahkan ke klien Anda

Server ini dikirimkan sebagai paket @socialgo/mcp dan berjalan melalui stdio via npx, jadi tidak ada yang perlu dipasang atau di-host sendiri. Tambahkan entri berikut ke konfigurasi klien MCP Anda:

{
  "mcpServers": {
    "socialgo": {
      "command": "npx",
      "args": ["-y", "@socialgo/mcp"],
      "env": {
        "SOCIALGO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Dengan Claude Code, Anda dapat mendaftarkannya dalam satu perintah dari terminal Anda:

claude mcp add socialgo -- npx @socialgo/mcp

Setelah menambahkannya, jangan lupa mengatur SOCIALGO_API_KEY di lingkungan agar perintah di atas dapat mengambilnya.

Autentikasi

Server membaca satu variabel lingkungan, SOCIALGO_API_KEY. Buat key dari pengaturan akun Anda, rahasiakan, dan jangan pernah commit ke kontrol sumber. Setiap panggilan tool diautentikasi dan diotorisasi dengan key ini, dan pesanan ditagihkan ke saldo akun yang sesuai. Rotasi key dari dasbor Anda kapan saja untuk mencabut akses.

Tool inti

Server menjaga permukaan tool yang kecil dan stabil yang mencakup seluruh siklus hidup pesanan:

• search_services — Temukan layanan berdasarkan platform, jenis, atau kata kunci. Titik masuk untuk setiap alur kerja.
• get_service — Ambil detail lengkap untuk satu layanan: tarif, kuantitas min/maks, dan opsi yang didukung.
• create_order — Buat pesanan untuk sebuah layanan terhadap link atau nama pengguna target.
• order_status — Cek status langsung, progres, dan kuantitas tersisa dari sebuah pesanan.
• balance — Baca saldo akun dan mata uang terkini.
• refill — Minta refill pada pesanan yang memenuhi syarat yang turun di bawah jumlah yang telah dikirim.
• cancel — Batalkan pesanan yang masih dapat dibatalkan dan pulihkan dana yang tersisa.
• list_orders — Telusuri halaman demi halaman pesanan terbaru beserta status terkininya.
• add_funds — Buat intent isi ulang untuk menambah saldo ke akun.

Desain "cari-lalu-aksi"

Panel SMM pada umumnya memuat ribuan layanan di puluhan platform. Mendaftarkan satu tool per layanan akan membanjiri daftar tool agen, membengkakkan jendela konteks, dan membuat model lebih lambat serta kurang akurat. SocialGO sepenuhnya menghindari hal ini.

Sebagai gantinya, katalog berada di balik satu tool penemuan. Agen pertama-tama memanggil search_services untuk mempersempit ribuan opsi menjadi segelintir hasil yang relevan, memeriksa salah satunya dengan get_service, lalu baru bertindak dengan create_order. Sembilan tool yang sama mencakup seluruh katalog tidak peduli seberapa besar pertumbuhannya. Menambahkan layanan baru di backend tidak pernah mengubah permukaan tool yang dilihat agen.

Alur lengkapnya tampak seperti ini:

1. search_services({ query: "instagram followers" })
   → returns a short list of matching services with ids + rates

2. get_service({ id: "<id>" })
   → confirms rate, min/max and options before spending

3. create_order({ id: "<id>", link: "<target>", quantity: 1000 })
   → returns an order id

4. order_status({ id: "<order_id>" })
   → poll until completed

Ini menjaga daftar tool tetap kecil dan dapat diprediksi, memungkinkan katalog berkembang hingga ribuan layanan, dan memberi agen langkah konfirmasi-sebelum-membelanjakan yang andal setiap saat.