Entwickler

Schnittstellen einfach gemacht.

Jede Anfrage läuft im Namen einer Person und sieht nur, was diese Person sehen darf. Es gibt eine REST-API mit OAuth 2 und PKCE, Board-Token, Echtzeit-Ereignisse und einen MCP-Server für KI-Assistenten. Die REST-API ist Teil der Power-User-Funktionen, MCP gibt es in jedem Tarif.

API-Referenz lesen Schnellstart

curl -s https://producteev.de/app/api/v1/boards \
  -H "Authorization: Bearer $PRODUCTEEV_TOKEN" \
  -H "Accept: application/json"

{
  "data": [
    {
      "id": 6,
      "slug": "team-board",
      "title": "Team Board",
      "kind": "standard",
      "is_owner": true,
      "owner": {
        "id": 1,
        "name": "Anna Berger",
        "email": "anna@kranich.studio",
        "avatar_url": null
      },
      "permissions": [
        "comment",
        "create_cards",
        "edit_cards",
        "move_cards",
        "delete_cards",
        "manage_attachments",
        "manage_lists",
        "manage_subpages",
        "manage_members"
      ],
      "created_at": "2026-03-02T08:00:00+00:00"
    }
  ]
}

# {task} is the card uid. Into Erledigt, directly below card 119.
curl -s -X POST https://producteev.de/app/api/v1/tasks/{task}/move \
  -H "Authorization: Bearer $PRODUCTEEV_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: move-homepage-erledigt" \
  -d '{"column_id": 605, "before_id": 119}'

Basis-URLhttps://producteev.de/app/api/v1

Diese Adresse ist das Präfix aller API-Pfade und selbst kein Endpunkt. Öffnen Sie die API-Referenz oder rufen Sie einen Pfad wie /plans (öffentlich) oder /boards (mit Bearer-Token) auf.

Authentifizierung

So authentifizieren Sie sich.

Senden Sie das Token im Header Authorization: Bearer. Ein Token darf nie mehr als die Person, zu der es gehört.

Power-User

Board-Token

Sie legen das Token in den Board-Einstellungen unter API-Zugriff an und wählen die Bereiche aus. Standardmäßig gilt es nur für dieses Board, auf Wunsch für alle Boards, auf die Sie Zugriff haben. Es läuft nach 12 Monaten ab und wird nur einmal angezeigt.

Power-User

OAuth 2 mit PKCE

Leiten Sie Personen mit einer S256-Code-Challenge an /app/oauth/authorize weiter und tauschen Sie den Code anschließend unter /app/oauth/token ein.

Zugriffstoken gelten 15 Tage, Refresh-Token 30 Tage. Clients werden vom Betreiber registriert.

Jeder Tarif

MCP für Assistenten

Am MCP-Server unter /app/mcp meldet sich der Assistent per OAuth oder mit einem MCP-Token aus Einstellungen → Zugriffstoken an. Er handelt dann in Ihrem Namen.

REST-Zugriff für Skripte und Apps ist eine Power-User-Funktion

Board-Token und OAuth-Apps funktionieren, solange die Eigentümerin oder der Eigentümer mindestens 10 EUR im Monat für Nutzerplätze ausgibt. MCP bleibt in jedem Tarif offen.

Bereiche

Die Bereiche bauen nicht aufeinander auf. Ein Token, das nur write hat, kann keine Lese-Endpunkte aufrufen. OAuth-Clients, die keinen Bereich anfordern, erhalten read.

Bereich	Erlaubt
`read`	Boards, Karten, Kommentare und Verlauf lesen
`write`	Karten, eigene Felder, Checklisten, Kommentare, Anhänge und Automatisierungen anlegen und ändern
`manage`	Boards, Unterseiten, Listen und Mitglieder verwalten

Konventionen

Worauf Sie bei Anfragen achten sollten.

Kartenversionen

Bei jeder Änderung senden Sie die Version mit, die Sie zuletzt gelesen haben. Ist sie veraltet, antwortet die API mit 409 Conflict und der aktuellen Karte, sodass Sie Ihre Änderung erneut anwenden können.

Verschieben über Nachbarn

before_id ist die Karte direkt über der Zielposition, after_id die darunter. Wird eine Karte in eine Erledigt-Liste verschoben, gilt sie als abgeschlossen.

Idempotency-Key

Senden Sie diesen Header bei Schreibvorgängen, die nicht doppelt ausgeführt werden dürfen. Mit gleichem Schlüssel und gleichem Body erhalten Sie 30 Tage lang die gespeicherte Antwort.

Seitenweise abrufen (Cursor)

Kartenlisten akzeptieren per_page von 1 bis 200 und liefern links.next. Folgen Sie diesem Link, bis er null ist.

404 für verborgene Karten

Für eine Karte außerhalb Ihrer Unterseite liefert die API dieselbe Antwort wie für eine Karte, die es nicht gibt. So lässt sich nicht herausfinden, ob eine verborgene ID existiert.

Stabile Version v1

Innerhalb von v1 kommen nur Ergänzungen hinzu. Inkompatible Änderungen erscheinen als /app/api/v2, und v1 bleibt danach noch mindestens sechs Monate erhalten.

Ratenbegrenzung

Die Grenzen gelten pro Benutzer. Jede Antwort enthält den Header X-RateLimit-Remaining. Bei einer 429 steht in Retry-After, wie lange Sie warten müssen.

Anfragen	Limit
Alle API-Anfragen	240 pro Minute
Änderungen	120 pro Minute
Anhang-Uploads	20 pro Minute
Suche	60 pro Minute
Einladungen	50 pro Stunde

Echtzeit und Sync

Immer auf dem aktuellen Stand.

Verstehen Sie ein Echtzeit-Ereignis als Hinweis und rufen Sie die Änderung danach ab. So bleibt Ihre Kopie aktuell, auch wenn einmal eine Nachricht verloren geht.

Echtzeit

Änderungen am Board kommen über einen Pusher-kompatiblen WebSocket. Jede Person hat einen privaten Kanal, und jedes Board hat einen Anwesenheitskanal.

Sync für Offline-Clients

Laden Sie einen Schnappschuss des Boards und lesen Sie danach die Änderungen ab einem Cursor. Die Smartphone-App arbeitet genau so und dient als Referenz.

Webhooks

Senden Sie Kartenereignisse eines Boards an Slack, Teams, Discord oder einen anderen HTTPS-Endpunkt. Mit einer Testschaltfläche prüfen Sie die Verbindung.

MCP-Server

Lassen Sie einen Assistenten an Ihren Boards arbeiten.

Der Assistent bekommt kein eigenes Konto und sieht nie mehr als Sie. Im Kartenverlauf steht sein Name neben Ihrem.

Werkzeuge zum Lesen, Anlegen, Verschieben, Abschließen und Kommentieren von Karten sowie zum Verwalten von Boards, Unterseiten und Mitgliedern. Werkzeuge, die etwas löschen, fragen vorher nach.
Vorlagen für ein Standup, einen Wochenplan und die Durchsicht veralteter, überfälliger und blockierter Karten.
Nicht enthalten: Backups, Benachrichtigungseinstellungen, Kontosicherheit, API-Token und der Admin-Bereich.

Claude Code

claude mcp add --transport http producteev https://producteev.de/app/mcp

Cursor · mcp.json

{
  "mcpServers": {
    "producteev": {
      "url": "https://producteev.de/app/mcp"
    }
  }
}

Dokumentation

Weiterlesen

Die API-Referenz wird aus dem OpenAPI-Dokument des Servers erzeugt und mit jedem App-Release neu gebaut. Dazu gibt es Anleitungen zu Anmeldung, Konventionen, Echtzeit und Sync.