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.
Ogni strumento ha un'etichetta: Solo lettura non cambia nulla, Modifica crea o cambia qualcosa subito, e Chiede conferma agisce solo dopo il tuo sì a un riepilogo. Vedi Denaro e conferma.
In sintesi
| Strumento | Cosa fa | Ruolo minimo | Tipo |
|---|---|---|---|
list_members | Membri con ruolo e data di ingresso | Moderatore | Solo lettura |
invite_member | Invita una persona, con ruolo, gruppi e tag | Admin | Modifica |
invite_members | Invita fino a 100 persone in una volta, con il risultato riga per riga | Admin | Modifica |
update_member_role | Cambia il ruolo di un membro | Admin | Modifica |
remove_member | Toglie una persona dalla community | Admin | Chiede conferma |
list_groups | Gruppi, con colore, responsabile, gruppo padre e quante persone | Moderatore | Solo lettura |
create_group | Crea un gruppo di membri | Moderatore | Modifica |
update_group | Rinomina o modifica un gruppo | Moderatore | Modifica |
delete_group | Elimina un gruppo; le persone restano nella community | Moderatore | Chiede conferma |
update_group_members | Aggiunge o toglie persone da un gruppo | Moderatore | Modifica |
list_tags | Tag usati, con colore e quante persone | Moderatore | Solo lettura |
update_member_tags | Aggiunge o toglie tag a una o più persone | Moderatore | Modifica |
update_tag | Rinomina un tag o ne cambia il colore | Moderatore | Modifica |
delete_tag | Toglie un tag a tutte le persone | Moderatore | Chiede conferma |
get_org_chart | Chi risponde a chi, con i gruppi | Moderatore | Solo lettura |
set_manager | Indica a chi risponde una persona | Moderatore | Modifica |
list_activity_logs | Chi ha fatto cosa: team, assistente e membri | Amministratore | Solo lettura |
list_members
Solo lettura
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
Modifica
Invitare una persona. Invita una persona nella community, con nome, ruolo, gruppi e tag. Ruolo minimo: admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
email | 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.
invite_members
Modifica
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.
update_member_role
Modifica
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.
remove_member
Chiede conferma
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.
list_groups
Solo lettura
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
Modifica
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.
update_group
Modifica
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
Chiede conferma
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
Modifica
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
Solo lettura
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
Modifica
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.
update_tag
Modifica
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
Chiede conferma
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
Solo lettura
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.
set_manager
Modifica
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
Solo lettura
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; con una persona nel filtro, suggerisce member_activity. Un profilo o un link di un'altra community viene rifiutato.