Strumenti · Community e struttura
Strumenti MCP per la struttura della community: il contesto del collegamento, le sezioni e gli spazi, aprire un link copiato dall'app, creare, modificare, riordinare ed eliminare sezioni e spazi, chi vede ciascuno, spostare uno spazio di sezione, le impostazioni della community (lingua compresa) e l'e-mail degli avvisi di vendita.
Il punto di partenza di ogni conversazione e la forma della community: in quale community e con quale ruolo si trova l'assistente, quali sezioni e spazi esistono, e creare, riordinare, sistemare o eliminare questa struttura, compreso chi vede ogni spazio. È qui che l'assistente capisce anche un link che incolli nella conversazione, e che vede e cambia le impostazioni della community (nome, colori, logo, SEO, lingua e regole di accesso) e l'e-mail che riceve gli avvisi di vendita.
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 |
|---|---|---|---|
get_community_context | Community, ruolo, sezioni e spazi con gli id: il punto di partenza | Qualsiasi | Solo lettura |
get_connection_diagnostics | Se l'elenco di strumenti dell'assistente è aggiornato | Amministratore | Solo lettura |
list_spaces | Sezioni e spazi, con filtro per modulo | Qualsiasi | Solo lettura |
open_link | Dice cos'è un link copiato dall'app (o un id) | Qualsiasi | Solo lettura |
create_section | Crea una sezione del menu | Admin | Modifica |
create_space | Crea uno spazio in una sezione, con icona | Admin | Modifica |
update_space | Cambia nome, descrizione, icona o visibilità di uno spazio, o lo sposta in un'altra sezione | Admin | Modifica |
update_section | Cambia nome, descrizione, icona di una sezione, o la rende quella iniziale | Admin | Modifica |
reorder_sections | Mette le sezioni del menu in un nuovo ordine | Admin | Modifica |
reorder_spaces | Mette gli spazi di una sezione in un nuovo ordine | Admin | Modifica |
update_space_access | Chi vede uno spazio o una sezione, e chi pubblica nello spazio | Admin | Modifica |
delete_section | Elimina una sezione e i suoi spazi | Admin | Chiede conferma |
delete_space | Elimina uno spazio | Admin | Chiede conferma |
get_community_settings | Le impostazioni della community: nome, colori, immagini, SEO, lingua, accesso | Admin | Solo lettura |
update_community_settings | Cambia nome, colori, logo, favicon, SEO, lingua e regole di accesso | Admin | Modifica |
get_notification_settings | L'e-mail che riceve gli avvisi di vendita | Admin | Solo lettura |
update_notification_settings | Cambia o disattiva l'e-mail degli avvisi di vendita | Admin | Modifica |
get_community_context
Solo lettura
Contesto della community. Il punto di partenza: dice a quale community è legato il collegamento, con quale ruolo, ed elenca le sezioni e gli spazi con gli id. Ruolo minimo: qualsiasi.
Parametri: nessuno.
Restituisce: la community (id, nome, indirizzo), te (ruolo e nome), gli scope del collegamento (read, write), le sezioni (id, titolo, se è quella iniziale, visibilità) con gli spazi di ciascuna (id, titolo, modulo, visibilità), l'ordine in cui le cose vanno create, e le icone disponibili per gli spazi (available_icons, con l'uso di ciascuna).
Chiedi così: "A quale community sei collegato, e con quale ruolo?" · "Quali spazi ha la community?"
Note: gli assistenti di solito chiamano questo strumento da soli all'inizio di ogni conversazione. L'ordine di creazione che restituisce è lo stesso di Ordine di creazione.
list_spaces
Solo lettura
Elencare sezioni e spaces. Le sezioni e gli spazi, con id, modulo e visibilità, con filtro per modulo. Ruolo minimo: qualsiasi; ognuno vede ciò che può vedere.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
module | testo | No | feed, content, courses, events, storefront, gallery… Restituisce solo le sezioni che hanno spazi di quel modulo |
Restituisce: le sezioni con gli spazi, come in get_community_context.
Chiedi così: "Qual è lo spazio dei corsi?" · "Elenca gli spazi di eventi."
open_link
Solo lettura
Aprire un link dell'app. Riceve un link della tua community (oppure un id o uno slug) e dice cos'è, con id, titolo, spazio e un riepilogo. Ruolo minimo: qualsiasi.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
link | testo | Sì | L'indirizzo dell'app, un percorso come /aprender/cursos/excel, un id o uno slug |
Riconosce gli indirizzi dell'app: spazio (/sezione/spazio), post, evento, corso, certificato (dall'interno dello spazio o dalla pagina pubblica di verifica), call for papers e proposta (?proposal=), piano (/pricing/…) e abbonamento (/billing?subscription=…), compresi i vecchi indirizzi che l'app reindirizza.
Chiedi così: "Cos'è questo link? https://latuacommunity.com.br/aprender/cursos/excel-do-zero"
Note: funziona solo con i link della community collegata. Un link di un'altra community restituisce "Questo link è di un'altra community", anche se le amministri entrambe: collega l'altra separatamente.
create_section
Modifica
Creare una sezione. Crea una sezione del menu, come Imparare o Community. Gli spazi stanno dentro le sezioni. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
title | testo, fino a 255 | Sì | Il nome nel menu |
description | testo semplice | No | Senza formattazione: i segni di Markdown vengono tolti |
visibility | public, members, plan, private | No | Chi vede la sezione. Vedi Visibilità e accesso |
Restituisce: la sezione creata, con l'id che chiede create_space.
Chiedi così: "Crea una sezione chiamata Imparare, visibile solo ai membri."
create_space
Modifica
Creare uno space. Crea uno spazio in una sezione, con il modulo che definisce cos'è. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
section_id | id | Sì | Da get_community_context o create_section |
title | testo, fino a 255 | Sì | |
module | feed, content, courses, events, storefront, gallery, ranking, url, certificates, call4papers | Sì | Feed, Contenuto, Corsi, Eventi, Negozio, Galleria, Classifica, Link, Certificati o Call for papers. Vedi Moduli |
external_url | indirizzo web | No | Solo nel modulo url: l'indirizzo che lo spazio apre |
description | testo semplice | No | Senza formattazione: i segni di Markdown vengono tolti |
visibility | public, members, plan, private | No | |
icon | una delle icone dell'elenco | No | L'icona dello spazio. Vedi Icone. Senza, Memberfy ne sceglie una in base al titolo e al modulo |
Restituisce: lo spazio creato, con l'id e l'icona.
Chiedi così: "Crea uno spazio Feed chiamato Avvisi nella sezione Community, con l'icona del megafono."
Note: per un corso o un evento completo, create_course e create_event creano anche lo spazio. In uno spazio Call for papers, il passo successivo suggerito è aprire la prima call (create_call_for_papers). Gli spazi non hanno un'immagine di copertina.
update_space
Modifica
Modifica space. Cambia il nome, la descrizione, l'icona o la visibilità di uno spazio esistente, oppure lo sposta in un'altra sezione. Cambia solo ciò che viene inviato. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space_id | id | Sì | Da list_spaces |
title | testo, fino a 255 | No | |
description | testo semplice | No | Senza formattazione: i segni di Markdown vengono tolti |
icon | una delle icone dell'elenco | No | L'icona dello spazio. Vedi Icone. Senza, Memberfy ne sceglie una in base al titolo e al modulo |
visibility | public, members, plan, private | No | Per lo spazio privato con gruppi, prodotti o piani, usa update_space_access |
section_id | id | No | Sposta lo spazio in questa sezione |
Restituisce: lo spazio aggiornato.
Chiedi così: "Cambia l'icona dello spazio Offerte di lavoro con una valigetta." · "Dai un'icona diversa a ogni spazio della sezione Imparare, in base al tema."
update_section
Modifica
Modifica sezione. Rinomina una sezione del menu, ne cambia la descrizione o l'icona, oppure la rende la sezione iniziale. Cambia solo ciò che viene inviato. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
section | id, indirizzo o nome | Sì | Da get_community_context |
title | testo, fino a 255 | No | |
description | testo semplice | No | Senza formattazione: i segni di Markdown vengono tolti |
icon | testo | No | |
is_home | sì o no | No | La sezione che si apre per prima |
Chiedi così: "Rinomina la sezione Imparare in Corsi e rendila la sezione iniziale."
Note: chi vede la sezione si cambia con update_space_access.
reorder_sections
Modifica
Riordina sezioni. Mette le sezioni del menu in un nuovo ordine, dall'alto verso il basso. Quelle non indicate mantengono il loro ordine, dopo queste. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
section_ids | elenco di id | Sì | Da get_community_context, nel nuovo ordine |
Chiedi così: "Metti la sezione Eventi subito dopo Community."
reorder_spaces
Modifica
Riordina spazi. Mette gli spazi di una sezione in un nuovo ordine. Quelli non indicati mantengono il loro ordine, dopo questi. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
section | id, indirizzo o nome | Sì | La sezione |
space_ids | elenco di id | Sì | Da list_spaces, nel nuovo ordine |
Chiedi così: "Nella sezione Imparare, metti per primo lo spazio Excel da Zero."
Note: per portare uno spazio in un'altra sezione, usa update_space con section_id.
update_space_access
Modifica
Cambia chi vede lo spazio. Stabilisce chi vede uno spazio o un'intera sezione e, in uno spazio, chi può pubblicare. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space o section | id, link, indirizzo o nome | Uno dei due | Lo spazio o la sezione |
visibility | public, members, plan, private | No | Pubblico, membri, qualsiasi abbonamento attivo, o privato |
group_ids | elenco di id | No | Nel privato: i gruppi che entrano (da list_groups) |
product_ids | elenco di id | No | Nel privato: i prodotti il cui acquisto dà accesso (da list_products) |
plan_ids | elenco di id | No | Nel privato: i piani il cui abbonamento dà accesso (da list_plans) |
can_create | anyone, staff, admins | No | Solo spazio: Chiunque, Team o Admin possono pubblicare |
Restituisce: lo spazio o la sezione aggiornati.
Chiedi così: "Rendi lo spazio Excel da Zero visibile solo a chi ha comprato il prodotto del corso o è abbonato al piano Studente."
Note: i gruppi, prodotti e piani inviati sostituiscono quelli che c'erano; ne basta uno perché la persona entri. Uno spazio non è mai più aperto della sua sezione. Cambia subito chi vede cosa: chiedi all'assistente di mostrarti prima cosa cambierà, se vuoi controllare. Vedi Visibilità e accesso.
delete_section
Chiede conferma
Elimina sezione. Elimina una sezione del menu e gli spazi che contiene. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
section | id, indirizzo o nome | Sì |
Restituisce: alla prima chiamata, la sezione e l'elenco degli spazi che vengono eliminati con lei, più il codice di conferma.
delete_space
Chiede conferma
Elimina spazio. Elimina uno spazio, e ciò che contiene, dal menu. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space | id, link, indirizzo o nome | Sì |
Restituisce: alla prima chiamata, lo spazio, il modulo e la sezione, più il codice di conferma.
get_community_settings
Solo lettura
Vedere le impostazioni della community. Le impostazioni della community così come sono. Ruolo minimo: admin.
Parametri: nessuno.
Restituisce: il nome, la descrizione, i colori (primario e secondario in hex, e la scala completa), il logo, la favicon, l'immagine di condivisione, il SEO, le regole di accesso (registrazione aperta, modello di registrazione, visitatori), la moderazione e la classifica. Nessun segreto, come integrazioni o DNS.
Chiedi così: "Quali sono oggi i colori e il SEO della community?"
update_community_settings
Modifica
Modificare le impostazioni della community. Cambia le impostazioni; cambia solo ciò che viene inviato. Ruolo minimo: admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
name, description | testo | No | Il nome e la descrizione della community |
primary_color, secondary_color | colore in hex (#RRGGBB) | No | L'intera scala, da 50 a 950, viene generata a partire da questi. Vedi Colori |
reset_colors | sì o no | No | Torna ai colori predefiniti del prodotto |
mobile_bar_color | colore in hex | No | Il colore della barra del browser sul telefono |
seo_title, seo_description | testo | No | Vedi Immagini e SEO |
signup_open | sì o no | No | Chiunque può registrarsi |
signup_model | FREE, PAID | No | |
guest_access | sì o no | No | I visitatori vedono ciò che è pubblico |
content_moderation | sì o no | No | |
global_ranking | sì o no | No | |
language | pt-BR, pt-PT, en-US, es-ES, es-MX, es-AR, it-IT, de-DE, de-AT, de-CH | No | La lingua della community: quella delle e-mail e di chi non ha ancora scelto una lingua. Vedi Lingue |
linkedin_id | numero | No | L'ID della pagina LinkedIn della community, per i certificati |
logo_url o logo_base64 | link o file | No | Il logo |
favicon_url o favicon_base64 | link o file | No | La favicon |
share_image_url o share_image_base64 | link o file | No | L'immagine che compare quando qualcuno condivide il link |
Restituisce: le impostazioni applicate, con il prima → dopo di ogni campo.
Chiedi così: "Cambia il colore primario in #4F46E5 e usa questo logo: https://…"
Note: tutto questo è visibile all'intera community appena la chiamata viene eseguita; per annullare, chiedi di nuovo con il valore precedente, che trovi nel prima → dopo. Dominio e integrazioni non si cambiano da qui. Vedi Impostazioni generali.
get_notification_settings
Solo lettura
Vedi avvisi di vendita. Dove vanno gli avvisi della community: l'e-mail che riceve un avviso a ogni vendita. Ruolo minimo: Admin.
Parametri: nessuno.
Chiedi così: "Chi riceve l'avviso quando c'è una vendita?"
update_notification_settings
Modifica
Cambia e-mail degli avvisi di vendita. Stabilisce l'e-mail che riceve un avviso a ogni vendita. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
sales_notification_email | Sì | Vuoto ("") disattiva gli avvisi |
Chiedi così: "Manda gli avvisi di vendita a [email protected]."
Vedi Avvisi di vendita.
Icone
Gli spazi usano le stesse icone del selettore del pannello. L'assistente riceve l'elenco con l'uso di ciascuna (in get_community_context, campo available_icons, e nella descrizione degli strumenti) ed è istruito a scegliere in base al tema, senza ripetere sempre la stessa. Se non sceglie, Memberfy ne sceglie una in base al titolo (Agenda delle dirette ottiene calendar, Offerte di lavoro ottiene briefcase) o, senza indizi nel titolo, in base al modulo (Corsi ottiene book-open, Galleria ottiene image).
Alcuni esempi: calendar (eventi, agenda), book-open (corsi, lezioni), graduation-cap (formazione, mentoring), megaphone (avvisi, annunci), message-square (forum, domande), briefcase (carriera, offerte di lavoro), image (galleria, foto), trophy (classifica, sfide), shopping-bag (negozio), crown (premium, VIP), lock (privato).
get_connection_diagnostics
Solo lettura
Diagnostica della connessione. Dice se l'elenco di strumenti che l'assistente sta usando è aggiornato. Ruolo minimo: amministratore (proprietario o amministratore).
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
connection_id | id | No | Senza, la connessione di questa conversazione |
Restituisce: l'assistente, chi ha autorizzato e quando, la versione del server e l'elenco che la connessione riceverebbe adesso (il codice dell'elenco e quanti strumenti), cosa ha ricevuto l'ultima volta, l'ultima chiamata e l'ultimo tentativo di usare uno strumento che non ha, e listUpToDate. Con listUpToDate falso, l'assistente usa l'elenco vecchio: apri una nuova conversazione o ricollega il connettore.
Chiedi così: "Una tua chiamata è fallita. Il tuo elenco di strumenti di Memberfy è aggiornato?"