Postiz MCP
resmiStreamline media sosial Anda dengan Postiz. Jadwalkan unggahan, analisis performa, dan kelola semua akun dalam satu tempat.
Apa yang bisa Anda lakukan dengan Postiz MCP?
- Daftar akun yang terhubung — Minta agen untuk mencantumkan akun media sosial Anda yang terhubung, dengan opsi filter berdasarkan grup.
- Periksa aturan platform — Dapatkan aturan posting dan skema pengaturan khusus platform sebelum menyusun postingan.
- Jadwalkan atau publikasikan postingan — Jadwalkan, simpan sebagai draf, atau langsung publikasikan postingan ke akun yang terhubung.
- Tinjau postingan terjadwal — Cantumkan postingan organisasi Anda yang dijadwalkan antara dua tanggal beserta pengaturannya saat ini.
- Buat media — Buat gambar atau video AI untuk postingan, dan cantumkan opsi pembuatan video yang tersedia.
- Potong video panjang — Ubah video YouTube berdurasi panjang menjadi klip vertikal berteks takarir dan draf postingan, lalu periksa status pemotongannya.
Dokumentasi
Pendahuluan
Hubungkan agen AI ke Postiz menggunakan Model Context Protocol (MCP)
MCP (Model Context Protocol) memungkinkan agen AI berinteraksi langsung dengan Postiz, mencantumkan integrasi, menjadwalkan postingan, membuat gambar dan video, serta memotong video panjang menjadi klip pendek, semuanya melalui antarmuka pemanggilan alat yang terstandarisasi.
Artinya, Anda dapat menghubungkan Claude, ChatGPT, Cursor, atau klien apa pun yang kompatibel dengan MCP ke akun Postiz Anda dan mengelola media sosial melalui bahasa alami.
Cara Kerjanya
Postiz menyediakan server MCP yang memberikan 13 alat kepada agen AI. Agen menemukan alat-alat ini, memahami skemanya, lalu memanggilnya atas nama Anda.
sequenceDiagram
participant Agent as AI Agent
participant MCP as Postiz MCP Server
participant Postiz as Postiz Backend
Agent->>MCP: Connect with API key / OAuth token
MCP-->>Agent: List available tools
Agent->>MCP: Call tool (e.g., schedule post)
MCP->>Postiz: Execute action
Postiz-->>MCP: Return result
MCP-->>Agent: Tool response
Alat yang Tersedia
| Alat | Deskripsi |
|---|---|
integrationList | Mencantumkan semua akun media sosial yang terhubung (opsional difilter berdasarkan grup) |
groupList | Mencantumkan semua grup (pelanggan) untuk organisasi Anda |
integrationConnectTool | Mendapatkan tautan untuk menghubungkan akun media sosial baru |
integrationSchema | Mendapatkan aturan posting dan skema pengaturan khusus platform |
triggerTool | Menjalankan helper khusus platform (misalnya, mencantumkan kanal Discord) |
schedulePostTool | Menjadwalkan, menyimpan sebagai draf, atau langsung menerbitkan postingan |
postsListTool | Mencantumkan postingan organisasi yang dijadwalkan di antara dua tanggal (beserta pengaturannya saat ini) |
postSettingsTool | Memperbarui pengaturan provider pada postingan terjadwal atau draf yang belum diterbitkan |
generateImageTool | Membuat gambar AI untuk postingan |
generateVideoOptions | Mencantumkan opsi pembuatan video yang tersedia |
videoFunctionTool | Mendapatkan pengaturan generator video (misalnya, suara yang tersedia) |
generateVideoTool | Membuat video untuk postingan |
clippingTool | Mengubah video YouTube panjang menjadi klip vertikal berteks dan draf postingan |
clippingStatusTool | Memeriksa proses pemotongan dan mendapatkan klip yang sudah selesai |
Autentikasi
Ada dua cara untuk melakukan autentikasi dengan server MCP:
Kunci API
Gunakan langsung di URL endpoint MCP, atau sebagai token Bearer.
Token OAuth
Jika Anda membuat aplikasi untuk pengguna Postiz lainnya, gunakan OAuth2 untuk mendapatkan token. Token OAuth diawali dengan pos_ dan berfungsi sama seperti kunci API.
Menghubungkan
[tab] Token Bearer
Gunakan endpoint
/mcpdengan kunci API atau token OAuth Anda sebagai token Bearer:URL: https://mcp.postiz.com/mcp Authorization: Bearer your-api-keyMetode ini mendukung kunci API dan token OAuth (diawali dengan
pos_).
[tab] Kunci API di URL
Gunakan endpoint
/mcp/:apiKeydengan kunci API yang disematkan di URL:URL: https://mcp.postiz.com/mcp/your-api-key
Contoh Singkat
Berikut gambaran interaksi umum saat agen AI menggunakan Postiz MCP:
- Agen memanggil
integrationList, lalu mendapatkan akun Anda yang terhubung (X, LinkedIn, dll.) - Agen memanggil
integrationSchemadenganplatform: "x"dan mempelajari batas karakter, pengaturan, serta aturan X - Agen memanggil
schedulePostTool, lalu menjadwalkan postingan Anda dengan format yang benar
Semua ini terjadi secara otomatis saat Anda memberi tahu agen AI Anda, misalnya:
"Jadwalkan postingan ke X untuk besok pukul 10.00: Senang sekali mengumumkan fitur baru kami!"
FAQ
Apakah saya memerlukan kunci OpenAI untuk menggunakan Postiz MCP?
Tidak. Server MCP hanya menyediakan alat Postiz. Klien AI Anda (Claude, ChatGPT, Cursor, dll.) menyediakan modelnya. Postiz hanya memerlukan OPENAI_API_KEY jika Anda menggunakan fitur AI bawaan Postiz (pembuatan gambar, copilot), yang terpisah dari alat MCP yang tersedia bagi klien Anda.
Apa yang terjadi saat kunci API saya kedaluwarsa atau dirotasi?
Kunci API Postiz tidak dirotasi secara otomatis, tetapi jika Anda membuat ulang kunci di Settings → Developers → Public API, setiap klien MCP yang menggunakan kunci lama akan berhenti berfungsi sampai Anda memperbarui konfigurasinya. Perbarui URL atau header Authorization di konfigurasi klien Anda, lalu hubungkan kembali.
Self-hosted: bagaimana cara mengekspos endpoint MCP?
Server MCP dimulai sebagai bagian dari backend Postiz dan dapat diakses di /mcp (autentikasi Bearer), /mcp/:apiKey (kunci di URL), dan /mcp-oauth (dilindungi OAuth). Reverse proxy Anda harus meneruskan jalur-jalur ini ke backend dan mendukung HTTP streaming (Transfer-Encoding: chunked). Lihat Reverse Proxies.
Dapatkah MCP membaca atau membalas komentar?
Belum. Kumpulan alat saat ini hanya dapat membaca integrasi dan hanya dapat menulis postingan/media. Tidak ada getComments atau replyToComment yang tersedia melalui MCP. Balasan komentar harus dilakukan melalui UI Postiz.
Dokumentasi ini dibuat dan dihosting di Mintlify, sebuah platform dokumentasi developer.