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 ansehenDieses MCP ausprobierenGesponsert

Was kann man mit Postiz MCP machen?

Mit Postiz MCP können Sie Ihren KI-Assistenten bitten, Social-Media-Beiträge zu verwalten und Medien direkt zu generieren.

Verbundene Konten auflisten — Fragen Sie nach allen verbundenen Social-Media-Konten über integrationList, optional nach Gruppe gefiltert.
Plattformregeln abrufen — Verwenden Sie integrationSchema, um Beitragsregeln und Einstellungen für eine Plattform wie X abzurufen.
Beiträge planen — Verwenden Sie schedulePostTool, um Beiträge zu planen, als Entwurf zu speichern oder sofort zu veröffentlichen.
Geplante Beiträge auflisten — Verwenden Sie postsListTool, um Beiträge anzuzeigen, die zwischen zwei Daten geplant sind.
Bilder generieren — Verwenden Sie generateImageTool, um KI-Bilder für Beiträge zu erstellen.
Videos generieren — Verwenden Sie generateVideoTool, um Videos zu erstellen, mit Optionen aus generateVideoOptions.

Dokumentation

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 – 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 11 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 Einstellungsschema 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 Anbieter-Einstellungen 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

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:

```
URL: https://api.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 in der URL eingebetteten API-Schlüssel:

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

Kurzbeispiel

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

Agent ruft integrationList auf und erhält Ihre verbundenen Konten (X, LinkedIn usw.)
Agent ruft integrationSchema mit platform: "x" auf und erfährt X' Zeichenlimits, Einstellungen und Regeln
Agent ruft schedulePostTool auf und plant Ihren Beitrag mit dem 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. Postiz benötigt nur einen OPENAI_API_KEY, wenn Sie die eigenen KI-Funktionen von Postiz (Bildgenerierung, Copilot) verwenden, 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, aber wenn Sie einen in Einstellungen → Entwickler → Öffentliche API neu generieren, funktionieren alle MCP-Clients mit dem alten Schlüssel 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 (Transfer-Encoding: chunked) unterstützen. Siehe Reverse-Proxys.

Kann MCP Kommentare lesen oder beantworten?

Derzeit nicht. Der aktuelle Tool-Satz ist schreibgeschützt für Integrationen und nur schreibend für Beiträge/Medien. Über MCP werden kein getComments oder replyToComment bereitgestellt. Kommentarantworten müssen über die Postiz-Benutzeroberfläche ausgelöst werden.