Skip to content

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

ParameterTypDefaultBeschreibung
statusenum active | inactive | suspended–Nach Status filtern
roleenum admin | user | guest–Nach Rolle filtern
teamIdstring–Nach Team-Mitgliedschaft filtern
searchstring–Suche in Name und E-Mail
limitnumber50Anzahl Ergebnisse
offsetnumber0Ergebnisse überspringen

Antwort: { users, total, limit, offset, has_more }.

get_user ​

Details eines Benutzers. read · follower

ParameterTypDefaultBeschreibung
userIdstring (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

ParameterTypDefaultBeschreibung
userIdstringaktueller UserFü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
ParameterTypDefaultBeschreibung
emailsstring[] (1–20) (erforderlich)–E-Mail-Adressen
roleenum user | guestuseruser = vollwertiges Mitglied, guest = folgt nur den Projekten in lists
listsstring[]–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.