Vai al contenuto

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

StrumentoCosa faRuolo minimoTipo
list_membersMembri con ruolo e data di ingressoModeratoreSolo lettura
invite_memberInvita una persona, con ruolo, gruppi e tagAdminModifica
invite_membersInvita fino a 100 persone in una volta, con il risultato riga per rigaAdminModifica
update_member_roleCambia il ruolo di un membroAdminModifica
remove_memberToglie una persona dalla communityAdminChiede conferma
list_groupsGruppi, con colore, responsabile, gruppo padre e quante personeModeratoreSolo lettura
create_groupCrea un gruppo di membriModeratoreModifica
update_groupRinomina o modifica un gruppoModeratoreModifica
delete_groupElimina un gruppo; le persone restano nella communityModeratoreChiede conferma
update_group_membersAggiunge o toglie persone da un gruppoModeratoreModifica
list_tagsTag usati, con colore e quante personeModeratoreSolo lettura
update_member_tagsAggiunge o toglie tag a una o più personeModeratoreModifica
update_tagRinomina un tag o ne cambia il coloreModeratoreModifica
delete_tagToglie un tag a tutte le personeModeratoreChiede conferma
get_org_chartChi risponde a chi, con i gruppiModeratoreSolo lettura
set_managerIndica a chi risponde una personaModeratoreModifica
list_activity_logsChi ha fatto cosa: team, assistente e membriAmministratoreSolo lettura

list_members

Solo lettura

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

ParametroTipoObbligatorioDescrizione
searchtestoNoParte del nome o dell'e-mail
roleowner, admin, moderator, member, financeNoUn solo ruolo
sort_byjoinedAt, lastSeenAt, displayName, role, fullNameNojoinedAt per "chi è entrato", lastSeenAt per "chi si è fatto vedere"
orderasc, descNoCrescente o decrescente
page, limitnumeroNoPaginazione

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.

ParametroTipoObbligatorioDescrizione
emaile-mailSìL'e-mail della persona
nametesto, da 2 a 100NoIl nome completo. Senza, il nome viene preso dall'e-mail
rolemember, moderator, admin, financeNoPredefinito: member. Nessuno entra come proprietario tramite invito
groupselenco di nomi o id, fino a 20NoI gruppi in cui entra la persona (da list_groups)
tagselenco di testi, fino a 20NoI 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.

ParametroTipoObbligatorioDescrizione
peopleelenco da 1 a 100SìOgni persona con email (obbligatorio), name, role, groups e tags
rolemember, moderator, admin, financeNoIl ruolo di chi non ne ha uno proprio. Predefinito: member
groupselenco, fino a 20NoI gruppi di chi non ha i propri
tagselenco, fino a 20NoI 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.

ParametroTipoObbligatorioDescrizione
membertestoSìL'id del profilo (da list_members) o l'e-mail della persona
rolemember, moderator, admin, financeSì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.

ParametroTipoObbligatorioDescrizione
membertestoSì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.

ParametroTipoObbligatorioDescrizione
nametestoSìUnico nella community
descriptiontesto sempliceNoSenza formattazione: i segni di Markdown vengono tolti
colorcolore in hexNoEs.: #2563EB
parent_groupnome o idNoIl 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.

ParametroTipoObbligatorioDescrizione
groupnome o idSìIl gruppo
nametestoNoIl nuovo nome
descriptiontesto sempliceNoSenza formattazione: i segni di Markdown vengono tolti
colorcolore in hexNo
parent_groupnome o idNoIl 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.

ParametroTipoObbligatorioDescrizione
groupnome o idSì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.

ParametroTipoObbligatorioDescrizione
groupnome o idSìIl gruppo
addelenco di id di profilo o e-mailNoChi entra
removeelenco di id di profilo o e-mailNoChi 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.

ParametroTipoObbligatorioDescrizione
memberselenco di id di profilo o e-mailSìLe persone
addelenco di tagNoI tag da aggiungere
removeelenco di tagNoI 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.

ParametroTipoObbligatorioDescrizione
tagtestoSìIl tag
new_nametestoNoIl nuovo nome
colorcolore in hexNo

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.

ParametroTipoObbligatorioDescrizione
tagtestoSì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.

ParametroTipoObbligatorioDescrizione
root_memberid di profilo o e-mailNoChi sta in cima
groupnome o idNoDisegna solo quel gruppo
depthnumeroNoQuanti 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.

ParametroTipoObbligatorioDescrizione
memberid di profilo o e-mailSìLa persona
managerid di profilo o e-mailNoA chi risponde
no_managersì o noNotrue 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).

ParametroTipoObbligatorioDescrizione
sourceteam, assistant, membersNoTeam (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
profileid del profilo, e-mail o link dell'appNoSolo ciò che ha fatto questa persona
from, todata ISO 8601NoIl periodo. Una data senza ora in to vale l'intera giornata
page, limitnumeriNoFino 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.

Correlati