# Werkzeuge · Mitglieder

> MCP-Tools für Mitglieder: Mitglieder auflisten und suchen, eine Person oder eine ganze Klasse einladen, Rollen ändern, jemanden aus der Community entfernen, Gruppen und Tags pflegen und das Organigramm aufbauen.

Wer in der Community ist und wie sie sich organisiert: Mitglieder auflisten und suchen, eine Person oder eine ganze Klasse einladen, Rollen ändern, jemanden entfernen, Gruppen anlegen, Tags setzen und im Organigramm festlegen, wer an wen berichtet.

Einladen und Rollenwechsel passieren beim ersten Aufruf, wie im Dashboard; weil die Einladung eine echte E-Mail verschickt, zeigt der Assistent vorher, wer sie bekommt. Nur das Entfernen eines Mitglieds und das Löschen von Gruppen und Tags **fragen nach deiner Bestätigung** in zwei Schritten. Siehe [Geld und Bestätigung](/mcp/dinheiro-e-confirmacao).

Jedes Tool hat ein Siegel: <span class="tool-kind tool-kind-read">Nur lesen</span> ändert nichts, <span class="tool-kind tool-kind-write">Ändert</span> legt sofort etwas an oder ändert es, und <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> handelt erst nach deinem Ja zu einer Zusammenfassung. Siehe [Geld und Bestätigung](/mcp/dinheiro-e-confirmacao).

## Kurz gesagt

| Tool | Was es tut | Mindestrolle | Typ |
|---|---|---|---|
| [`list_members`](#list-members) | Mitglieder mit Rolle und Beitrittsdatum | Moderator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`invite_member`](#invite-member) | Lädt eine Person ein, mit Rolle, Gruppen und Tags | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`invite_members`](#invite-members) | Lädt bis zu 100 Personen auf einmal ein, mit dem Ergebnis Zeile für Zeile | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_member_role`](#update-member-role) | Ändert die Rolle eines Mitglieds | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`remove_member`](#remove-member) | Entfernt eine Person aus der Community | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`list_groups`](#list-groups) | Gruppen, mit Farbe, Leitung, übergeordneter Gruppe und Personenzahl | Moderator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`create_group`](#create-group) | Legt eine Mitgliedergruppe an | Moderator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_group`](#update-group) | Benennt eine Gruppe um oder ändert sie | Moderator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`delete_group`](#delete-group) | Löscht eine Gruppe; die Personen bleiben in der Community | Moderator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`update_group_members`](#update-group-members) | Nimmt Personen in eine Gruppe auf oder entfernt sie | Moderator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`list_tags`](#list-tags) | Verwendete Tags, mit Farbe und Personenzahl | Moderator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`update_member_tags`](#update-member-tags) | Setzt oder entfernt Tags bei einer oder mehreren Personen | Moderator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_tag`](#update-tag) | Benennt einen Tag um oder ändert seine Farbe | Moderator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`delete_tag`](#delete-tag) | Entfernt einen Tag bei allen Personen | Moderator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`get_org_chart`](#get-org-chart) | Wer an wen berichtet, mit den Gruppen | Moderator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`set_manager`](#set-manager) | Legt fest, an wen eine Person berichtet | Moderator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`list_activity_logs`](#list-activity-logs) | Wer was getan hat: Team, Assistent und Mitglieder | Administrator | <span class="tool-kind tool-kind-read">Nur lesen</span> |

## `list_members`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Mitglieder auflisten.** Die Mitglieder mit Rolle und Beitrittsdatum. *Mindestrolle: Moderator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `search` | Text | Nein | Teil des Namens oder der E-Mail |
| `role` | `owner`, `admin`, `moderator`, `member`, `finance` | Nein | Nur eine Rolle |
| `sort_by` | `joinedAt`, `lastSeenAt`, `displayName`, `role`, `fullName` | Nein | `joinedAt` für „wer ist beigetreten", `lastSeenAt` für „wer war da" |
| `order` | `asc`, `desc` | Nein | Aufsteigend oder absteigend |
| `page`, `limit` | Zahl | Nein | Seitenweise Abfrage |

**Liefert:** die Profile (Anzeigename, Name, Rolle, Beitrittsdatum, Avatar) und die Seiteninformation.

**Frag so:** *„Wer ist in den letzten 7 Tagen beigetreten?"* · *„Wer sind die Moderatoren?"*

## `invite_member`

<span class="tool-kind tool-kind-write">Ändert</span>

**Eine Person einladen.** Lädt eine Person in die Community ein, mit Name, Rolle, Gruppen und Tags. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `email` | E-Mail | Ja | Die E-Mail der Person |
| `name` | Text, 2 bis 100 Zeichen | Nein | Der vollständige Name. Ohne ihn wird der Name aus der E-Mail abgeleitet |
| `role` | `member`, `moderator`, `admin`, `finance` | Nein | Standard: `member`. Niemand wird per Einladung Eigentümer |
| `groups` | Liste von Namen oder IDs, bis zu 20 | Nein | Die Gruppen, in die die Person kommt (aus `list_groups`) |
| `tags` | Liste von Texten, bis zu 20 | Nein | Die Tags der Person |

**Liefert:** die verschickte Einladung: wer sie bekommen hat, mit welcher Rolle, welchen Gruppen und Tags.

**Frag so:** *„Lade maria@memberfy.net als Moderatorin ein, in die Gruppe Klasse März.“*

**Hinweise:** Die Einladung verschickt beim ersten Aufruf eine echte E-Mail; der Assistent zeigt vorher, wer sie bekommt. Wer kein Konto hat, bekommt den Link zum Festlegen des Passworts; wer schon ein Konto hat, bekommt die Nachricht, dass er hinzugefügt wurde. Siehe [Mitglieder einladen](/membros/convidar-membros).

## `invite_members`

<span class="tool-kind tool-kind-write">Ändert</span>

**Eine Klasse einladen.** Lädt bis zu 100 Personen auf einmal ein, jede mit eigenem Namen, eigener Rolle, eigenen Gruppen und Tags, oder mit einem Standard für alle. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `people` | Liste mit 1 bis 100 | Ja | Jede Person mit `email` (Pflicht), `name`, `role`, `groups` und `tags` |
| `role` | `member`, `moderator`, `admin`, `finance` | Nein | Die Rolle für alle ohne eigene Rolle. Standard: `member` |
| `groups` | Liste, bis zu 20 | Nein | Die Gruppen für alle ohne eigene |
| `tags` | Liste, bis zu 20 | Nein | Die Tags für alle ohne eigene |

**Liefert:** das Ergebnis **Zeile für Zeile**: eingeladen, schon Mitglied (`already_member`) oder Fehler, mit dem Grund.

**Frag so:** *„Lade diese 30 Personen als Mitglieder ein, alle in die Gruppe Klasse März: [Liste mit Namen und E-Mails].“*

**Hinweise:** Die E-Mails gehen beim ersten Aufruf raus, deshalb zeigt der Assistent die Liste vor dem Einladen. Jede Zeile klappt oder scheitert für sich: Wer schon Mitglied ist, hält den Rest nicht auf. Bei mehr als 100 Personen teilt der Assistent auf. Siehe das Rezept [Eine Klasse einladen](/mcp/receitas#10-eine-klasse-einladen).

## `update_member_role`

<span class="tool-kind tool-kind-write">Ändert</span>

**Die Rolle einer Person ändern.** Ändert die Rolle eines Mitglieds. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `member` | Text | Ja | Die Profil-ID (aus `list_members`) oder die E-Mail der Person |
| `role` | `member`, `moderator`, `admin`, `finance` | Ja | Die neue Rolle |

**Liefert:** das Profil mit der neuen Rolle.

**Frag so:** *„Mach ana@memberfy.net zur Moderatorin.“*

**Hinweise:** Das ändert sofort, was die Person tun darf; zum Rückgängigmachen bitte um die alte Rolle. Die Rolle des Eigentümers kann nur ein anderer Eigentümer ändern. Siehe [Rollen und Berechtigungen](/conceitos/papeis-e-permissoes).

## `remove_member`

<span class="tool-kind tool-kind-confirm">Mit Bestätigung</span>

**Mitglied entfernen.** Entfernt eine Person aus der Community. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `member` | Text | Ja | Die Profil-ID (aus `list_members`) oder die E-Mail der Person |

**Liefert:** beim ersten Aufruf Name, E-Mail und Rolle der Person sowie den Bestätigungscode.

**Frag so:** *„Nimm bruno\@memberfy.net aus der Community.“*

**Hinweise:** Die Zertifikate der Person bleiben gültig. Nur ein Eigentümer entfernt einen anderen Eigentümer, und niemand entfernt sich hier selbst. Siehe [Mitglieder verwalten](/membros/gerenciar-membros).

## `list_groups`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Gruppen auflisten.** Die Mitgliedergruppen (Abteilungen, Klassen, Squads), mit Farbe, Leitung, übergeordneter Gruppe und Personenzahl. *Mindestrolle: Moderator.*

Parameter: keine.

**Liefert:** die Gruppen, mit ID, Name, Farbe, Leitung, übergeordneter Gruppe und Zahl der Personen.

**Frag so:** *„Welche Gruppen hat die Community, und wie viele Personen sind in jeder?“*

## `create_group`

<span class="tool-kind tool-kind-write">Ändert</span>

**Gruppe anlegen.** Legt eine Mitgliedergruppe an. *Mindestrolle: Moderator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `name` | Text | Ja | Eindeutig in der Community |
| `description` | einfacher Text | Nein | Ohne Formatierung: Markdown-Zeichen werden entfernt |
| `color` | Farbe in Hex | Nein | Z. B. `#2563EB` |
| `parent_group` | Name oder ID | Nein | Die Gruppe darüber (Geschäftsleitung → Bereich → Squad) |

**Liefert:** die angelegte Gruppe, mit der ID.

**Frag so:** *„Leg die Gruppe Klasse März an, blau, innerhalb von Studierende.“*

Siehe [Gruppen und Organigramm](/membros/grupos-e-organograma).

## `update_group`

<span class="tool-kind tool-kind-write">Ändert</span>

**Gruppe umbenennen oder ändern.** Ändert Name, Beschreibung, Farbe oder übergeordnete Gruppe einer Gruppe. *Mindestrolle: Moderator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `group` | Name oder ID | Ja | Die Gruppe |
| `name` | Text | Nein | Der neue Name |
| `description` | einfacher Text | Nein | Ohne Formatierung: Markdown-Zeichen werden entfernt |
| `color` | Farbe in Hex | Nein | |
| `parent_group` | Name oder ID | Nein | Die neue Gruppe darüber |

**Liefert:** die aktualisierte Gruppe.

**Frag so:** *„Benenne die Gruppe Klasse März in Klasse 2026.1 um.“*

## `delete_group`

<span class="tool-kind tool-kind-confirm">Mit Bestätigung</span>

**Gruppe löschen.** Löscht eine Gruppe. *Mindestrolle: Moderator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `group` | Name oder ID | Ja | Die Gruppe |

**Liefert:** beim ersten Aufruf die Zusammenfassung (die Gruppe und wie viele Personen sie hat) und den Code; beim zweiten das Löschen.

**Frag so:** *„Lösche die Gruppe Klasse 2024.“*

**Hinweise:** Die Personen verlassen die Gruppe, bleiben aber in der Community; Gruppen darunter rücken eine Ebene nach oben.

## `update_group_members`

<span class="tool-kind tool-kind-write">Ändert</span>

**Personen in eine Gruppe aufnehmen oder daraus entfernen.** Nimmt Personen in eine Gruppe auf oder entfernt sie, ohne ihre anderen Gruppen anzufassen. *Mindestrolle: Moderator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `group` | Name oder ID | Ja | Die Gruppe |
| `add` | Liste von Profil-IDs oder E-Mails | Nein | Wer hinzukommt |
| `remove` | Liste von Profil-IDs oder E-Mails | Nein | Wer geht |

**Liefert:** das Ergebnis Person für Person.

**Frag so:** *„Nimm alle, die diesen Monat das Mentoring gekauft haben, in die Gruppe Mentoring auf.“*

## `list_tags`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Mitglieder-Tags auflisten.** Die Tags, die in der Community verwendet werden, mit Farbe und Personenzahl. *Mindestrolle: Moderator.*

Parameter: keine.

**Liefert:** die Tags, mit Name, Farbe und Zahl der Personen.

**Frag so:** *„Welche Tags gibt es, und wie viele Personen haben jeden?“*

## `update_member_tags`

<span class="tool-kind tool-kind-write">Ändert</span>

**Tags setzen oder entfernen.** Setzt und entfernt Tags bei einer oder mehreren Personen und behält ihre anderen Tags. *Mindestrolle: Moderator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `members` | Liste von Profil-IDs oder E-Mails | Ja | Die Personen |
| `add` | Liste von Tags | Nein | Die Tags, die dazukommen |
| `remove` | Liste von Tags | Nein | Die Tags, die wegfallen |

**Liefert:** das Ergebnis Person für Person.

**Frag so:** *„Gib ana@memberfy.net und bruno@memberfy.net den Tag Mentor.“*

**Hinweise:** System-Tags wie **Speaker** werden nicht von Hand gesetzt. Siehe [Tags](/membros/tags).

## `update_tag`

<span class="tool-kind tool-kind-write">Ändert</span>

**Tag umbenennen oder einfärben.** Benennt einen Tag bei allen Personen um, die ihn haben, und ändert seine Farbe. *Mindestrolle: Moderator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `tag` | Text | Ja | Der Tag |
| `new_name` | Text | Nein | Der neue Name |
| `color` | Farbe in Hex | Nein | |

**Liefert:** den aktualisierten Tag.

**Frag so:** *„Benenne den Tag Mentor in Mentorin um und mach ihn lila.“*

## `delete_tag`

<span class="tool-kind tool-kind-confirm">Mit Bestätigung</span>

**Tag löschen.** Entfernt einen Tag bei allen Personen, die ihn haben. *Mindestrolle: Moderator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `tag` | Text | Ja | Der Tag |

**Liefert:** beim ersten Aufruf die Zusammenfassung und den Code; beim zweiten das Löschen.

**Frag so:** *„Lösche den Tag Event 2024.“*

**Hinweise:** Die Personen bleiben in der Community; nur der Tag fällt weg.

## `get_org_chart`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Organigramm ansehen.** Wer an wen berichtet, mit den Gruppen jeder Person. *Mindestrolle: Moderator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `root_member` | Profil-ID oder E-Mail | Nein | Wer oben steht |
| `group` | Name oder ID | Nein | Zeichnet nur diese Gruppe |
| `depth` | Zahl | Nein | Wie viele Ebenen nach unten |

**Liefert:** den Baum, Person für Person, mit Vorgesetzten und Gruppen.

**Frag so:** *„Zeig mir das Organigramm des Bereichs Produkt.“*

Siehe [Gruppen und Organigramm](/membros/grupos-e-organograma).

## `set_manager`

<span class="tool-kind tool-kind-write">Ändert</span>

**Festlegen, an wen eine Person berichtet.** Legt die vorgesetzte Person im Organigramm fest oder entfernt sie. *Mindestrolle: Moderator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `member` | Profil-ID oder E-Mail | Ja | Die Person |
| `manager` | Profil-ID oder E-Mail | Nein | An wen sie berichtet |
| `no_manager` | ja oder nein | Nein | `true` entfernt die vorgesetzte Person |

**Liefert:** die Person mit der neuen vorgesetzten Person.

**Frag so:** *„Bruno berichtet ab jetzt an Ana.“*

**Hinweise:** Ein Kreis (A berichtet an B, B an A) wird abgelehnt. Das Organigramm gibt keine Berechtigungen: Wer was darf, bestimmt weiterhin die Rolle.

## `list_activity_logs`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Aktivitätsprotokolle.** Wer in der Community was getan hat, die neuesten zuerst: dieselbe Zeitleiste wie der Tab **Mitglieder › Protokolle**. *Mindestrolle: Administrator (Eigentümer oder Administrator).*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `source` | `team`, `assistant`, `members` | Nein | **Team** (Aktionen bei Abonnements: kündigen, reaktivieren, Rabatt, Gratis-Abo, Verlängerung, Zusatzangebot, Zahlungslink), **Assistent** (was ein KI-Assistent über MCP getan hat, auch autorisierte und getrennte Verbindungen) oder **Mitglieder** (Aktionen, die Punkte in der Rangliste bringen). Ohne Angabe alle drei |
| `profile` | Profil-ID, E-Mail oder App-Link | Nein | Nur, was diese Person getan hat |
| `from`, `to` | Datum ISO 8601 | Nein | Der Zeitraum. Ein Datum ohne Uhrzeit in `to` gilt für den ganzen Tag |
| `page`, `limit` | Zahlen | Nein | Bis zu 100 pro Seite |

**Liefert:** jeden Eintrag mit Zeitpunkt, Person, Aktion (in deiner Sprache), Ziel und Details: vorher und nachher bei einer Team-Aktion, das Ergebnis eines Assistenten-Aufrufs (erledigt, Fehler, abgelehnt oder wartet auf Bestätigung) oder die Punkte einer Mitglieder-Aktion. Die Argumente der Assistenten-Aufrufe kommen zusammengefasst, ohne Bestätigungscodes und ohne Bilder.

**Frag so:** *„Wer hat das Abonnement von Ana gekündigt?“* · *„Was hat der Assistent gestern gemacht?“* · *„Was hat ana@memberfy.net diese Woche gemacht?“*

**Hinweise:** Ist ein Assistenten-Aufruf fehlgeschlagen, schlägt die Antwort [`get_connection_diagnostics`](/mcp/ferramentas-comunidade#get-connection-diagnostics) vor; mit einer Person im Filter [`member_activity`](/mcp/relatorios-e-graficos#member-activity). Ein Profil oder Link aus einer anderen Community wird abgelehnt.

## Verwandte Artikel

- [Werkzeuge](/mcp/ferramentas)
- [Rezepte](/mcp/receitas)
- [Geld und Bestätigung](/mcp/dinheiro-e-confirmacao)