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: offene, zugewiesene Aufgaben nach Status — nur in Projekten, die der Aufrufer sehen darf. read · follower
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
userId | string | aktueller User | Für welchen Benutzer |
Antwort: { user, workload: { open_tasks, overdue, by_status[], completed_last_7_days } }.
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 = folgt nur den Projekten in lists |
lists | string[] | – | Nur für guest, dort erforderlich: IDs oder SIDs der Projekte, denen der Gast folgt |
Mitglieder einladen dürfen nur Admins/Owner. Gäste dürfen zusätzlich die Owner aller genannten Projekte einladen. Gäste gibt es nur im Pro-Tarif. Das alles wird serverseitig erzwungen. Die Antwort enthält ein Ergebnis pro E-Mail (eingeladen / bereits Mitglied / bereits eingeladen).
Was ein Gast darf, steht unter Teams & Workspace → Gäste.
Vorher bestätigen
Adressen, Rolle und bei Gästen die Projekte vor dem Aufruf mit dem Nutzer abstimmen — eine Einladung lässt sich nicht zurücknehmen.