MCP lewat npx (@postoid/mcp)

Paket resmi @postoid/mcp menghubungkan aplikasi AI yang hanya bisa menjalankan server MCP lokal (stdio), misalnya Claude Desktop versi lama atau sebagian IDE, ke Posto. Paket ini hanya meneruskan pesan ke server MCP Posto, jadi tool yang tersedia sama dengan koneksi langsung. Aplikasimu sudah mendukung Streamable HTTP (Claude Desktop terbaru, Cursor, Claude Code)? Kamu tidak butuh paket ini; pakai konfigurasi di API dan MCP.

Sebelum mulai

1. Pasang Node.js 18 atau lebih baru (npx ikut terpasang). Cek dengan node -v di terminal.
2. Buat API key di Brand & akun medsos → API & MCP (/app/settings/api). API key butuh paket Agency atau add-on API & MCP.

Cek apakah paketnya sudah tersedia

Di Brand & akun medsos → API & MCP, bagian Hubungkan ke asisten AI (MCP), buka tab npx @postoid/mcp:

• Bila tab menampilkan konfigurasi dan tombol Salin, paket sudah terbit. Ikuti langkah di bawah.
• Bila tertulis Tersedia setelah dipublikasikan., paket belum ada di npm dan perintah npx akan gagal. Sementara itu pakai tab Aplikasi lain sesuai panduan API dan MCP.

Memasang di Claude Desktop

1. Di Claude Desktop, buka Settings → Developer → Edit Config. File claude_desktop_config.json terbuka (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).
2. Di tab npx @postoid/mcp, klik Salin, lalu tempel ke file itu. Bila file sudah berisi server lain, tambahkan blok "posto" di dalam mcpServers yang sudah ada. Ganti pk_live_XXXXXXXXXXXXXXXX dengan API key-mu bila belum terisi.
3. Simpan file, tutup Claude Desktop sepenuhnya (bukan hanya jendelanya), lalu buka lagi.
4. Coba minta, misalnya: "Cek saldo Credit AI Posto saya."

Isi yang disalin dari tab itu kurang lebih seperti ini:

{
  "mcpServers": {
    "posto": {
      "command": "npx",
      "args": ["-y", "@postoid/mcp"],
      "env": {
        "POSTO_API_KEY": "pk_live_XXXXXXXXXXXXXXXX"
      }
    }
  }
}

Aplikasi lain yang memakai server stdio (mis. Cursor di .cursor/mcp.json) memakai blok yang sama.

Pengaturan tambahan (opsional)

Tambahkan di dalam env pada konfigurasi bila perlu:

• POSTO_WORKSPACE_ID: untuk key agency, id workspace klien tujuan (bisa dilihat lewat tool list_brands).
• POSTO_MCP_URL: alamat server MCP, bawaannya https://posto.id/mcp. Biarkan kecuali diminta support.
• POSTO_MCP_DEBUG: isi 1 untuk log ringkas di stderr, tanpa isi pesan dan tanpa key.

Masalah umum

• "POSTO_API_KEY belum diisi": POSTO_API_KEY di env masih kosong. Isi dengan API key-mu, lalu mulai ulang aplikasi.
• 401 atau "API key salah/dicabut": key salah ketik atau sudah dicabut. Buat key baru, ganti POSTO_API_KEY, lalu mulai ulang aplikasi.
• Server Posto tidak muncul atau npx gagal: pastikan Node.js versi 18 ke atas dan tab npx @postoid/mcp sudah menampilkan konfigurasi. Setelah memasang Node.js, tutup dan buka lagi aplikasi AI-mu.
• Sesi berakhir setelah 30 menit tidak dipakai: paket membuka sesi baru otomatis.
• Credit AI dipotong sama seperti di aplikasi web (termasuk aksi teks AI), dan aksi yang memakai banyak Credit AI (carousel besar, gambar AI, batch) meminta persetujuanmu dulu.

Masih bingung? Hubungi [email protected].