Zum Inhalt springen

KI-Agenten (MCP)

PostClaw betreibt einen Remote-Server für das Model Context Protocol. Verbinde einen KI-Assistenten damit und sag einfach: „Schreib drei Beiträge für nächste Woche und plane sie auf meiner Facebook-Seite ein.“ Der Assistent prüft deine Kanäle, entwirft die Beiträge und trägt sie in deinen Kalender ein – in deinem Namen.

In jedem Tarif verfügbar, auch in Free. Die Limits deines Tarifs gelten genau wie in der App.


Was du brauchst

  • Ein PostClaw-Konto mit mindestens einem verbundenen Kanal.
  • Einen MCP-Client, der einen Authorization-Header über Streamable HTTP senden kann: Claude Code, Cursor, VS Code und die meisten anderen MCP-Clients.
  • Ein Token aus Einstellungen → KI-Agenten.

Claude.ai und ChatGPT im Browser werden noch nicht unterstützt. Sie brauchen eine OAuth-Anmeldung, die geplant ist.


In zwei Minuten verbunden

  1. Öffne Einstellungen → KI-Agenten und klicke auf Neues Token.
  2. Gib ihm einen Namen, den du wiedererkennst (zum Beispiel „Cursor auf meinem Laptop“), und wähle die Berechtigungen.
  3. Kopiere das Token. Es wird nur einmal angezeigt. Wenn du es verlierst, widerrufe es und erstelle ein neues.
  4. Füge den Server zu deinem Client hinzu. Die Einstellungsseite zeigt diese Snippets bereits mit deinem Token an.

Server-URL: https://app.postclaw.fun/mcp

Claude Code

claude mcp add --transport http postclaw https://app.postclaw.fun/mcp --header "Authorization: Bearer YOUR_TOKEN"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "postclaw": {
      "url": "https://app.postclaw.fun/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "postclaw": {
      "type": "http",
      "url": "https://app.postclaw.fun/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Frag deinen Assistenten danach etwa „Welche Kanäle habe ich in PostClaw?“, um die Verbindung zu prüfen.


Berechtigungen

Jedes Token hat eigene Berechtigungen. Der Assistent sieht nur die Tools, die sein Token erlaubt.

BerechtigungWas der Assistent darf
Lesen (immer an)Kanäle, Beiträge, Medien und Statistiken ansehen, Vorschläge für Posting-Zeiten erhalten
SchreibenEntwürfe erstellen und bearbeiten, Medien hochladen, Beiträge mit KI schreiben, KI-Bilder erstellen
Veröffentlichen (standardmäßig aus)Beiträge auf deinen echten Konten einplanen, veröffentlichen, ausplanen und löschen

Ohne Veröffentlichen kann ein Assistent nur Entwürfe hinterlassen, die du in PostClaw prüfst und freigibst. Aktiviere es nur für Assistenten, denen du das Posten in deinem Namen zutraust.

Du kannst bis zu 10 aktive Tokens haben. Ein Widerruf greift bei der nächsten Anfrage des Assistenten.


Tools

ToolBerechtigungFunktion
list_channelsLesenVerbundene Konten und Seiten, auf denen du veröffentlichen kannst
list_posts, get_postLesenEntwürfe, geplante und veröffentlichte Beiträge mit Live-Links und Fehlern
get_analyticsLesenSummen, Aufteilung nach Plattform, beste Zeiten, Top-Beiträge
suggest_posting_timesLesenGute Zeitfenster pro Plattform
list_mediaLesenZuletzt hochgeladene Medien
generate_postSchreibenBeitragstext aus einem Briefing, optional in deiner Markenstimme
adapt_postSchreibenEin Inhalt, für jede Plattform umgeschrieben
create_imageSchreibenKI-Bilder für deine Beiträge
upload_media, add_media_to_postSchreibenEigene Bilder und Videos anhängen
create_post, update_postSchreibenEntwürfe erstellen und bearbeiten; mit einer Uhrzeit wird der Beitrag eingeplant (braucht Veröffentlichen)
publish_postVeröffentlichenSofort veröffentlichen und die Live-Links jeder Plattform zurückgeben
unschedule_postVeröffentlichenEinen geplanten Beitrag zurück in den Entwurf verschieben
delete_postVeröffentlichenEinen Beitrag aus PostClaw entfernen

Medien müssen eine https://-URL sein oder eine über upload_media gesendete Datei.

create_post und publish_post akzeptieren optional einen idempotency_key. Wiederholt der Assistent einen Aufruf mit demselben Schlüssel innerhalb von 24 Stunden, liefert PostClaw das erste Ergebnis, statt doppelt zu erstellen oder zu veröffentlichen.


Limits und Credits

Ein Assistent arbeitet mit demselben Tarif wie du in der App:

  • Beiträge pro Monat, KI-Credits und Bildkontingent zählen gleich, ob du in PostClaw oder über einen Assistenten arbeitest.
  • KI-Tools verwenden deinen eigenen KI-Schlüssel, wenn du einen in den Einstellungen verbunden hast.
  • Jedes Token darf bis zu 60 Anfragen pro Minute senden.
  • Jeder Aufruf wird in deinem Konto protokolliert.

Fehlerbehebung

Was du siehstWarumWas tun
401 / “invalid token”Das Token ist falsch oder wurde widerrufenNeues Token erstellen und den Client aktualisieren
429Mehr als 60 Anfragen pro Minute von einem TokenEin paar Sekunden warten; die Antwort nennt die Dauer
Ein Tool fehltDem Token fehlt die nötige BerechtigungEin Token mit dieser Berechtigung erstellen
scope_missingEinplanen oder Veröffentlichen ohne die Berechtigung VeröffentlichenVeröffentlichen in einem neuen Token aktivieren oder in der App einplanen
quota_exceeded, credit_cap_exceededDas Monatslimit deines Tarifs ist aufgebrauchtAuf den nächsten Zeitraum warten oder upgraden
”your … configuration failed”Dein eigener KI-Schlüssel hat einen Fehler gemeldet (Kontingent, Abrechnung, abgelaufene Anmeldung)Den Schlüssel unter Einstellungen → Providers reparieren oder entfernen

Tokens sicher aufbewahren

Ein Token handelt in deinem Namen. Behandle es wie ein Passwort:

  • Committe es nicht in ein Repository und füge es nicht in geteilte Chats ein.
  • Verwende ein Token pro Gerät oder Tool, damit du eines widerrufen kannst, ohne die anderen zu stören.
  • Widerrufe nicht mehr genutzte Tokens unter Einstellungen → KI-Agenten.