Postiz MCP

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 posting, menghasilkan gambar dan video, semuanya melalui antarmuka pemanggilan alat yang terstandarisasi.

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

Cara Kerjanya

Postiz mengekspos server MCP yang menyediakan 11 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	Mencantumkan semua akun media sosial yang terhubung (opsional difilter berdasarkan grup)
groupList	Mencantumkan semua grup (pelanggan) untuk organisasi Anda
integrationSchema	Mendapatkan aturan posting khusus platform dan skema pengaturan
triggerTool	Menjalankan helper khusus platform (misalnya, mencantumkan saluran Discord)
schedulePostTool	Menjadwalkan, membuat draf, atau langsung memublikasikan posting
postsListTool	Mencantumkan posting organisasi yang dijadwalkan antara dua tanggal (dengan pengaturan saat ini)
postSettingsTool	Memperbarui pengaturan penyedia dari posting terjadwal atau draf yang belum dipublikasikan
generateImageTool	Menghasilkan gambar AI untuk posting
generateVideoOptions	Mencantumkan opsi pembuatan video yang tersedia
videoFunctionTool	Mendapatkan pengaturan generator video (misalnya, suara yang tersedia)
generateVideoTool	Menghasilkan video untuk posting

Autentikasi

Ada dua cara untuk mengautentikasi dengan server MCP:

Kunci API

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 tertanam di URL:

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

Contoh Singkat

Berikut ini gambaran interaksi umum saat agen AI menggunakan Postiz MCP:

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

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

"Jadwalkan posting ke X untuk besok jam 10 pagi: Kami dengan bangga mengumumkan fitur baru kami!"

FAQ

Apakah saya perlu kunci OpenAI untuk menggunakan Postiz MCP?

Tidak. Server MCP hanya mengekspos alat Postiz. Klien AI Anda (Claude, ChatGPT, Cursor, dll.) yang menyediakan model. Postiz hanya memerlukan OPENAI_API_KEY jika Anda menggunakan fitur AI Postiz sendiri (pembuatan gambar, copilot) yang terpisah dari alat MCP yang ditampilkan ke klien Anda.

Apa yang terjadi jika kunci API saya kedaluwarsa atau diputar ulang?

Kunci API Postiz tidak berputar otomatis, tetapi jika Anda membuat ulang satu di Pengaturan → Pengembang → API Publik, setiap klien MCP yang menggunakan kunci lama akan berhenti berfungsi 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 diakses di /mcp (auth Bearer), /mcp/:apiKey (kunci di URL), dan /mcp-oauth (dilindungi OAuth). Proksi terbalik Anda harus meneruskan jalur ini ke backend dan mendukung streaming HTTP (Transfer-Encoding: chunked). Lihat Reverse Proxy.

Bisakah MCP membaca atau membalas komentar?

Belum bisa. Kumpulan alat saat ini bersifat read-only pada integrasi dan write-only pada posting/media. Tidak ada getComments atau replyToComment yang diekspos melalui MCP. Balasan komentar harus dipicu melalui UI Postiz.