API & MCP

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

Authentifizierung

Dein Konto hat EINEN API-Key (Präfix cl_) - er gilt für alle deine Projekte. Du findest ihn unter Konto → MCP & API (Zahnrad am Profil). Der Key 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://nunki.167.233.38.92.sslip.io/api/marketing/mcp/cl_dein_api_key

MCP — VS Code / Cursor

Remote-MCP direkt per URL, ohne lokale Installation. In VS Code in die .vscode/mcp.json eintragen (Cursor: dieselbe URL unter MCP-Settings):

{
  "servers": {
    "nunki": {
      "type": "http",
      "url": "https://nunki.167.233.38.92.sslip.io/api/marketing/mcp/cl_dein_api_key"
    }
  }
}

Für Claude Desktop dieselbe URL unter Einstellungen → Connectors als Remote-MCP eintragen.

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://nunki.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.