Authentifizierung

km_-API-Tokens für die REST-API, den MCP-Server von kanman und den Self-hosted Runner anlegen, verwenden und widerrufen.

API-Tokens authentifizieren deine Werkzeuge gegenüber kanman: die REST-API, den MCP-Server von kanman für die lokale Arbeit in Claude Code oder Codex und den Self-hosted Runner.

API-Tokens in den Workspace-Einstellungen (Desktop) API-Tokens in den Workspace-Einstellungen (Mobile)

Token-Format

  • Beginnt mit km_
  • Insgesamt 35 Zeichen: km_ plus 32 Zufallszeichen
  • Beispiel: km_ABCDEFGHIJKLMNOPQRSTUVWXYZabcdef

Ein Token anlegen

  1. Öffne im Avatar-Menü Deine Einstellungen und wähle API-Tokens (/account/api-tokens).
  2. Klicke auf Token erstellen.
  3. Gib unter Token-Name an, wo das Token genutzt wird, zum Beispiel „Laptop Anna“ oder „Ops-Runner“.
  4. Wähle unter Workspace den Workspace, in dem das Token gilt. Ein Token liest und handelt nur in diesem einen Workspace.
  5. Wähle unter Berechtigungen, was das Token darf. Für ein neues Token sind Lesen und Schreiben gewählt; mindestens eine Berechtigung ist nötig.
  6. Wähle unter Läuft ab 30 Tage, 90 Tage oder 1 Jahr. Jedes Token läuft ab; ein Jahr ist das Maximum.
  7. Klicke auf Token erstellen.
Formular zum Anlegen eines API-Tokens (Desktop) Formular zum Anlegen eines API-Tokens (Mobile)

Lässt sich das Token nicht erstellen, bleibt das Formular offen und sagt es, sodass du es erneut versuchen kannst. Das Token wird genau einmal angezeigt. Kopiere es und leg es sofort in deinem Secret-Manager ab.

Neues Token, einmalig nach dem Anlegen angezeigt (Desktop) Neues Token, einmalig nach dem Anlegen angezeigt (Mobile)

Tokens sind persönlich: Ein Token gehört der Person, die es angelegt hat, andere Mitglieder können es weder sehen noch nutzen, und es erreicht nur Daten des Workspaces, den du dafür gewählt hast.

Berechtigungen

Berechtigung In der App angezeigt als REST-API
read Lesen Alle GET-Endpunkte. Für das Audit-Log braucht es zusätzlich das Token eines Owners oder Admins des Workspaces.
write Schreiben Entscheidungen beantworten (POST /v1/decisions/{key}/resolve) und alles, was stories:create, stories:comment und stories:start erlauben.
stories:create Stories anlegen Stories anlegen; sie gehen durch kanmans Aufnahme (POST /v1/teams/{team}/stories).
stories:comment Kommentieren Stories kommentieren (POST /v1/stories/{key}/comments).
stories:start Starten und stoppen Arbeit an einer Story starten und stoppen (POST /v1/stories/{key}/start, /stop).
stories:ready Direkt in Ready Stories direkt in Ready anlegen, ohne kanmans Aufnahme ("ready": true). Schreiben enthält das nicht.
delete Löschen Reserviert. Noch kein Endpunkt löscht Daten.
admin Admin Alles, was die anderen Berechtigungen erlauben.

Die REST-API prüft die Berechtigung jedes Endpunkts und antwortet mit 403, wenn sie dem Token fehlt. Ein Token handelt mit den Rechten der Person, die es erstellt hat: Es funktioniert nicht mehr, wenn diese Person den Workspace verlässt oder der Workspace gelöscht wird. Der MCP-Server und der Self-hosted Runner akzeptieren jedes aktive, nicht abgelaufene Token des Workspaces, unabhängig von seinen Berechtigungen.

Das Token verwenden

Sende es im Header Authorization. Für die REST-API:

curl "https://api.kanman.ai/functions/v1/api-gateway/v1/decisions?status=pending" \
  --header "Authorization: Bearer $KANMAN_API_KEY"

Für den MCP-Server in CI oder einem Skript (Menschen melden sich stattdessen im Browser an, siehe kanman in Claude Code oder Codex nutzen):

claude mcp add --transport http kanman \
  https://api.kanman.ai/functions/v1/mcp \
  --header "Authorization: Bearer $KANMAN_API_KEY"

Dem Self-hosted Runner übergibst du es als KANMAN_API_KEY; siehe Self-hosted Runner.

Eigenschaften eines Tokens

Die Liste unter Deine Einstellungen > API-Tokens zeigt pro Token:

Eigenschaft Beschreibung
Name Der Name, den du gewählt hast
Workspace Der Workspace, in dem das Token gilt
Präfix Die ersten 11 Zeichen, um das Token wiederzuerkennen
Berechtigungen Die erteilten Berechtigungen
Zuletzt benutzt Zeitpunkt der letzten Anfrage, oder „Nie benutzt“
Läuft ab Ablaufdatum; abgelaufene Tokens werden abgelehnt

Ablauf

Wähle die kürzeste passende Laufzeit. Leg vor dem Ablauf das neue Token an, stell deine Integration um und widerrufe dann das alte.

Ein Token widerrufen

  1. Öffne Deine Einstellungen > API-Tokens.
  2. Such das Token über Name oder Präfix.
  3. Klicke auf Widerrufen und bestätige.
Bestätigungsdialog zum Widerrufen eines Tokens (Desktop) Bestätigungsdialog zum Widerrufen eines Tokens (Mobile)

Ein widerrufenes Token funktioniert sofort nicht mehr. Wenn du das Token eines Self-hosted Runners widerrufst, geht dieser Runner offline.

Gute Praxis

  • Committe niemals Tokens. Halte sie in Umgebungsvariablen oder einem Secret-Manager.
  • Leg pro Rechner oder Integration ein eigenes Token an, damit du eines widerrufen kannst, ohne die anderen zu stören.
  • Prüfe ab und zu Zuletzt benutzt und widerrufe Tokens, die niemand nutzt.
  • Leg Tokens nicht in Browser-Code ab und teile sie nicht zwischen Personen.

Fehler

Ein fehlendes, unbekanntes, widerrufenes oder abgelaufenes Token wird mit HTTP 401 beantwortet. Siehe Fehler und Rate Limits.

Zuletzt aktualisiert: January 1, 0001

kanman öffnen