Postiz MCP

resmi

Streamline media sosial Anda dengan Postiz. Jadwalkan unggahan, analisis performa, dan kelola semua akun dalam satu tempat.

Lihat di postiz.pro

Apa yang bisa Anda lakukan dengan Postiz MCP?

List connected social accounts — Ask the agent to retrieve all your linked platforms with integrationList, optionally filtered by customer group.
Check platform posting rules — Use integrationSchema to get character limits, supported media types, and settings for a specific platform before posting.
Schedule or publish posts — Create, draft, or immediately publish social media posts via schedulePostTool with platform-specific formatting.
Generate AI images for posts — Produce images directly through generateImageTool to attach to scheduled content.
Generate videos for posts — Explore available video options with generateVideoOptions and videoFunctionTool, then create videos using generateVideoTool.

Dokumentasi

Pengantar

Hubungkan agen AI ke Postiz menggunakan Model Context Protocol (MCP)

MCP (Model Context Protocol) memungkinkan agen AI berinteraksi langsung dengan Postiz — mendaftar integrasi, menjadwalkan postingan, menghasilkan gambar dan video — semuanya melalui antarmuka pemanggilan alat yang terstandarisasi.

Ini berarti Anda dapat menghubungkan Claude, ChatGPT, Cursor, atau klien apa pun yang kompatibel dengan MCP ke akun Postiz Anda dan mengelola media sosial Anda melalui bahasa alami.

Cara Kerja

Postiz mengekspos server MCP yang menyediakan 9 alat untuk agen AI. Agen menemukan alat-alat ini, memahami skemanya, dan 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`	Daftar semua akun media sosial yang terhubung (opsional difilter berdasarkan grup)
`groupList`	Daftar semua grup (pelanggan) untuk organisasi Anda
`integrationSchema`	Dapatkan aturan posting spesifik platform dan skema pengaturan
`triggerTool`	Jalankan pembantu spesifik platform (mis., daftar saluran Discord)
`schedulePostTool`	Jadwalkan, buat draf, atau segera publikasikan postingan
`generateImageTool`	Hasilkan gambar AI untuk postingan
`generateVideoOptions`	Daftar opsi pembuatan video yang tersedia
`videoFunctionTool`	Dapatkan pengaturan pembuat video (mis., suara yang tersedia)
`generateVideoTool`	Hasilkan video untuk postingan

Autentikasi

Ada dua cara untuk mengautentikasi dengan server MCP:

Kunci API

Dapatkan kunci API Anda dari Pengaturan > Pengembang > API Publik di Postiz. Gunakan langsung di URL endpoint MCP atau sebagai token Bearer.

Token OAuth

Jika Anda membangun aplikasi untuk pengguna Postiz lain, gunakan OAuth2 untuk mendapatkan token. Token OAuth dimulai dengan pos_ dan bekerja dengan cara yang sama seperti kunci API.

Menghubungkan

Gunakan endpoint `/mcp` dengan kunci API atau token OAuth Anda sebagai token Bearer:

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

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

Gunakan endpoint `/mcp/:apiKey` dengan kunci API Anda disematkan di URL:

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

Untuk instance self-hosted, ganti `https://api.postiz.com` dengan `NEXT_PUBLIC_BACKEND_URL` Anda.

Contoh Singkat

Berikut adalah gambaran interaksi tipikal ketika agen AI menggunakan Postiz MCP:

Agen memanggil integrationList — mendapatkan kembali akun Anda yang terhubung (X, LinkedIn, dll.)
Agen memanggil integrationSchema dengan platform: "x" — mempelajari batas karakter, pengaturan, dan aturan X
Agen memanggil schedulePostTool — menjadwalkan postingan Anda dengan format yang benar

Semua ini terjadi secara otomatis ketika Anda memberi tahu agen AI Anda sesuatu seperti:

"Jadwalkan postingan ke X untuk besok jam 10 pagi: Sangat senang mengumumkan fitur baru kami!"

FAQ

Apakah saya memerlukan kunci OpenAI untuk menggunakan Postiz MCP?

Tidak. Server MCP hanya mengekspos alat-alat Postiz — klien AI Anda (Claude, ChatGPT, Cursor, dll.) yang menyediakan modelnya. Postiz hanya memerlukan OPENAI_API_KEY jika Anda menggunakan fitur AI milik Postiz sendiri (pembuatan gambar, kopilot) yang terpisah dari alat MCP yang disajikan ke klien Anda.

Apa yang terjadi ketika kunci API saya kedaluwarsa atau dirotasi?

Kunci API Postiz tidak berotasi otomatis, tetapi jika Anda membuat ulang di Pengaturan → Pengembang → API Publik, setiap klien MCP yang menggunakan kunci lama akan berhenti bekerja hingga Anda memperbarui konfigurasinya. Perbarui URL atau header Authorization di konfigurasi klien Anda dan sambungkan kembali.

Self-hosted: bagaimana cara mengekspos endpoint MCP?

Server MCP dimulai sebagai bagian dari backend Postiz dan dapat dijangkau di /mcp (auth Bearer), /mcp/:apiKey (kunci di URL), dan /mcp-oauth (dilindungi OAuth). Proksi balik Anda harus meneruskan jalur ini ke backend dan mendukung streaming HTTP (Transfer-Encoding: chunked). Lihat Proksi Balik.

Bisakah MCP membaca atau membalas komentar?

Saat ini belum. Set alat saat ini bersifat baca-saja pada integrasi dan tulis-saja pada postingan/media — tidak ada getComments atau replyToComment yang diekspos melalui MCP. Balasan komentar harus dipicu melalui UI Postiz.