Postiz MCP

Einführung

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

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

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

So funktioniert es

Postiz stellt einen MCP-Server bereit, der KI-Agenten 13 Tools zur Verfügung stellt. Der Agent entdeckt diese Tools, versteht ihre Schemata und ruft sie in Ihrem Namen 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 Veröffentlichungsregeln und Einstellungsschemata abrufen
triggerTool	Plattformspezifische Helfer ausführen (z. B. Discord-Kanäle auflisten)
schedulePostTool	Beiträge planen, als Entwurf speichern oder sofort veröffentlichen
postsListTool	Die zwischen zwei Daten geplanten Beiträge der Organisation auflisten (mit ihren aktuellen Einstellungen)
postSettingsTool	Die Anbietereinstellungen eines geplanten Beitrags oder Entwurfs aktualisieren, der noch nicht veröffentlicht wurde
generateImageTool	KI-Bilder für Beiträge generieren
generateVideoOptions	Verfügbare Videogenerierungsoptionen auflisten
videoFunctionTool	Videogenerator-Einstellungen abrufen (z. B. verfügbare Stimmen)
generateVideoTool	Videos für Beiträge generieren
clippingTool	Ein langes YouTube-Video in beschriftete vertikale Clips umwandeln und Beitragsentwürfe erstellen
clippingStatusTool	Einen Clipping-Vorgang prüfen und die fertigen Clips abrufen

Authentifizierung

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

API-Schlüssel

Verwenden Sie ihn direkt in der MCP-Endpunkt-URL oder als Bearer-Token.

OAuth-Token

Wenn Sie eine App für andere Postiz-Benutzer 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:

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

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

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

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

Kurzbeispiel

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

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

All dies geschieht automatisch, wenn Sie Ihrem KI-Agenten etwa Folgendes sagen:

„Plane einen Beitrag für X für morgen um 10 Uhr: Wir freuen uns, unser neues Feature anzukündigen!"

FAQ

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

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

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

Postiz-API-Schlüssel rotieren nicht automatisch. Wenn Sie jedoch einen in Einstellungen → Entwickler → Öffentliche API neu generieren, funktionieren alle MCP-Clients, die den alten Schlüssel verwenden, nicht mehr, bis Sie deren Konfiguration aktualisieren. Aktualisieren Sie die URL oder den Authorization-Header in Ihrer Client-Konfiguration und verbinden Sie sich erneut.

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

Der MCP-Server startet als Teil des Postiz-Backends und ist unter /mcp (Bearer-Authentifizierung), /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 unterstützen (Transfer-Encoding: chunked). Siehe Reverse-Proxys.

Kann MCP Kommentare lesen oder beantworten?

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

Diese Dokumentation wird auf Mintlify erstellt und gehostet, einer Plattform für Entwicklerdokumentation.