Postiz MCP
offiziellOptimieren 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
| Tool | Beschreibung |
|---|---|
integrationList | Alle verbundenen Social-Media-Konten auflisten (optional nach Gruppe gefiltert) |
groupList | Alle Gruppen (Kunden) deiner Organisation auflisten |
integrationConnectTool | Einen Link zum Verbinden eines neuen Social-Media-Kontos abrufen |
integrationSchema | Plattformspezifische Veröffentlichungsregeln und das Einstellungsschema abrufen |
triggerTool | Plattformspezifische Hilfsfunktionen ausführen (z. B. Discord-Kanäle auflisten) |
schedulePostTool | Beiträge planen, als Entwurf speichern oder sofort veröffentlichen |
postsListTool | Die zwischen zwei Datumsangaben geplanten Beiträge der Organisation auflisten (mit ihren aktuellen Einstellungen) |
postSettingsTool | Die Anbietereinstellungen eines geplanten Beitrags oder eines noch nicht veröffentlichten Entwurfs aktualisieren |
generateImageTool | KI-Bilder für Beiträge generieren |
generateVideoOptions | Verfügbare Optionen zur Videogenerierung auflisten |
videoFunctionTool | Einstellungen des Videogenerators abrufen (z. B. verfügbare Stimmen) |
generateVideoTool | Videos für Beiträge generieren |
clippingTool | Ein langes YouTube-Video in vertikale Clips mit Untertiteln umwandeln und Beitragsentwürfe erstellen |
clippingStatusTool | Einen 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
/mcpmit deinem API-Schlüssel oder OAuth-Token als Bearer-Token:URL: https://mcp.postiz.com/mcp Authorization: Bearer your-api-keyDiese 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/:apiKeymit 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:
- Der Agent ruft
integrationListauf und erhält deine verbundenen Konten (X, LinkedIn usw.) - Der Agent ruft
integrationSchemamitplatform: "x"auf und erfährt die Zeichenbegrenzungen, Einstellungen und Regeln von X - Der Agent ruft
schedulePostToolauf 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.