Postiz MCP

resmi

Streamline 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

AlatDeskripsi
integrationListMencantumkan semua akun media sosial yang terhubung (opsional difilter berdasarkan grup)
groupListMencantumkan semua grup (pelanggan) untuk organisasi Anda
integrationConnectToolMendapatkan tautan untuk menghubungkan akun media sosial baru
integrationSchemaMendapatkan aturan posting dan skema pengaturan khusus platform
triggerToolMenjalankan helper khusus platform (misalnya, mencantumkan kanal Discord)
schedulePostToolMenjadwalkan, menyimpan sebagai draf, atau langsung menerbitkan postingan
postsListToolMencantumkan postingan organisasi yang dijadwalkan di antara dua tanggal (beserta pengaturannya saat ini)
postSettingsToolMemperbarui pengaturan provider pada postingan terjadwal atau draf yang belum diterbitkan
generateImageToolMembuat gambar AI untuk postingan
generateVideoOptionsMencantumkan opsi pembuatan video yang tersedia
videoFunctionToolMendapatkan pengaturan generator video (misalnya, suara yang tersedia)
generateVideoToolMembuat video untuk postingan
clippingToolMengubah video YouTube panjang menjadi klip vertikal berteks dan draf postingan
clippingStatusToolMemeriksa 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 /mcp dengan kunci API atau token OAuth Anda sebagai token Bearer:

URL: https://mcp.postiz.com/mcp
Authorization: Bearer your-api-key

Metode ini mendukung kunci API dan token OAuth (diawali dengan pos_).

[tab] Kunci API di URL

Gunakan endpoint /mcp/:apiKey dengan 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:

  1. Agen memanggil integrationList, lalu mendapatkan akun Anda yang terhubung (X, LinkedIn, dll.)
  2. Agen memanggil integrationSchema dengan platform: "x" dan mempelajari batas karakter, pengaturan, serta aturan X
  3. 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.