MCP-Tools: Users
Alle Aufrufe: POST /api/mcp mit {"method":"tools/call","params":{"name":"<tool>","arguments":{…}}}.
list_users
Listet alle Benutzer der Organisation. read · follower
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
status | enum active | inactive | suspended | – | Nach Status filtern |
role | enum admin | user | guest | – | Nach Rolle filtern |
teamId | string | – | Nach Team-Mitgliedschaft filtern |
search | string | – | Suche in Name und E-Mail |
limit | number | 50 | Anzahl Ergebnisse |
offset | number | 0 | Ergebnisse überspringen |
Antwort: { users, total, limit, offset, has_more }.
get_user
Details eines Benutzers. read · follower
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
userId | string (erforderlich) | – | UUID des Benutzers |
get_me
Der aktuell authentifizierte Benutzer. read · guest
Keine Parameter.
get_user_workload
Auslastung (zugewiesene Items nach Status). read · follower
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
userId | string | aktueller User | Für welchen Benutzer |
Antwort: { total_cards, total_overdue, by_status[] }.
invite_user
Lädt eine oder mehrere Personen per E-Mail in die aktuelle Organisation ein und verschickt jeweils eine Einladungsmail mit Beitritts-Link.
write · admin| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
emails | string[] (1–20) (erforderlich) | – | E-Mail-Adressen |
role | enum user | guest | user | user = vollwertiges Mitglied, guest = eingeschränkt |
Einladen dürfen nur Admins/Owner — das wird serverseitig erzwungen. Die Antwort enthält ein Ergebnis pro E-Mail (eingeladen / bereits Mitglied / bereits eingeladen).
Vorher bestätigen
Adressen und Rolle vor dem Aufruf mit dem Nutzer abstimmen — eine Einladung lässt sich nicht zurücknehmen.