Postiz MCP

offiziell

Optimieren Sie Ihre Social-Media-Arbeit mit Postiz. Planen Sie Beiträge, analysieren Sie die Leistung und verwalten Sie alle Konten an einem Ort

Auf postiz.pro ansehen

Was kann man mit Postiz MCP machen?

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.

Dokumentation

Einführung

KI-Agenten über das Model Context Protocol (MCP) mit Postiz verbinden

MCP (Model Context Protocol) ermöglicht es KI-Agenten, direkt mit Postiz zu interagieren – Integrationen auflisten, Beiträge planen, Bilder und Videos generieren – alles über eine standardisierte Tool-Calling-Schnittstelle.

Das bedeutet, Sie können Claude, ChatGPT, Cursor oder jeden MCP-kompatiblen Client mit Ihrem Postiz-Konto verbinden und Ihre sozialen Medien in natürlicher Sprache verwalten.

So funktioniert's

Postiz stellt einen MCP-Server bereit, der KI-Agenten 9 Tools zur Verfügung stellt. Der Agent entdeckt diese Tools, versteht ihre Schemas und ruft sie in Ihrem Auftrag auf.

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

Verfügbare Tools

Tool	Beschreibung
`integrationList`	Alle verbundenen Social-Media-Konten auflisten (optional nach Gruppe gefiltert)
`groupList`	Alle Gruppen (Kunden) für Ihre Organisation auflisten
`integrationSchema`	Plattformspezifische Beitragsregeln und Einstellungsschema abrufen
`triggerTool`	Plattformspezifische Hilfsfunktionen ausführen (z. B. Discord-Kanäle auflisten)
`schedulePostTool`	Beiträge planen, als Entwurf speichern oder sofort veröffentlichen
`generateImageTool`	KI-Bilder für Beiträge generieren
`generateVideoOptions`	Verfügbare Videogenerierungsoptionen auflisten
`videoFunctionTool`	Einstellungen des Videogenerators abrufen (z. B. verfügbare Stimmen)
`generateVideoTool`	Videos für Beiträge generieren

Authentifizierung

Es gibt zwei Möglichkeiten, sich beim MCP-Server zu authentifizieren:

API-Schlüssel

Holen Sie sich Ihren API-Schlüssel unter Einstellungen > Entwickler > Öffentliche API in Postiz. Verwenden Sie ihn direkt in der MCP-Endpunkt-URL oder als Bearer-Token.

OAuth-Token

Wenn Sie eine App für andere Postiz-Nutzer entwickeln, verwenden Sie OAuth2, um Tokens zu erhalten. OAuth-Tokens beginnen mit pos_ und funktionieren genauso wie API-Schlüssel.

Verbinden

Verwenden Sie den `/mcp`-Endpunkt mit Ihrem API-Schlüssel oder OAuth-Token als Bearer-Token:

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

Diese Methode unterstützt sowohl API-Schlüssel als auch OAuth-Tokens (mit dem Präfix `pos_`).

Verwenden Sie den `/mcp/:apiKey`-Endpunkt mit Ihrem in der URL eingebetteten API-Schlüssel:

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

Ersetzen Sie bei selbst gehosteten Instanzen `https://api.postiz.com` durch Ihre `NEXT_PUBLIC_BACKEND_URL`.

Kurzbeispiel

So sieht eine typische Interaktion aus, wenn ein KI-Agent Postiz MCP verwendet:

Agent ruft integrationList auf – erhält Ihre verbundenen Konten (X, LinkedIn usw.)
Agent ruft integrationSchema mit platform: "x" auf – erfährt die Zeichenbegrenzungen, Einstellungen und Regeln von X
Agent ruft schedulePostTool auf – plant Ihren Beitrag im korrekten Format

All dies geschieht automatisch, wenn Sie Ihrem KI-Agenten etwas sagen wie:

„Plane einen Beitrag auf X für morgen um 10 Uhr: Freue mich, unser neues Feature anzukündigen!“

FAQ

Benötige ich einen OpenAI-Schlüssel, um Postiz MCP zu nutzen?

Nein. Der MCP-Server stellt lediglich die Tools von Postiz bereit – Ihr KI-Client (Claude, ChatGPT, Cursor usw.) stellt das Modell. Postiz benötigt nur einen OPENAI_API_KEY, wenn Sie die eigenen KI-Funktionen von Postiz nutzen (Bildgenerierung, Copilot), die von den MCP-Tools, die Ihrem Client bereitgestellt werden, getrennt sind.

Was passiert, wenn mein API-Schlüssel abläuft oder rotiert wird?

Postiz-API-Schlüssel rotieren nicht automatisch, aber wenn Sie einen unter Einstellungen → Entwickler → Öffentliche API neu generieren, funktioniert jeder MCP-Client, der den alten Schlüssel verwendet, nicht mehr, bis Sie seine Konfiguration aktualisieren. Aktualisieren Sie die URL oder den Authorization-Header in Ihrer Client-Konfiguration und stellen Sie die Verbindung wieder her.

Selbst gehostet: Wie stelle ich den MCP-Endpunkt bereit?

Der MCP-Server startet als Teil des Postiz-Backends und ist unter /mcp (Bearer-Auth), /mcp/:apiKey (Schlüssel in URL) und /mcp-oauth (OAuth-geschützt) erreichbar. Ihr Reverse-Proxy muss diese Pfade an das Backend weiterleiten und Streaming-HTTP (Transfer-Encoding: chunked) unterstützen. Siehe Reverse-Proxys.

Kann MCP Kommentare lesen oder beantworten?

Derzeit nicht. Der aktuelle Tool-Satz ist lesend bei Integrationen und schreibend bei Beiträgen/Medien – es gibt kein getComments oder replyToComment, das über MCP bereitgestellt wird. Kommentarantworten müssen über die Postiz-Benutzeroberfläche ausgelöst werden.