# Strumenti · Membri

> Strumenti MCP per i membri: elencare e cercare i membri, invitare una persona o un'intera classe, cambiare ruoli, rimuovere qualcuno dalla community, organizzare gruppi e tag e costruire l'organigramma.

Chi è nella community e come si organizza: elencare e cercare i membri, invitare una persona o un'intera classe, cambiare ruoli, rimuovere qualcuno, creare gruppi, assegnare tag e indicare chi risponde a chi nell'organigramma.

Invitare e cambiare un ruolo avvengono alla prima chiamata, come nel pannello; poiché l'invito invia un'e-mail vera, l'assistente mostra prima chi la riceverà. Solo la rimozione di un membro e le eliminazioni di gruppi e tag **chiedono la tua conferma** in due fasi. Vedi [Denaro e conferma](/mcp/dinheiro-e-confirmacao).

Ogni strumento ha un'etichetta: <span class="tool-kind tool-kind-read">Solo lettura</span> non cambia nulla, <span class="tool-kind tool-kind-write">Modifica</span> crea o cambia qualcosa subito, e <span class="tool-kind tool-kind-confirm">Chiede conferma</span> agisce solo dopo il tuo sì a un riepilogo. Vedi [Denaro e conferma](/mcp/dinheiro-e-confirmacao).

## In sintesi

| Strumento | Cosa fa | Ruolo minimo | Tipo |
|---|---|---|---|
| [`list_members`](#list-members) | Membri con ruolo e data di ingresso | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`invite_member`](#invite-member) | Invita una persona, con ruolo, gruppi e tag | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`invite_members`](#invite-members) | Invita fino a 100 persone in una volta, con il risultato riga per riga | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_member_role`](#update-member-role) | Cambia il ruolo di un membro | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`remove_member`](#remove-member) | Toglie una persona dalla community | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`list_groups`](#list-groups) | Gruppi, con colore, responsabile, gruppo padre e quante persone | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`create_group`](#create-group) | Crea un gruppo di membri | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_group`](#update-group) | Rinomina o modifica un gruppo | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_group`](#delete-group) | Elimina un gruppo; le persone restano nella community | Moderatore | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`update_group_members`](#update-group-members) | Aggiunge o toglie persone da un gruppo | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`list_tags`](#list-tags) | Tag usati, con colore e quante persone | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`update_member_tags`](#update-member-tags) | Aggiunge o toglie tag a una o più persone | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_tag`](#update-tag) | Rinomina un tag o ne cambia il colore | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_tag`](#delete-tag) | Toglie un tag a tutte le persone | Moderatore | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`get_org_chart`](#get-org-chart) | Chi risponde a chi, con i gruppi | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`set_manager`](#set-manager) | Indica a chi risponde una persona | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`list_activity_logs`](#list-activity-logs) | Chi ha fatto cosa: team, assistente e membri | Amministratore | <span class="tool-kind tool-kind-read">Solo lettura</span> |

## `list_members`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**Elencare i membri.** I membri, con ruolo e data di ingresso. *Ruolo minimo: moderatore.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `search` | testo | No | Parte del nome o dell'e-mail |
| `role` | `owner`, `admin`, `moderator`, `member`, `finance` | No | Un solo ruolo |
| `sort_by` | `joinedAt`, `lastSeenAt`, `displayName`, `role`, `fullName` | No | `joinedAt` per "chi è entrato", `lastSeenAt` per "chi si è fatto vedere" |
| `order` | `asc`, `desc` | No | Crescente o decrescente |
| `page`, `limit` | numero | No | Paginazione |

**Restituisce:** i profili (nome visualizzato, nome, ruolo, data di ingresso, avatar) e la paginazione.

**Chiedi così:** *"Chi è entrato nella community negli ultimi 7 giorni?"* · *"Chi sono i moderatori?"*

## `invite_member`

<span class="tool-kind tool-kind-write">Modifica</span>

**Invitare una persona.** Invita una persona nella community, con nome, ruolo, gruppi e tag. *Ruolo minimo: admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `email` | e-mail | Sì | L'e-mail della persona |
| `name` | testo, da 2 a 100 | No | Il nome completo. Senza, il nome viene preso dall'e-mail |
| `role` | `member`, `moderator`, `admin`, `finance` | No | Predefinito: `member`. Nessuno entra come proprietario tramite invito |
| `groups` | elenco di nomi o id, fino a 20 | No | I gruppi in cui entra la persona (da `list_groups`) |
| `tags` | elenco di testi, fino a 20 | No | I tag della persona |

**Restituisce:** l'invito inviato: chi l'ha ricevuto, con quale ruolo, gruppi e tag.

**Chiedi così:** *"Invita maria@memberfy.net come moderatrice, nel gruppo Classe di marzo."*

**Note:** l'invito invia un'e-mail vera alla prima chiamata; l'assistente mostra prima chi la riceverà. Chi non ha un account riceve il link per impostare la password; chi ha già un account riceve l'avviso di essere stato aggiunto. Vedi [Invitare membri](/membros/convidar-membros).

## `invite_members`

<span class="tool-kind tool-kind-write">Modifica</span>

**Invitare una classe.** Invita fino a 100 persone in una volta, ciascuna con il proprio nome, ruolo, gruppi e tag, oppure con un valore predefinito per tutte. *Ruolo minimo: admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `people` | elenco da 1 a 100 | Sì | Ogni persona con `email` (obbligatorio), `name`, `role`, `groups` e `tags` |
| `role` | `member`, `moderator`, `admin`, `finance` | No | Il ruolo di chi non ne ha uno proprio. Predefinito: `member` |
| `groups` | elenco, fino a 20 | No | I gruppi di chi non ha i propri |
| `tags` | elenco, fino a 20 | No | I tag di chi non ha i propri |

**Restituisce:** il risultato **riga per riga**: invitata, era già membro (`already_member`) o errore, con il motivo.

**Chiedi così:** *"Invita queste 30 persone come membri, tutte nel gruppo Classe di marzo: [elenco di nomi ed e-mail]."*

**Note:** le e-mail partono alla prima chiamata, per questo l'assistente mostra l'elenco prima di invitare. Ogni riga riesce o fallisce da sola: chi è già membro non ferma il resto. Oltre 100 persone, l'assistente divide in più parti. Vedi la ricetta [Invitare una classe](/mcp/receitas#10-invitare-una-classe).

## `update_member_role`

<span class="tool-kind tool-kind-write">Modifica</span>

**Cambiare il ruolo di qualcuno.** Cambia il ruolo di un membro. *Ruolo minimo: admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `member` | testo | Sì | L'id del profilo (da `list_members`) o l'e-mail della persona |
| `role` | `member`, `moderator`, `admin`, `finance` | Sì | Il nuovo ruolo |

**Restituisce:** il profilo con il nuovo ruolo.

**Chiedi così:** *"Promuovi ana@memberfy.net a moderatrice."*

**Note:** cambia subito ciò che la persona può fare; per annullare, chiedi il ruolo precedente. Il ruolo del proprietario può cambiarlo solo un altro proprietario. Vedi [Ruoli e permessi](/conceitos/papeis-e-permissoes).

## `remove_member`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Rimuovi membro.** Toglie una persona dalla community. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `member` | testo | Sì | L'id del profilo (da `list_members`) o l'e-mail della persona |

**Restituisce:** alla prima chiamata, il nome, l'e-mail e il ruolo della persona, più il codice di conferma.

**Chiedi così:** *"Togli bruno\@memberfy.net dalla community."*

**Note:** i certificati della persona restano validi. Solo un proprietario rimuove un altro proprietario, e nessuno rimuove sé stesso da qui. Vedi [Gestire i membri](/membros/gerenciar-membros).

## `list_groups`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**Elencare i gruppi.** I gruppi di membri (reparti, classi, squadre), con colore, responsabile, gruppo padre e quante persone ha ciascuno. *Ruolo minimo: moderatore.*

Parametri: nessuno.

**Restituisce:** i gruppi, con id, nome, colore, responsabile, gruppo padre e numero di persone.

**Chiedi così:** *"Quali gruppi ha la community, e quante persone in ciascuno?"*

## `create_group`

<span class="tool-kind tool-kind-write">Modifica</span>

**Creare un gruppo.** Crea un gruppo di membri. *Ruolo minimo: moderatore.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `name` | testo | Sì | Unico nella community |
| `description` | testo semplice | No | Senza formattazione: i segni di Markdown vengono tolti |
| `color` | colore in hex | No | Es.: `#2563EB` |
| `parent_group` | nome o id | No | Il gruppo sopra (direzione → area → squadra) |

**Restituisce:** il gruppo creato, con l'id.

**Chiedi così:** *"Crea il gruppo Classe di marzo, blu, dentro Studenti."*

Vedi [Gruppi e organigramma](/membros/grupos-e-organograma).

## `update_group`

<span class="tool-kind tool-kind-write">Modifica</span>

**Rinominare o modificare un gruppo.** Cambia nome, descrizione, colore o gruppo padre di un gruppo. *Ruolo minimo: moderatore.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `group` | nome o id | Sì | Il gruppo |
| `name` | testo | No | Il nuovo nome |
| `description` | testo semplice | No | Senza formattazione: i segni di Markdown vengono tolti |
| `color` | colore in hex | No | |
| `parent_group` | nome o id | No | Il nuovo gruppo sopra |

**Restituisce:** il gruppo aggiornato.

**Chiedi così:** *"Rinomina il gruppo Classe di marzo in Classe 2026.1."*

## `delete_group`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Eliminare un gruppo.** Elimina un gruppo. *Ruolo minimo: moderatore.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `group` | nome o id | Sì | Il gruppo |

**Restituisce:** alla prima chiamata, il riepilogo (il gruppo e quante persone ha) e il codice; alla seconda, l'eliminazione.

**Chiedi così:** *"Elimina il gruppo Classe 2024."*

**Note:** le persone escono dal gruppo ma restano nella community; i gruppi che stavano sotto salgono di un livello.

## `update_group_members`

<span class="tool-kind tool-kind-write">Modifica</span>

**Aggiungere o togliere persone da un gruppo.** Aggiunge o toglie persone da un gruppo, senza toccare gli altri loro gruppi. *Ruolo minimo: moderatore.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `group` | nome o id | Sì | Il gruppo |
| `add` | elenco di id di profilo o e-mail | No | Chi entra |
| `remove` | elenco di id di profilo o e-mail | No | Chi esce |

**Restituisce:** il risultato persona per persona.

**Chiedi così:** *"Metti nel gruppo Mentoring tutti quelli che hanno comprato il mentoring questo mese."*

## `list_tags`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**Elencare i tag dei membri.** I tag usati nella community, con colore e quante persone hanno ciascuno. *Ruolo minimo: moderatore.*

Parametri: nessuno.

**Restituisce:** i tag, con nome, colore e numero di persone.

**Chiedi così:** *"Quali tag esistono, e quante persone ha ciascuno?"*

## `update_member_tags`

<span class="tool-kind tool-kind-write">Modifica</span>

**Aggiungere o togliere tag.** Aggiunge e toglie tag a una o più persone, mantenendo gli altri loro tag. *Ruolo minimo: moderatore.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `members` | elenco di id di profilo o e-mail | Sì | Le persone |
| `add` | elenco di tag | No | I tag da aggiungere |
| `remove` | elenco di tag | No | I tag da togliere |

**Restituisce:** il risultato persona per persona.

**Chiedi così:** *"Aggiungi il tag Mentor ad ana@memberfy.net e bruno@memberfy.net."*

**Note:** i tag di sistema, come **Relatore**, non si assegnano a mano. Vedi [Tag](/membros/tags).

## `update_tag`

<span class="tool-kind tool-kind-write">Modifica</span>

**Rinominare o colorare un tag.** Rinomina un tag in tutte le persone che lo hanno e ne cambia il colore. *Ruolo minimo: moderatore.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `tag` | testo | Sì | Il tag |
| `new_name` | testo | No | Il nuovo nome |
| `color` | colore in hex | No | |

**Restituisce:** il tag aggiornato.

**Chiedi così:** *"Rinomina il tag Mentor in Mentora e rendilo viola."*

## `delete_tag`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Eliminare un tag.** Toglie un tag a tutte le persone che lo hanno. *Ruolo minimo: moderatore.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `tag` | testo | Sì | Il tag |

**Restituisce:** alla prima chiamata, il riepilogo e il codice; alla seconda, l'eliminazione.

**Chiedi così:** *"Elimina il tag Evento 2024."*

**Note:** le persone restano nella community; esce solo il tag.

## `get_org_chart`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**Vedere l'organigramma.** Chi risponde a chi, con i gruppi di ciascuna persona. *Ruolo minimo: moderatore.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `root_member` | id di profilo o e-mail | No | Chi sta in cima |
| `group` | nome o id | No | Disegna solo quel gruppo |
| `depth` | numero | No | Quanti livelli scendere |

**Restituisce:** l'albero, persona per persona, con il responsabile e i gruppi.

**Chiedi così:** *"Mostrami l'organigramma dell'area Prodotto."*

Vedi [Gruppi e organigramma](/membros/grupos-e-organograma).

## `set_manager`

<span class="tool-kind tool-kind-write">Modifica</span>

**Indicare a chi risponde una persona.** Dice chi è il responsabile di una persona nell'organigramma, oppure toglie il responsabile. *Ruolo minimo: moderatore.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `member` | id di profilo o e-mail | Sì | La persona |
| `manager` | id di profilo o e-mail | No | A chi risponde |
| `no_manager` | sì o no | No | `true` toglie il responsabile |

**Restituisce:** la persona con il nuovo responsabile.

**Chiedi così:** *"Bruno ora risponde ad Ana."*

**Note:** un ciclo (A risponde a B, che risponde ad A) viene rifiutato. L'organigramma non dà alcun permesso: chi può fare cosa resta il ruolo.

## `list_activity_logs`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**Registri delle attività.** Chi ha fatto cosa nella community, dal più recente al più vecchio: la stessa linea del tempo della scheda **Membri › Log**. *Ruolo minimo: amministratore (proprietario o amministratore).*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `source` | `team`, `assistant`, `members` | No | **Team** (le azioni sugli abbonamenti: annullare, riattivare, sconto, omaggio, estensione, componente aggiuntivo, link di pagamento), **assistente** (cosa ha fatto un assistente IA tramite l'MCP, comprese le connessioni autorizzate e scollegate) o **membri** (le azioni che danno punti nella classifica). Senza, tutte e tre |
| `profile` | id del profilo, e-mail o link dell'app | No | Solo ciò che ha fatto questa persona |
| `from`, `to` | data ISO 8601 | No | Il periodo. Una data senza ora in `to` vale l'intera giornata |
| `page`, `limit` | numeri | No | Fino a 100 per pagina |

**Restituisce:** ogni registro con quando, chi, l'azione (nella tua lingua), su cosa e i dettagli: il prima e dopo di un'azione del team, l'esito di una chiamata dell'assistente (completata, errore, rifiutata o in attesa di conferma) o i punti di un'azione di un membro. Gli argomenti delle chiamate dell'assistente arrivano riassunti, senza codici di conferma né immagini.

**Chiedi così:** *"Chi ha annullato l'abbonamento di Ana?"* · *"Cosa ha fatto l'assistente ieri?"* · *"Cosa ha fatto ana@memberfy.net questa settimana?"*

**Note:** se una chiamata dell'assistente è fallita, la risposta suggerisce [`get_connection_diagnostics`](/mcp/ferramentas-comunidade#get-connection-diagnostics); con una persona nel filtro, suggerisce [`member_activity`](/mcp/relatorios-e-graficos#member-activity). Un profilo o un link di un'altra community viene rifiutato.

## Correlati

- [Strumenti](/mcp/ferramentas)
- [Ricette](/mcp/receitas)
- [Denaro e conferma](/mcp/dinheiro-e-confirmacao)