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

Was kann man mit Postiz MCP machen?

  • Verbundene Konten auflisten — Bitte den Agenten, deine verbundenen Social-Media-Konten aufzulisten, optional nach Gruppe gefiltert.
  • Plattformregeln prüfen — Plattformbezogene Veröffentlichungsregeln und das Einstellungsschema abrufen, bevor du einen Beitrag entwirfst.
  • Beiträge planen oder veröffentlichen — Einen Beitrag für ein verbundenes Konto planen, als Entwurf speichern oder sofort veröffentlichen.
  • Geplante Beiträge prüfen — Die Beiträge deiner Organisation auflisten, die zwischen zwei Datumsangaben geplant sind, einschließlich ihrer aktuellen Einstellungen.
  • Medien generieren — KI-Bilder oder -Videos für Beiträge generieren und verfügbare Optionen zur Videogenerierung auflisten.
  • Lange Videos schneiden — Ein langes YouTube-Video in vertikale Clips mit Untertiteln und Beitragsentwürfen umwandeln und anschließend den Schnittstatus prüfen.

Dokumentation

Einführung

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

MCP (Model Context Protocol) ermöglicht KI-Agenten die direkte Interaktion mit Postiz: Sie können Integrationen auflisten, Beiträge planen, Bilder und Videos generieren und lange Videos in Kurzclips umwandeln – alles über eine standardisierte Schnittstelle für Tool-Aufrufe.

So kannst du Claude, ChatGPT, Cursor oder einen anderen MCP-kompatiblen Client mit deinem Postiz-Konto verbinden und deine sozialen Medien in natürlicher Sprache verwalten.

Funktionsweise

Postiz stellt einen MCP-Server bereit, der KI-Agenten 13 Tools zur Verfügung stellt. Der Agent erkennt diese Tools, versteht ihre Schemas und ruft sie in deinem 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

ToolBeschreibung
integrationListAlle verbundenen Social-Media-Konten auflisten (optional nach Gruppe gefiltert)
groupListAlle Gruppen (Kunden) deiner Organisation auflisten
integrationConnectToolEinen Link zum Verbinden eines neuen Social-Media-Kontos abrufen
integrationSchemaPlattformspezifische Veröffentlichungsregeln und das Einstellungsschema abrufen
triggerToolPlattformspezifische Hilfsfunktionen ausführen (z. B. Discord-Kanäle auflisten)
schedulePostToolBeiträge planen, als Entwurf speichern oder sofort veröffentlichen
postsListToolDie zwischen zwei Datumsangaben geplanten Beiträge der Organisation auflisten (mit ihren aktuellen Einstellungen)
postSettingsToolDie Anbietereinstellungen eines geplanten Beitrags oder eines noch nicht veröffentlichten Entwurfs aktualisieren
generateImageToolKI-Bilder für Beiträge generieren
generateVideoOptionsVerfügbare Optionen zur Videogenerierung auflisten
videoFunctionToolEinstellungen des Videogenerators abrufen (z. B. verfügbare Stimmen)
generateVideoToolVideos für Beiträge generieren
clippingToolEin langes YouTube-Video in vertikale Clips mit Untertiteln umwandeln und Beitragsentwürfe erstellen
clippingStatusToolEinen Clip-Vorgang überprüfen und die fertigen Clips abrufen

Authentifizierung

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

API-Schlüssel

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

OAuth-Token

Wenn du eine App für andere Postiz-Nutzer entwickelst, verwende OAuth2, um Tokens abzurufen. OAuth-Tokens beginnen mit pos_ und funktionieren genauso wie API-Schlüssel.

Verbindung herstellen

[tab] Bearer-Token

Verwende den Endpunkt /mcp mit deinem API-Schlüssel oder OAuth-Token als Bearer-Token:

URL: https://mcp.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_).

[tab] API-Schlüssel in der URL

Verwende den Endpunkt /mcp/:apiKey mit deinem in die URL eingebetteten API-Schlüssel:

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

Schnellstart-Beispiel

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

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

All das geschieht automatisch, wenn du deinem KI-Agenten beispielsweise Folgendes sagst:

„Plane für morgen um 10 Uhr einen Beitrag auf X: 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. Dein KI-Client (Claude, ChatGPT, Cursor usw.) stellt das Modell bereit. Postiz benötigt nur dann einen OPENAI_API_KEY, wenn du die integrierten KI-Funktionen von Postiz verwendest (Bildgenerierung, Copilot). Diese sind von den MCP-Tools getrennt, die deinem Client zur Verfügung gestellt werden.

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

Postiz-API-Schlüssel werden nicht automatisch erneuert. Wenn du jedoch unter Settings → Developers → Public API einen neuen Schlüssel generierst, funktionieren alle MCP-Clients, die den alten Schlüssel verwenden, erst wieder, wenn du ihre Konfiguration aktualisierst. Aktualisiere die URL oder den Header Authorization in deiner Client-Konfiguration und stelle die Verbindung erneut her.

Self-hosted: Wie mache ich den MCP-Endpunkt verfügbar?

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

Kann MCP Kommentare lesen oder beantworten?

Derzeit nicht. Die aktuellen Tools bieten für Integrationen nur Lesezugriff und für Beiträge und Medien nur Schreibzugriff. Über MCP werden weder getComments noch replyToComment bereitgestellt. Antworten auf Kommentare müssen über die Postiz-Benutzeroberfläche ausgelöst werden.

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