# Panoramica dell'MCP > Il server MCP di Memberfy permette a Claude, ChatGPT, Cursor e Claude Code di gestire la tua community in una conversazione, con il tuo ruolo, in una sola community e con una conferma prima di toccare il denaro o eliminare. Cos'è, a cosa serve, come funziona, cosa si può e cosa non si può fare, e un esempio dalla richiesta al risultato. L'**MCP** (Model Context Protocol) è lo standard aperto che gli assistenti IA usano per operare su altri sistemi. Memberfy ha un server MCP all'indirizzo **`https://api.memberfy.net/mcp`**: una volta collegato, il tuo assistente smette di limitarsi a dare consigli sulla community e comincia a fare il lavoro al suo interno. Descrivi quello che vuoi in una conversazione; lui legge ciò che gli serve, crea nell'ordine giusto e ti dice cosa ha fatto. ## A cosa serve Chi vive di community passa buona parte del tempo a costruire cose: lo spazio del nuovo corso, i moduli e le lezioni, la pagina di vendita, l'evento del mese con il biglietto, il piano con mensile e annuale, il coupon della campagna. Ognuna di queste cose è una sequenza di schermate e moduli. Con l'MCP è una richiesta. | Chi | Cosa chiede all'assistente | Cosa succede in Memberfy | |---|---|---| | Scuola online | "Crea il corso *Excel da Zero* con 4 moduli e 3 lezioni ciascuno, e un prodotto da R$ 297 fino a 10 rate" | Uno spazio Corsi, il corso, 4 moduli, 12 lezioni e il prodotto in bozza, che sblocca lo spazio | | Mentoring di gruppo | "Crea il piano *Mentoring* con mensile da R$ 390 e annuale da R$ 3.900, con contratto di 6 mesi sul mensile" | Due opzioni di fatturazione e il piano con entrambe, in bozza | | Community di eventi | "Crea l'incontro dal vivo del 15/11 alle 19 a San Paolo, con 80 biglietti da R$ 60" | Lo spazio Eventi, l'evento e il biglietto con 80 posti disponibili | | Coworking | "Chi è entrato nella community questa settimana? Scrivi un benvenuto nel Feed citando ciascuno" | L'elenco dei nuovi membri e il post nel Feed | | Qualsiasi community con vendite | "Quanto abbiamo venduto negli ultimi 90 giorni, per prodotto? Fai un grafico" | Il riepilogo delle vendite, che l'assistente trasforma in tabella o grafico | L'assistente sa anche leggere: membri, spazi, post e commenti, eventi e partecipanti, corsi, piani, prodotti, coupon e, per chi ha accesso, vendite, abbonamenti, estratto conto, saldo e prelievi. Rispondere a "chi ha confermato la presenza all'evento di giovedì?" diventa una domanda, non una ricerca nel pannello. ## Come funziona
Tu chiedi→L'assistente sceglie gli strumenti→Memberfy esegue con il tuo ruolo→L'assistente racconta il risultato
### Tre regole che definiscono tutto **1. L'assistente agisce con il tuo ruolo.** Entra come te, con il ruolo che hai in quella community, verificato a ogni chiamata. Un moderatore collegato può fissare post e creare eventi, ma non creare piani; un membro può pubblicare e commentare dove già poteva. Se il tuo ruolo cambia nel pannello, l'assistente cambia con lui; se esci dalla community, il collegamento smette di funzionare. L'MCP non ha regole di permesso proprie: ogni azione passa per gli stessi controlli della schermata. Vedi [Ruoli e permessi](/conceitos/papeis-e-permissoes). **2. Un collegamento, una community.** Quando ti colleghi scegli **una** community, e l'assistente vede e modifica solo quella. Per lavorare su un'altra, crei un altro collegamento. Vedi [Autorizzare e scollegare](/mcp/autorizar-e-desconectar). **3. Revocabile in qualsiasi momento.** In **Il Mio Account › Assistenti IA** (`/account?tab=assistants`), un clic su **Scollega** toglie l'accesso subito. Anche il proprietario e gli admin vedono e scollegano qualsiasi assistente con accesso alla community, in **Impostazioni › Assistenti IA**. ### Gli strumenti Il server offre **188 strumenti**, organizzati per tema, e copre tutti i moduli della community: ciò che l'app ti permette di fare, l'assistente lo fa dalla conversazione. Vede solo quelli che il tuo ruolo può usare: l'elenco di un membro è molto più corto di quello di un proprietario. | Tema | Cosa si può fare | Esempi | |---|---|---| | [Community e struttura](/mcp/ferramentas-comunidade) | Il contesto del collegamento, sezioni e spazi (creare, riordinare, eliminare, chi vede), aprire un link dell'app, le impostazioni della community | `get_community_context`, `create_space`, `update_space_access` | | [Contenuti e coinvolgimento](/mcp/ferramentas-conteudo) | Cercare, pubblicare, modificare, spostare ed eliminare post e commenti, reagire, fissare, galleria | `create_post`, `move_post`, `create_comment` | | [Corsi](/mcp/ferramentas-cursos) | Costruire un intero corso, modificare ed eliminare moduli e lezioni, iscrizione e avanzamento | `create_course`, `update_lesson` | | [Eventi](/mcp/ferramentas-eventos) | Creare eventi con biglietto, modificarli, diretta, vedere chi partecipa | `create_event`, `start_live_stream` | | [Membri](/mcp/ferramentas-membros) | Invitare una persona o una classe, cambiare ruoli, rimuovere, gruppi, tag e organigramma | `invite_members`, `update_member_role`, `create_group` | | [Vendite e piani](/mcp/ferramentas-vendas) | Piani, opzioni, componenti aggiuntivi, prodotti, prezzi, coupon e downsell, in bozza fino all'approvazione | `create_plan`, `update_coupon` | | [Abbonamenti](/mcp/ferramentas-assinaturas) | Chi è abbonato a cosa, omaggi, sconti, estensioni e annullamenti; i tuoi abbonamenti | `list_subscriptions`, `manage_my_subscription` | | [Finanze](/mcp/ferramentas-financeiro) | Vendite, estratto conto, saldo, prelievi e la commissione | `get_sales_summary`, `request_payout` | | [Certificati](/mcp/ferramentas-certificados) | Modelli con l'anteprima nella conversazione, rilascio alla classe, revoca | `create_certificate_template`, `issue_certificate` | | [Call for papers](/mcp/ferramentas-chamada) | L'intero ciclo: aprire la call, comitato, punteggi, decisione, negoziazione, programma e votazione; e il lato di chi propone | `create_call_for_papers`, `review_proposal`, `submit_proposal` | | [Report e grafici](/mcp/relatorios-e-graficos) | Vendite, MRR, membri attivi, coinvolgimento e classifica, eventi e corsi, con il grafico nella conversazione | `sales_report`, `community_overview` | Ogni strumento si limita a consultare, modifica qualcosa subito oppure chiede la tua conferma prima di agire; l'etichetta di ciascuno è nell'elenco. L'elenco completo, con il ruolo minimo di ciascuno, è in [Strumenti](/mcp/ferramentas). Dopo aver mostrato dati o concluso un'azione, Memberfy suggerisce all'assistente fino a tre prossimi passi adatti a ciò che è tornato e al tuo ruolo. Vedi [Prossimi passi](/mcp/ferramentas#prossimi-passi). In Claude, otto richieste frequenti sono anche pronte nel menu: vedi [Ricette pronte nel menu](/mcp/conectar-o-claude#ricette-pronte-nel-menu). ### Denaro ed eliminazioni solo con il tuo sì Nessuno strumento di denaro o di eliminazione agisce alla prima chiamata. Restituisce un **riepilogo** (il coupon, lo sconto, la validità; il prezzo attuale e quello nuovo; l'importo del prelievo e il saldo) e un codice di conferma. L'assistente ti mostra il riepilogo, tu rispondi "sì", e solo allora ripete la chiamata con il codice. Il codice vale **10 minuti**, si usa **una volta** e funziona solo con **gli stessi valori** del riepilogo. Il resto (inviti, ruoli, impostazioni, certificati) viene eseguito alla prima chiamata, come un clic nel pannello. Vedi [Denaro e conferma](/mcp/dinheiro-e-confirmacao). ### Cosa non esce mai L'assistente vede ciò che vede il tuo ruolo, e niente di più. Negli importi compare la [commissione della piattaforma](/pagamentos/taxa-da-plataforma); i costi interni di elaborazione non fanno parte di nessuna risposta, nemmeno per il proprietario. ## Un esempio, dalla richiesta al risultato Marina è la proprietaria della community *Fogli che Pensano*, ha collegato Claude e ha scritto: > Crea il corso "Excel da Zero" nello spazio corsi che esiste già: 3 moduli (Fondamenti, Formule, Tabelle pivot), con 3 lezioni video ciascuno. Crea anche il prodotto per vendere il corso a R$ 297 fino a 10 rate, ma lascialo in bozza. Cosa ha fatto l'assistente, strumento per strumento: | # | Strumento | A cosa serve | Risultato | |---|---|---|---| | 1 | `get_community_context` | Sapere in quale community e con quale ruolo si trova, e trovare sezioni e spazi | Proprietaria; sezione *Imparare* con lo spazio *Corsi* (modulo `courses`) | | 2 | `create_course` | Costruire tutto in una volta, con `space_id` dello spazio *Corsi*, i 3 moduli con 3 lezioni `video` ciascuno, e `sale` con `price: 297`, `max_installments: 10` | Il corso, 3 moduli, 9 lezioni e il prodotto *Excel da Zero* in bozza, che sblocca lo spazio *Corsi* | E ha risposto: > Fatto. Ho creato il corso **Excel da Zero** nello spazio *Corsi*, con i moduli Fondamenti, Formule e Tabelle pivot e 3 lezioni ciascuno (9 in totale). Il prodotto **Excel da Zero**, da R$ 297,00 fino a 10 rate con carta, è in **bozza**: quando vuoi vendere, chiedimi di pubblicarlo. Le lezioni non hanno ancora contenuto; quello lo inserisci dal pannello. In Memberfy, Marina trova il corso nello spazio e il prodotto in **Monetizzazione › Prodotti**, in bozza. Se dice "puoi pubblicare", l'assistente chiama `publish_product`. Se durante la costruzione un passaggio fosse fallito (per esempio, lo spazio indicato non fosse di corsi), `create_course` avrebbe annullato tutto ciò che aveva già creato e spiegato il motivo, senza lasciare un corso a metà. Altre richieste pronte, con la sequenza di strumenti attesa, sono in [Ricette](/mcp/receitas). ## Cosa si può e cosa non si può fare | Si può | Non ancora | |---|---| | Creare sezioni, spazi, post, commenti e reazioni; fissare post | Programmare un post per dopo | | Creare, modificare ed eliminare corsi, moduli e lezioni (titolo, tipo, durata) | Salvare il contenuto di una lezione (testo, video) | | Creare eventi online, dal vivo o ibridi, con biglietto | Iscrivere automaticamente chi ha comprato il biglietto alla lista dei partecipanti | | Creare opzioni di fatturazione, prodotti e piani con componenti aggiuntivi; pubblicare e ritirare dalla vendita; cambiare il tuo piano (con conferma) | Cambiare il piano di un altro abbonato | | Creare coupon, cambiare prezzi, chiedere e annullare prelievi, annullare abbonamenti (con conferma) | Fare rimborsi | | Invitare una persona o una classe, cambiare ruoli, organizzare gruppi, tag e organigramma (con conferma per rimuovere qualcuno) | Moderare più elementi in una sola chiamata (l'assistente modera uno alla volta) | | Leggere vendite, abbonamenti, estratto conto, saldo e prelievi; cambiare nome, colori, logo, SEO, lingua e regole di accesso | Cambiare il dominio e le integrazioni | | Creare modelli di certificato e rilasciarli a una classe; decidere le proposte della call for papers; cambiare la classifica e il negozio | Cambiare il piano di un altro abbonato (ognuno cambia il proprio) | Ciò che non si può ancora fare resta nel pannello, come sempre. Vedi [Problemi comuni](/mcp/problemas-comuns#cosa-non-si-puo-ancora-fare). ## Chi può usarlo Chiunque abbia un account Memberfy e un ruolo in una community: ciò che l'assistente riesce a fare dipende da quel ruolo. | Ruolo | In pratica | |---|---| | **Proprietario** e **Admin** | Tutto ciò che offre l'MCP: costruire struttura, corsi, eventi, piani, coupon; vedere e muovere denaro, con conferma | | **Moderatore** | Leggere la community e i membri, pubblicare, commentare, fissare post, creare eventi senza biglietto | | **Finanza** | Leggere vendite, abbonamenti, estratto conto, saldo e prelievi; annullare abbonamenti, con conferma; pubblicare e commentare | | **Membro** | Leggere ciò che già vede, pubblicare dove già poteva, commentare e reagire | ## Da dove iniziare 1. Collega il tuo assistente: [Claude](/mcp/conectar-o-claude), [ChatGPT](/mcp/conectar-o-chatgpt) oppure [Claude Code e Cursor](/mcp/conectar-claude-code-e-cursor). 2. Chiedi prima qualcosa in lettura, per verificare il collegamento: *"A quale community sei collegato, e con quale ruolo?"*. 3. Prova una [ricetta](/mcp/receitas). 4. Leggi [Sicurezza e limiti](/mcp/seguranca) prima di dare accesso ad altre persone del team. ## Domande frequenti **Devo saper programmare?** No. In Claude e in ChatGPT, collegarsi significa incollare un indirizzo e cliccare **Consenti**. L'[API](/api/introducao) è per chi vuole integrare con il codice; l'MCP è per chi vuole conversare. **L'assistente ricorda cosa ha fatto ieri?** A ricordare è l'assistente, a seconda della conversazione. Memberfy conserva il risultato: ciò che è stato creato è nel pannello, e ogni azione dell'assistente resta registrata e compare al proprietario e agli amministratori in **Membri › Log**. Vedi [Registro attività](/membros/registros-de-atividades). **L'assistente può eliminare cose?** Sì, con la tua conferma. Ci sono strumenti per eliminare post, commenti, sezioni, spazi, eventi, corsi, gruppi, tag, certificati e altro (iniziano tutti con `delete_`, `remove_`, `revoke_`, `withdraw_` o `cancel_`), e nessuno agisce alla prima chiamata: mostra cosa verrà eliminato, rispondi "sì" e solo allora l'assistente ripete la chiamata con il codice. È la stessa conferma in due passaggi usata per il denaro; vedi [Denaro e conferma](/mcp/dinheiro-e-confirmacao). Gli strumenti composti annullano solo ciò che hanno appena creato loro stessi, quando un passaggio fallisce. **E se l'assistente capisce male?** Ciò che non riguarda il denaro né un'eliminazione viene fatto subito, come se avessi cliccato tu: controlla il risultato e correggi dal pannello o chiedendo di nuovo. Ciò che riguarda il denaro o elimina avviene solo dopo il tuo sì al riepilogo. **Ha un costo?** Il server MCP fa parte di Memberfy. L'assistente (Claude, ChatGPT, Cursor) ha i suoi piani. ## Correlati - [Strumenti](/mcp/ferramentas) - [Denaro e conferma](/mcp/dinheiro-e-confirmacao) - [Sicurezza e limiti](/mcp/seguranca) - [Problemi comuni](/mcp/problemas-comuns)