Entwickler · API · MCP

Bau auf PurrPlan.

Eine REST-API und ein nativer MCP-Server, um deine 12 Netzwerke aus deinem Code, deinem KI-Agenten (Claude, Cursor…) oder deinem Terminal zu planen, zu veröffentlichen und zu steuern.

Mit Claude / Cursor verbinden REST-API ansehen

REST · /app/api MCP · /api/mcp JSON-RPC 2.0 · 2025-06-18

01 · Authentifizierung

Ein Token, zwei Oberflächen.

Derselbe Bearer-Token öffnet die REST-API und den MCP-Server. Erstelle ihn in 30 Sekunden in deinem Konto, mit den Scopes, die du wählst.

1. Öffne app.purrplan.ai/app/mcp-integration
2. Erstelle einen Token: Name, Ablauf (30/90/365 Tage oder nie) und die gewünschten Scopes.
3. Kopiere den Token (wird nur einmal angezeigt) und übergib ihn im Header.

# Auth-Header (REST & MCP)

Authorization: Bearer $TOKEN

# Basis-URLs

REST app.purrplan.ai/app/api

MCP app.purrplan.ai/api/mcp

OAuth-kompatible MCP-Clients können auch einen Client dynamisch registrieren (DCR + PKCE) unter /app/oauth.

02 · REST-API

Erstelle und plane per HTTP.

Basis https://app.purrplan.ai/app/api. Das {workspace} ist die uuid deines Workspaces.

Methode	Endpoint	Zweck
GET	/me	Aktueller Nutzer
GET	/workspaces	Deine Workspaces
GET	/{workspace}/accounts	Verbundene Social-Konten
GET	/{workspace}/posts	Posts auflisten (paginiert)
POST	/{workspace}/posts	Post erstellen (Entwurf, geplant, Warteschlange oder sofort)
POST	/{workspace}/posts/schedule/{post}	Bestehenden Post planen
POST	/{workspace}/posts/add-to-queue/{post}	Zum nächsten freien Slot hinzufügen
GET	/{workspace}/media	Medienbibliothek
POST	/{workspace}/media	Medium hochladen
POST	/{workspace}/ai/text/generate	Text per KI generieren

Beispiel — Post erstellen & planen

# POST /app/api/{workspace}/posts curl -X POST https://app.purrplan.ai/app/api/$WS/posts \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "accounts": [12, 18], "date": "2026-07-25", "time": "09:30", "timezone": "Europe/Paris", "schedule": true, "versions": [ { "account_id": 0, "is_original": true, "content": [{ "body": "Unser Produkt ist da 🎉" }] } ] }'

201 → der Post (uuid, versions, scheduled_at)

account_id: 0 = „originale“ Version, die für alle gilt. Ersetze schedule durch queue: true (nächster freier Slot) oder schedule_now: true (sofort veröffentlichen). Ohne Datum oder Flag → Entwurf.

03 · MCP-Server

Verbinde deinen KI-Agenten.

Nativer MCP-Server (Model Context Protocol, Spec 2025-06-18, JSON-RPC 2.0 über HTTP + SSE). Verbinde Claude Desktop, Cursor oder jeden MCP-Client und lass deine KI für dich planen — mit Berechtigungen, die du kontrollierst.

Client-Config (URL + Bearer)

{ "mcpServers": { "purrplan": { "url": "https://app.purrplan.ai/api/mcp", "headers": { "Authorization": "Bearer $TOKEN" } } } }

Nur ein stdio-Client? Nutze eine Bridge wie mcp-remote.

7 Tools · erforderlicher Scope

list_workspaces read

Listet deine Workspaces auf.

—

list_accounts read

Verbundene Social-Konten (id, provider…).

workspace_uuid

list_posts read

Liste der Posts (Inhalt, Status, Datum).

workspace_uuid, status?, limit?

get_post read

Detail eines Posts (Versionen pro Netzwerk).

workspace_uuid, post_uuid

generate_ai_text ai

Generiert einen Post-Text (verbraucht Credits).

workspace_uuid, prompt, tone?…

create_draft_post write

Erstellt einen Post — Entwurf, oder geplant bei scheduled_at.

workspace_uuid, account_ids, content, scheduled_at?

upload_media_from_url media

Importiert ein Medium von einer öffentlichen URL.

workspace_uuid, url, type?

Scopes

Gib genau das Nötige frei.

read Lesen — Workspaces, Konten, Posts

write Schreiben — Posts erstellen / planen

ai KI — Textgenerierung (verbraucht Credits)

media Medien — Upload, Verwaltung der Bibliothek

Limits

Standard-Limits.

REST- & MCP-API 100 Anfragen / Min. / Nutzer

KI-Generierung 20 / Min. / Nutzer

Medien-Upload 30 / Min. / Nutzer

OAuth (Token) 10 / Min. / IP

Überschreitung → 429.

Bereit zu bauen?

Erstelle deinen Token und mach deinen ersten Aufruf in wenigen Minuten. Ab 9 €/Monat, 7 Tage Testphase.

Kostenlos starten Token erstellen