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
- Öffne Einstellungen → KI-Agenten und klicke auf Neues Token.
- Gib ihm einen Namen, den du wiedererkennst (zum Beispiel „Cursor auf meinem Laptop“), und wähle die Berechtigungen.
- Kopiere das Token. Es wird nur einmal angezeigt. Wenn du es verlierst, widerrufe es und erstelle ein neues.
- 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.
| Berechtigung | Was der Assistent darf |
|---|---|
| Lesen (immer an) | Kanäle, Beiträge, Medien und Statistiken ansehen, Vorschläge für Posting-Zeiten erhalten |
| Schreiben | Entwü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
| Tool | Berechtigung | Funktion |
|---|---|---|
list_channels | Lesen | Verbundene Konten und Seiten, auf denen du veröffentlichen kannst |
list_posts, get_post | Lesen | Entwürfe, geplante und veröffentlichte Beiträge mit Live-Links und Fehlern |
get_analytics | Lesen | Summen, Aufteilung nach Plattform, beste Zeiten, Top-Beiträge |
suggest_posting_times | Lesen | Gute Zeitfenster pro Plattform |
list_media | Lesen | Zuletzt hochgeladene Medien |
generate_post | Schreiben | Beitragstext aus einem Briefing, optional in deiner Markenstimme |
adapt_post | Schreiben | Ein Inhalt, für jede Plattform umgeschrieben |
create_image | Schreiben | KI-Bilder für deine Beiträge |
upload_media, add_media_to_post | Schreiben | Eigene Bilder und Videos anhängen |
create_post, update_post | Schreiben | Entwürfe erstellen und bearbeiten; mit einer Uhrzeit wird der Beitrag eingeplant (braucht Veröffentlichen) |
publish_post | Veröffentlichen | Sofort veröffentlichen und die Live-Links jeder Plattform zurückgeben |
unschedule_post | Veröffentlichen | Einen geplanten Beitrag zurück in den Entwurf verschieben |
delete_post | Veröffentlichen | Einen 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 siehst | Warum | Was tun |
|---|---|---|
401 / “invalid token” | Das Token ist falsch oder wurde widerrufen | Neues Token erstellen und den Client aktualisieren |
429 | Mehr als 60 Anfragen pro Minute von einem Token | Ein paar Sekunden warten; die Antwort nennt die Dauer |
| Ein Tool fehlt | Dem Token fehlt die nötige Berechtigung | Ein Token mit dieser Berechtigung erstellen |
scope_missing | Einplanen oder Veröffentlichen ohne die Berechtigung Veröffentlichen | Veröffentlichen in einem neuen Token aktivieren oder in der App einplanen |
quota_exceeded, credit_cap_exceeded | Das Monatslimit deines Tarifs ist aufgebraucht | Auf 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.