API & MCP

Steuere deine ContentLever-Projekte direkt aus Claude (MCP) oder per REST-API — Posts anlegen, planen, veröffentlichen, den Marketing-Guide pflegen und den Kalender abfragen.

Authentifizierung

Jedes Projekt hat einen eigenen API-Key (Präfix cl_). Du findest ihn unter Projekt-Einstellungen → MCP & API. Der Key gewährt Zugriff auf alle Projekte seines Besitzers und wird als Bearer-Token gesendet:

Authorization: Bearer cl_dein_api_key

PIN-geschützte Projekte verlangen zusätzlich ein Unlock-Token im Header X-Project-Unlock (per POST /unlock zu erhalten, 12 Stunden gültig). Über MCP übernimmt project_unlock das automatisch.

MCP — claude.ai-Connector

Für claude.ai (Web/Mobile) trage folgende URL als Custom-Connector ein — der API-Key steckt direkt im Pfad, kein separater Header nötig:

https://contentlever.167.233.38.92.sslip.io/api/marketing/mcp/cl_dein_api_key

MCP — Claude Desktop

Für Claude Desktop das npm-Paket contentlever-mcp per npx einbinden (claude_desktop_config.json):

{
  "mcpServers": {
    "contentlever": {
      "command": "npx",
      "args": ["-y", "contentlever-mcp@latest"],
      "env": {
        "CONTENTLEVER_URL": "https://contentlever.167.233.38.92.sslip.io",
        "CONTENTLEVER_API_KEY": "cl_dein_api_key"
      }
    }
  }
}

Alternativ das .mcpb-Bundle unter Projekt-Einstellungen → MCP & API herunterladen und in Claude Desktop importieren.

REST-API

Dieselben Daten sind direkt per REST erreichbar. Alle Antworten sind JSON (snake_case). Wichtige Endpunkte:

GET/api/projectsProjekte des Key-Besitzers auflisten

GET/api/projects/:idProjekt-Details (Info, Sprache, Content-Regeln)

GET/api/projects/:id/guideMarketing-Guide lesen

PATCH/api/projects/:id/guideGuide-Sektion schreiben

GET/api/projects/:id/postsPosts auflisten

POST/api/projects/:id/postsPost-Entwurf anlegen

PATCH/api/projects/:id/posts/:postIdPost aktualisieren/planen

POST/api/projects/:id/posts/:postId/publishSofort veröffentlichen

GET/api/projects/:id/insightsPost-Insights + Account-Snapshots

Beispiel — Projekte auflisten:

curl -H "Authorization: Bearer cl_dein_api_key" \
  https://contentlever.167.233.38.92.sslip.io/api/projects

Rate-Limits

Pro API-Key gelten großzügige Limits: 60 MCP-Aufrufe/Minute und 300 REST-Anfragen/Minute. Bei Überschreitung antwortet die API mit HTTP 429 — kurz warten und erneut versuchen.