Agen AI (MCP)

PostClaw menjalankan server Model Context Protocol jarak jauh. Hubungkan asisten AI ke server ini dan minta dengan bahasa biasa, “tulis tiga postingan untuk minggu depan dan jadwalkan di Halaman Facebook saya”. Asisten akan memeriksa kanal Anda, menyusun draf, dan memasukkannya ke kalender, atas nama Anda.

Tersedia di semua paket, termasuk Free. Batas paket Anda berlaku sama seperti di aplikasi.

Yang Anda perlukan

Akun PostClaw dengan setidaknya satu kanal terhubung.
Klien MCP yang dapat mengirim header Authorization lewat Streamable HTTP: Claude Code, Cursor, VS Code, dan sebagian besar klien MCP lainnya.
Token dari Pengaturan → Agen AI.

Claude.ai dan ChatGPT di browser belum didukung. Keduanya memerlukan login OAuth, yang sedang direncanakan.

Terhubung dalam dua menit

Buka Pengaturan → Agen AI lalu klik Token baru.
Beri nama yang mudah dikenali (misalnya “Cursor di laptop”) dan pilih izinnya.
Salin token. Token hanya ditampilkan sekali. Jika hilang, cabut lalu buat token baru.
Tambahkan server ke klien Anda. Halaman pengaturan menampilkan cuplikan berikut dengan token Anda sudah terisi.

URL server: https://app.postclaw.fun/mcp

Claude Code

claude mcp add --transport http postclaw https://app.postclaw.fun/mcp --header "Authorization: Bearer YOUR_TOKEN"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "postclaw": {
      "url": "https://app.postclaw.fun/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "postclaw": {
      "type": "http",
      "url": "https://app.postclaw.fun/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Lalu tanyakan kepada asisten sesuatu seperti “Kanal apa saja yang saya punya di PostClaw?” untuk memeriksa koneksi.

Izin

Setiap token punya izin sendiri. Asisten hanya melihat tool yang diizinkan tokennya.

Izin	Yang bisa dilakukan asisten
Baca (selalu aktif)	Melihat kanal, postingan, media, dan analitik, serta mendapat saran waktu posting
Tulis	Membuat dan mengedit draf, mengunggah media, menulis postingan dengan AI, membuat gambar AI
Terbitkan (nonaktif secara default)	Menjadwalkan, menerbitkan, membatalkan jadwal, dan menghapus postingan di akun asli Anda

Tanpa Terbitkan, asisten hanya bisa meninggalkan draf untuk Anda tinjau dan setujui di PostClaw. Aktifkan hanya untuk asisten yang Anda percaya untuk memposting atas nama Anda.

Anda dapat memiliki hingga 10 token aktif. Pencabutan token berlaku pada permintaan asisten berikutnya.

Tool

Tool	Izin	Fungsi
`list_channels`	Baca	Akun dan halaman terhubung yang bisa Anda gunakan untuk memposting
`list_posts`, `get_post`	Baca	Draf, postingan terjadwal dan terbit, dengan tautan dan error
`get_analytics`	Baca	Total, rincian per platform, waktu terbaik, postingan teratas
`suggest_posting_times`	Baca	Slot waktu yang baik per platform
`list_media`	Baca	Media yang baru diunggah
`generate_post`	Tulis	Teks postingan dari brief, opsional dengan brand voice Anda
`adapt_post`	Tulis	Satu konten ditulis ulang untuk setiap platform
`create_image`	Tulis	Gambar AI untuk postingan Anda
`upload_media`, `add_media_to_post`	Tulis	Melampirkan gambar dan video Anda sendiri
`create_post`, `update_post`	Tulis	Membuat dan mengedit draf; mengisi waktu akan menjadwalkan postingan (perlu Terbitkan)
`publish_post`	Terbitkan	Terbitkan sekarang dan kembalikan tautan postingan di tiap platform
`unschedule_post`	Terbitkan	Mengembalikan postingan terjadwal menjadi draf
`delete_post`	Terbitkan	Menghapus postingan dari PostClaw

Media harus berupa URL https:// atau file yang dikirim lewat upload_media.

create_post dan publish_post menerima idempotency_key opsional. Jika asisten mengulang panggilan dengan kunci yang sama dalam 24 jam, PostClaw mengembalikan hasil pertama alih-alih membuat atau menerbitkan dua kali.

Batas dan kredit

Asisten bekerja dengan paket yang sama seperti Anda di aplikasi:

Postingan per bulan, kredit AI, dan kuota gambar dihitung sama, baik di PostClaw maupun lewat asisten.
Tool AI memakai kunci AI Anda sendiri jika sudah terhubung di pengaturan.
Setiap token dapat mengirim hingga 60 permintaan per menit.
Setiap panggilan dicatat di akun Anda.

Pemecahan masalah

Yang Anda lihat	Penyebab	Yang harus dilakukan
`401` / “invalid token”	Token salah atau sudah dicabut	Buat token baru dan perbarui klien Anda
`429`	Lebih dari 60 permintaan per menit dari satu token	Tunggu beberapa detik; respons menyebutkan berapa lama
Ada tool yang tidak muncul	Token tidak punya izin untuk tool itu	Buat token dengan izin tersebut
`scope_missing`	Menjadwalkan atau menerbitkan tanpa izin Terbitkan	Aktifkan Terbitkan di token baru, atau jadwalkan dari aplikasi
`quota_exceeded`, `credit_cap_exceeded`	Batas bulanan paket Anda sudah habis	Tunggu periode berikutnya atau tingkatkan paket
”your … configuration failed”	Kunci AI Anda sendiri mengembalikan error (kuota, tagihan, login kedaluwarsa)	Perbaiki atau hapus kunci di Pengaturan → Providers

Jaga keamanan token

Token bertindak sebagai Anda. Perlakukan seperti kata sandi:

Jangan commit ke repositori atau tempel di obrolan bersama.
Gunakan satu token per perangkat atau tool, agar Anda bisa mencabut satu tanpa mengganggu yang lain.
Cabut token yang tidak lagi dipakai di Pengaturan → Agen AI.