MCP melalui npx (@postoid/mcp)

Pakej rasmi @postoid/mcp menyambungkan aplikasi AI yang hanya boleh menjalankan pelayan MCP setempat (stdio), contohnya Claude Desktop versi lama atau sesetengah IDE, kepada Posto. Pakej ini hanya meneruskan mesej ke pelayan MCP Posto, jadi alat yang tersedia sama seperti sambungan terus. Aplikasi anda sudah menyokong Streamable HTTP (Claude Desktop terkini, Cursor, Claude Code)? Anda tidak memerlukan pakej ini; gunakan konfigurasi dalam API dan MCP.

Sebelum bermula

1. Pasang Node.js 18 atau lebih baharu (npx turut dipasang). Semak dengan node -v di terminal.
2. Cipta kunci API dalam Jenama & akaun media sosial → API & MCP (/app/settings/api). Kunci API memerlukan pelan Agency atau tambahan API & MCP.

Semak sama ada pakej sudah tersedia

Dalam Jenama & akaun media sosial → API & MCP, bahagian Sambungkan pembantu AI (MCP), buka tab npx @postoid/mcp:

• Jika tab memaparkan konfigurasi dan butang Salin, pakej sudah diterbitkan. Ikuti langkah di bawah.
• Jika tertulis Tersedia selepas diterbitkan., pakej belum ada di npm dan arahan npx akan gagal. Buat masa ini gunakan tab Aplikasi lain seperti dalam panduan API dan MCP.

Memasang dalam Claude Desktop

1. Dalam Claude Desktop, buka Settings → Developer → Edit Config. Fail claude_desktop_config.json akan dibuka (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).
2. Dalam tab npx @postoid/mcp, klik Salin, kemudian tampal ke dalam fail itu. Jika fail sudah mengandungi pelayan lain, tambah blok "posto" di dalam mcpServers yang sedia ada. Gantikan pk_live_XXXXXXXXXXXXXXXX dengan kunci API anda jika belum diisi.
3. Simpan fail, tutup Claude Desktop sepenuhnya (bukan sekadar tetingkapnya), kemudian buka semula.
4. Cuba minta, contohnya: "Semak baki Kredit AI Posto saya."

Isi yang disalin daripada tab itu lebih kurang seperti ini:

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

Aplikasi lain yang menggunakan pelayan stdio (cth. Cursor dalam .cursor/mcp.json) menggunakan blok yang sama.

Tetapan tambahan (pilihan)

Tambah di dalam env pada konfigurasi jika perlu:

• POSTO_WORKSPACE_ID: untuk kunci agensi, id workspace klien sasaran (boleh dilihat melalui alat list_brands).
• POSTO_MCP_URL: alamat pelayan MCP, lalainya https://posto.id/mcp. Biarkan kecuali diminta oleh pasukan sokongan.
• POSTO_MCP_DEBUG: isi 1 untuk log ringkas di stderr, tanpa isi mesej dan tanpa kunci.

Masalah biasa

• "POSTO_API_KEY belum diisi" (POSTO_API_KEY is not set): POSTO_API_KEY dalam env masih kosong. Isi dengan kunci API anda, kemudian mulakan semula aplikasi.
• 401 atau "API key salah/dicabut": kunci tersalah taip atau sudah dibatalkan. Cipta kunci baharu, gantikan POSTO_API_KEY, kemudian mulakan semula aplikasi.
• Pelayan Posto tidak muncul atau npx gagal: pastikan Node.js versi 18 ke atas dan tab npx @postoid/mcp sudah memaparkan konfigurasi. Selepas memasang Node.js, tutup dan buka semula aplikasi AI anda.
• Sesi tamat selepas 30 minit tidak digunakan: pakej membuka sesi baharu secara automatik.
• Kredit AI dipotong sama seperti dalam aplikasi web (termasuk tindakan teks AI), dan tindakan yang menggunakan banyak Kredit AI (karusel besar, imej AI, kelompok) meminta kelulusan anda dahulu.

Masih keliru? Hubungi [email protected].