Skip to content

Authentifizierung ​

Alle Requests authentifizieren sich per Bearer-Token im Authorization-Header.

Authorization: Bearer liza_mcp_…

Welche Daten und Tools sichtbar sind, richtet sich nach deiner Rolle (owner > admin > user > follower > guest) und den verbundenen Integrationen (z. B. erscheinen CRM-Tools nur mit verbundener CRM-Integration).

TIP

Den Token erstellst du in den Liza-Einstellungen. Behandle ihn wie ein Passwort — er trägt deine Berechtigungen.

Rolle eines Tokens ​

Ein Token arbeitet mit der Rolle seines Besitzers in der Organisation — aber höchstens mit user. Admins und Owner bekommen über einen Token keine Admin-Rechte; Follower bleiben Follower.

  • Gäste einer Organisation bekommen keinen Token: ein Token, dessen Besitzer dort Gast ist, wird mit 401 abgewiesen.
  • Ist der Besitzer in der Organisation nicht mehr aktiv, gilt sein Token ebenfalls nicht mehr.

Per Token deshalb nicht erreichbar:

BereichWas
MCP-Tools mit Mindestrolle admindelete_list, delete_list_item, create_team, add_team_member, remove_team_member, unified_api_call, create_connector, update_connector, list_connectors, test_connector, github_merge_pull_request — sie fehlen in tools/list, ein direkter Aufruf scheitert mit „Insufficient permissions“
RESTPOST /v1/users, PATCH /v1/users/{userId}, DELETE /v1/users/{userId} — Antwort 403 (siehe Users)

Diese Aufgaben erledigen Admins in der Liza-Oberfläche.

Auth-Cache ​

Tokens werden serverseitig kurz gecacht. Löschen, Deaktivieren und Neu-Vergeben über die Einstellungen räumt den Cache automatisch — ein widerrufener Token wirkt also sofort, nicht erst nach Ablauf der Cache-Dauer.

Wurde ein Token direkt auf der Datenbank geändert, lässt sich der Eintrag manuell leeren. Der Endpunkt ist authentifiziert und räumt ausschließlich den Cache-Eintrag des mitgeschickten Tokens:

bash
curl -X POST https://api.eu.liza.app/api/mcp/clear-cache \
  -H "Authorization: Bearer DEIN_TOKEN"