API dan MCP: hubungkan Posto ke aplikasi lain

Dengan API dan MCP kamu bisa membuat carousel dari n8n, Zapier, sistem agency, atau asisten AI seperti Claude dan Cursor, tanpa membuka Posto.

Siapa yang bisa memakai?

• Paket Agency, atau paket Starter, Pro, dan Ultimate dengan add-on API & MCP. Lihat Cara upgrade paket.
• Hanya pemilik atau admin workspace yang bisa mengelola API key, dan email harus sudah terverifikasi.
• Fitur ini dibuka bertahap. Bila halaman menampilkan API & MCP segera hadir, akunmu belum termasuk.

Membuat API key

1. Buka Brand & akun medsos → API & MCP (/app/settings/api), lalu klik Buat API key.
2. Isi Nama key (mis. "n8n produksi") dan pilih Izin seperlunya: Baca (lihat carousel, jadwal, saldo Credit AI), Buat konten (memakai Credit AI), dan Jadwal (jadwal posting dan webhook).
3. Klik Buat key, lalu Salin key dan simpan di tempat aman. Key hanya tampil sekali; setelah Sudah saya simpan, key tidak bisa dilihat lagi.

Key bocor atau tidak dipakai? Klik Cabut: program yang memakainya langsung kehilangan akses. Maksimal 20 key aktif per workspace. Setiap panggilan tercatat di Riwayat panggilan (isi permintaan tidak disimpan).

Memanggil API

Base URL: https://posto.id/api/v1. Kirim key di header Authorization: Bearer <key>. Header Idempotency-Key wajib untuk POST /carousels, POST /carousels/{id}/images, dan POST /batches: permintaan yang diulang dengan key yang sama tidak membuat konten atau memotong Credit AI dua kali.

curl -X POST https://posto.id/api/v1/carousels \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Idempotency-Key: blog-1203" \
  -H "Content-Type: application/json" \
  -d '{"source":{"type":"link","value":"https://contoh.id/blog/1203"},"slides":5,"ratio":"4:5","lang":"id","images":true}'

Respons 202 berisi id carousel berstatus queued. Cek dengan GET /api/v1/carousels/{id} sampai ready, atau pasang webhook carousel.ready.

• Batas per key: 60 permintaan per menit dan 10 pembuatan konten bersamaan. Lewat batas → 429 dengan header Retry-After.
• Credit AI sama dengan di aplikasi: tarif per aksi AI diatur Posto (bawaan 1 Credit AI per slide, gambar AI Standar 10, High 30), dipotong sebelum AI berjalan dan dikembalikan bila gagal. Posting, jadwal, dan ekspor tidak memakai Credit AI. Lihat Cara kerja Credit AI.
• Semua endpoint beserta contoh cURL, Node, dan n8n ada di Dokumentasi API.
• Video Reels dan jadwal berulang juga bisa dibuat lewat API dan MCP. Lihat Reels dan jadwal berulang lewat API & MCP.

Menghubungkan asisten AI (MCP)

Server MCP Posto ada di https://posto.id/mcp dan memakai API key yang sama.

1. Di Brand & akun medsos → API & MCP, bagian Hubungkan ke asisten AI (MCP), pilih tab Claude Desktop, Cursor, Claude Code, atau Aplikasi lain.
2. Klik Salin. Bila key baru saja dibuat, konfigurasi sudah berisi key-mu; bila belum, ganti pk_live_XXXXXXXXXXXXXXXX dengan key-mu.
3. Claude Desktop: tempel di claude_desktop_config.json, lalu mulai ulang Claude Desktop. Cursor: tempel di .cursor/mcp.json di folder proyekmu. Claude Code: jalankan perintahnya di terminal.

Konfigurasi Claude Desktop dan Cursor:

{
  "mcpServers": {
    "posto": {
      "type": "streamable-http",
      "url": "https://posto.id/mcp",
      "headers": {
        "Authorization": "Bearer pk_live_XXXXXXXXXXXXXXXX"
      }
    }
  }
}

Tab Aplikasi lain untuk aplikasi yang belum mendukung Streamable HTTP (butuh Node.js):

{
  "mcpServers": {
    "posto": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://posto.id/mcp",
        "--header",
        "Authorization:${POSTO_AUTH_HEADER}"
      ],
      "env": {
        "POSTO_AUTH_HEADER": "Bearer pk_live_XXXXXXXXXXXXXXXX"
      }
    }
  }
}

Aturan saat memakai MCP:

• Aksi yang memakai Credit AI meminta persetujuanmu dulu: carousel di atas 5 Credit AI, gambar AI (bawaan Standar 10, High 30 Credit AI), dan menjalankan batch. Asisten menampilkan jumlah Credit AI sebelum lanjut. Aksi teks AI (mis. tulis ulang slide) juga memakai Credit AI.
• Bila Credit AI tidak cukup untuk slide sekaligus foto AI, carousel dibuat tanpa foto AI (tetap rapi), kecuali asisten meminta foto secara eksplisit; permintaan itu ditolak dengan pesan Credit AI kurang.
• Satu sesi MCP saat ini dibatasi 500 Credit AI per jam (ditetapkan Posto, terpisah dari batas harian workspace). Bila tercapai, tunggu jam berikutnya.

Masih bingung? Hubungi [email protected].