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, memotong video panjang menjadi konten pendek, 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 Kerjanya

Postiz mengekspos server MCP yang menyediakan 13 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 pembantu 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
clippingTool	Mengubah video YouTube panjang menjadi klip vertikal dengan teks dan draf posting
clippingStatusTool	Memeriksa pemotongan dan mendapatkan klip yang selesai

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 lainnya, 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:

```text theme={null}
URL: https://mcp.postiz.com/mcp
Authorization: Bearer your-api-key
```

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

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

```text theme={null}
URL: https://mcp.postiz.com/mcp/your-api-key
```

Contoh Singkat

Berikut adalah gambaran interaksi umum ketika 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 ketika 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 ketika 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 bekerja sampai 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 Proksi Terbalik.

Bisakah MCP membaca atau membalas komentar?

Belum saat ini. Set alat saat ini bersifat hanya-baca pada integrasi dan hanya-tulis pada posting/media. Tidak ada getComments atau replyToComment yang diekspos melalui MCP. Balasan komentar harus dipicu melalui antarmuka Postiz.

Dokumentasi ini dibangun dan dihosting di Mintlify, platform dokumentasi pengembang.