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
401abgewiesen. - Ist der Besitzer in der Organisation nicht mehr aktiv, gilt sein Token ebenfalls nicht mehr.
Per Token deshalb nicht erreichbar:
| Bereich | Was |
|---|---|
MCP-Tools mit Mindestrolle admin | delete_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“ |
| REST | POST /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:
curl -X POST https://api.eu.liza.app/api/mcp/clear-cache \
-H "Authorization: Bearer DEIN_TOKEN"