# Strumenti

> I 188 strumenti del server MCP di Memberfy, organizzati per tema (community, contenuti, corsi, eventi, membri, vendite, abbonamenti, finanze, certificati, call for papers e report), con il ruolo minimo e il tipo di ciascuno, e le regole comuni a tutti.

Il server MCP di Memberfy ha **188 strumenti**, che coprono tutti i moduli della community: l'assistente fa ciò che l'app permette alla persona collegata, con il suo ruolo. L'assistente sceglie da solo quale usare in base alla tua richiesta; questa pagina e quelle di ogni tema servono a farti sapere cosa riesce a fare, con quale ruolo, e come chiederlo. I nomi sono in inglese, come li vede l'assistente, e sono gli stessi in ogni lingua; il titolo che compare in Claude o in ChatGPT è nella lingua di chi ha collegato.

## Per tema

| Tema | Cosa si può fare | Strumenti |
|---|---|---|
| [Community e struttura](/mcp/ferramentas-comunidade) | Il contesto del collegamento, aprire un link dell'app, creare, modificare, riordinare ed eliminare sezioni e spazi, chi vede ciascuno, impostazioni e lingua, avvisi di vendita | 16 |
| [Contenuti e coinvolgimento](/mcp/ferramentas-conteudo) | Post e post brevi, spostare un post, commenti, reazioni, fissare, ricerca, galleria, classifica e moderazione | 24 |
| [Corsi](/mcp/ferramentas-cursos) | Corsi interi, copertina, stato, moduli e lezioni (creare, modificare, spostare, eliminare), iscrizione e avanzamento | 13 |
| [Eventi](/mcp/ferramentas-eventos) | Eventi, biglietti, presenze, diretta, banner ed eliminazione | 8 |
| [Membri](/mcp/ferramentas-membros) | Elencare, invitare, cambiare ruoli, rimuovere, gruppi, tag e organigramma | 16 |
| [Vendite e piani](/mcp/ferramentas-vendas) | Piani, opzioni, componenti aggiuntivi, prodotti, prezzi, coupon, downsell e negozio, in bozza fino all'approvazione | 24 |
| [Abbonamenti](/mcp/ferramentas-assinaturas) | Chi è abbonato a cosa, CSV, omaggi, sconti, estensioni e annullamenti; i tuoi abbonamenti e acquisti, e cambiare il tuo piano | 13 |
| [Finanze](/mcp/ferramentas-financeiro) | Vendite, clienti, estratto conto, saldo, prelievi e commissione | 8 |
| [Certificati](/mcp/ferramentas-certificados) | Modelli, chi rilascia, rilascio, reinvio, revoca e nuovo rilascio; i tuoi certificati | 16 |
| [Call for papers](/mcp/ferramentas-chamada) | L'intero ciclo: aprire la call, track e giorni, responsabili e revisori, proposte, punteggi, decisione, negoziazione, programma e votazione | 40 |
| [Report e grafici](/mcp/relatorios-e-graficos) | Vendite, MRR, membri attivi, coinvolgimento e classifica, eventi, corsi, l'attività di un membro e il pannello del mese, pronti per diventare un grafico | 8 |

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.

## Tutti gli strumenti

**Ruolo minimo**: il ruolo più basso con cui lo strumento compare. "Qualsiasi" include il membro. Finanza è indicato a parte perché non rientra nella scala degli altri ruoli.

| Strumento | Tema | Ruolo minimo | Tipo | Cosa fa |
|---|---|---|---|---|
| [`get_community_context`](/mcp/ferramentas-comunidade#get-community-context) | Community e struttura | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | Community, ruolo, sezioni e spazi con gli id: il punto di partenza |
| [`get_connection_diagnostics`](/mcp/ferramentas-comunidade#get-connection-diagnostics) | Community e struttura | Amministratore | <span class="tool-kind tool-kind-read">Solo lettura</span> | Se l'elenco di strumenti dell'assistente è aggiornato |
| [`list_spaces`](/mcp/ferramentas-comunidade#list-spaces) | Community e struttura | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | Sezioni e spazi, con filtro per modulo |
| [`open_link`](/mcp/ferramentas-comunidade#open-link) | Community e struttura | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | Dice cos'è un link copiato dall'app (o un id) |
| [`create_section`](/mcp/ferramentas-comunidade#create-section) | Community e struttura | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Crea una sezione del menu |
| [`create_space`](/mcp/ferramentas-comunidade#create-space) | Community e struttura | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Crea uno spazio in una sezione, con icona |
| [`update_space`](/mcp/ferramentas-comunidade#update-space) | Community e struttura | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Cambia nome, descrizione, icona o visibilità di uno spazio, o lo sposta in un'altra sezione |
| [`update_section`](/mcp/ferramentas-comunidade#update-section) | Community e struttura | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Cambia nome, descrizione, icona di una sezione, o la rende quella iniziale |
| [`reorder_sections`](/mcp/ferramentas-comunidade#reorder-sections) | Community e struttura | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Mette le sezioni del menu in un nuovo ordine |
| [`reorder_spaces`](/mcp/ferramentas-comunidade#reorder-spaces) | Community e struttura | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Mette gli spazi di una sezione in un nuovo ordine |
| [`update_space_access`](/mcp/ferramentas-comunidade#update-space-access) | Community e struttura | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Chi vede uno spazio o una sezione, e chi pubblica nello spazio |
| [`delete_section`](/mcp/ferramentas-comunidade#delete-section) | Community e struttura | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Elimina una sezione e i suoi spazi |
| [`delete_space`](/mcp/ferramentas-comunidade#delete-space) | Community e struttura | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Elimina uno spazio |
| [`get_community_settings`](/mcp/ferramentas-comunidade#get-community-settings) | Community e struttura | Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> | Le impostazioni della community: nome, colori, immagini, SEO, lingua, accesso |
| [`update_community_settings`](/mcp/ferramentas-comunidade#update-community-settings) | Community e struttura | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Cambia nome, colori, logo, favicon, SEO, lingua e regole di accesso |
| [`get_notification_settings`](/mcp/ferramentas-comunidade#get-notification-settings) | Community e struttura | Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> | L'e-mail che riceve gli avvisi di vendita |
| [`update_notification_settings`](/mcp/ferramentas-comunidade#update-notification-settings) | Community e struttura | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Cambia o disattiva l'e-mail degli avvisi di vendita |
| [`list_posts`](/mcp/ferramentas-conteudo#list-posts) | Contenuti e coinvolgimento | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | Il feed, con commenti e reazioni |
| [`search_content`](/mcp/ferramentas-conteudo#search-content) | Contenuti e coinvolgimento | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | Cerca post, eventi, corsi, sezioni, spazi e call per titolo |
| [`list_comments`](/mcp/ferramentas-conteudo#list-comments) | Contenuti e coinvolgimento | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | Commenti di un post |
| [`create_post`](/mcp/ferramentas-conteudo#create-post) | Contenuti e coinvolgimento | Qualsiasi | <span class="tool-kind tool-kind-write">Modifica</span> | Pubblica un post, con copertina tramite link |
| [`update_post`](/mcp/ferramentas-conteudo#update-post) | Contenuti e coinvolgimento | Autore o moderatore | <span class="tool-kind tool-kind-write">Modifica</span> | Modifica titolo, testo, copertina; fissa |
| [`delete_post`](/mcp/ferramentas-conteudo#delete-post) | Contenuti e coinvolgimento | Autore o moderatore | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Elimina un post, con conferma |
| [`move_post`](/mcp/ferramentas-conteudo#move-post) | Contenuti e coinvolgimento | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> | Sposta un post in un altro spazio Contenuti o Feed |
| [`create_short_post`](/mcp/ferramentas-conteudo#create-short-post) | Contenuti e coinvolgimento | Membro (non la finanza) | <span class="tool-kind tool-kind-write">Modifica</span> | Pubblica un post breve, senza titolo, in un Feed |
| [`create_comment`](/mcp/ferramentas-conteudo#create-comment) | Contenuti e coinvolgimento | Qualsiasi | <span class="tool-kind tool-kind-write">Modifica</span> | Commenta o risponde |
| [`update_comment`](/mcp/ferramentas-conteudo#update-comment) | Contenuti e coinvolgimento | Autore o moderatore | <span class="tool-kind tool-kind-write">Modifica</span> | Modifica un commento |
| [`delete_comment`](/mcp/ferramentas-conteudo#delete-comment) | Contenuti e coinvolgimento | Autore o moderatore | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Elimina un commento, con conferma |
| [`add_reaction`](/mcp/ferramentas-conteudo#add-reaction) | Contenuti e coinvolgimento | Qualsiasi | <span class="tool-kind tool-kind-write">Modifica</span> | Reagisce con un'emoji |
| [`pin_post`](/mcp/ferramentas-conteudo#pin-post) | Contenuti e coinvolgimento | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> | Fissa o sgancia nel feed |
| [`add_gallery_image`](/mcp/ferramentas-conteudo#add-gallery-image) | Contenuti e coinvolgimento | Qualsiasi | <span class="tool-kind tool-kind-write">Modifica</span> | Mette un'immagine, tramite link, in una galleria |
| [`list_gallery_images`](/mcp/ferramentas-conteudo#list-gallery-images) | Contenuti e coinvolgimento | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | Le immagini di una galleria, con autore e reazioni |
| [`update_gallery_image`](/mcp/ferramentas-conteudo#update-gallery-image) | Contenuti e coinvolgimento | Autore o moderatore | <span class="tool-kind tool-kind-write">Modifica</span> | Cambia il titolo o la descrizione di un'immagine |
| [`react_to_gallery_image`](/mcp/ferramentas-conteudo#react-to-gallery-image) | Contenuti e coinvolgimento | Qualsiasi | <span class="tool-kind tool-kind-write">Modifica</span> | Reagisce a un'immagine della galleria |
| [`delete_gallery_image`](/mcp/ferramentas-conteudo#delete-gallery-image) | Contenuti e coinvolgimento | Autore o moderatore | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Elimina un'immagine della galleria |
| [`get_leaderboard`](/mcp/ferramentas-conteudo#get-leaderboard) | Contenuti e coinvolgimento | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | La parte alta della classifica |
| [`get_my_points`](/mcp/ferramentas-conteudo#get-my-points) | Contenuti e coinvolgimento | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | I tuoi punti e la tua posizione in classifica |
| [`get_ranking_rules`](/mcp/ferramentas-conteudo#get-ranking-rules) | Contenuti e coinvolgimento | Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> | Se la classifica è attiva e i punti per azione |
| [`update_ranking_rules`](/mcp/ferramentas-conteudo#update-ranking-rules) | Contenuti e coinvolgimento | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Attiva, disattiva e cambia i punti |
| [`list_moderation_queue`](/mcp/ferramentas-conteudo#list-moderation-queue) | Contenuti e coinvolgimento | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> | Ciò che attende approvazione |
| [`moderate_item`](/mcp/ferramentas-conteudo#moderate-item) | Contenuti e coinvolgimento | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> | Approva o rifiuta un elemento della coda |
| [`list_courses`](/mcp/ferramentas-cursos#list-courses) | Corsi | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | Corsi della community |
| [`get_course`](/mcp/ferramentas-cursos#get-course) | Corsi | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | Un corso con moduli e lezioni |
| [`create_course`](/mcp/ferramentas-cursos#create-course) | Corsi | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Spazio, corso, moduli, lezioni e il prodotto, in una volta |
| [`update_course`](/mcp/ferramentas-cursos#update-course) | Corsi | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Modifica un corso, la copertina e lo stato |
| [`create_course_module`](/mcp/ferramentas-cursos#create-course-module) | Corsi | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Aggiunge un modulo a un corso |
| [`create_lesson`](/mcp/ferramentas-cursos#create-lesson) | Corsi | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Aggiunge una lezione a un modulo |
| [`update_course_module`](/mcp/ferramentas-cursos#update-course-module) | Corsi | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Rinomina un modulo o ne cambia la posizione |
| [`update_lesson`](/mcp/ferramentas-cursos#update-lesson) | Corsi | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Cambia una lezione, o la porta in un altro modulo |
| [`delete_course_module`](/mcp/ferramentas-cursos#delete-course-module) | Corsi | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Elimina un modulo con le sue lezioni |
| [`delete_lesson`](/mcp/ferramentas-cursos#delete-lesson) | Corsi | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Elimina una lezione |
| [`delete_course`](/mcp/ferramentas-cursos#delete-course) | Corsi | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Elimina un corso |
| [`enroll_in_course`](/mcp/ferramentas-cursos#enroll-in-course) | Corsi | Membro (non la finanza) | <span class="tool-kind tool-kind-write">Modifica</span> | Ti iscrive a un corso pubblicato |
| [`complete_lesson`](/mcp/ferramentas-cursos#complete-lesson) | Corsi | Membro (non la finanza) | <span class="tool-kind tool-kind-write">Modifica</span> | Registra il tuo avanzamento in una lezione |
| [`list_events`](/mcp/ferramentas-eventos#list-events) | Eventi | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | Eventi prossimi, passati, i miei o tutti |
| [`list_event_attendees`](/mcp/ferramentas-eventos#list-event-attendees) | Eventi | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | Chi ha confermato la presenza a un evento |
| [`create_event`](/mcp/ferramentas-eventos#create-event) | Eventi | Moderatore (con biglietto, Admin) | <span class="tool-kind tool-kind-write">Modifica</span> | Spazio, evento e il biglietto, in una volta |
| [`update_event`](/mcp/ferramentas-eventos#update-event) | Eventi | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> | Modifica un evento e il banner |
| [`start_live_stream`](/mcp/ferramentas-eventos#start-live-stream) | Eventi | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> | Segna l'evento come in diretta, con il link della trasmissione |
| [`stop_live_stream`](/mcp/ferramentas-eventos#stop-live-stream) | Eventi | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> | Termina la diretta |
| [`rsvp_event`](/mcp/ferramentas-eventos#rsvp-event) | Eventi | Membro (non la finanza) | <span class="tool-kind tool-kind-write">Modifica</span> | Dice se partecipi: parteciperò, forse o non parteciperò |
| [`delete_event`](/mcp/ferramentas-eventos#delete-event) | Eventi | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Elimina un evento |
| [`list_members`](/mcp/ferramentas-membros#list-members) | Membri | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> | Membri con ruolo e data di ingresso |
| [`invite_member`](/mcp/ferramentas-membros#invite-member) | Membri | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Invita una persona, con ruolo, gruppi e tag |
| [`invite_members`](/mcp/ferramentas-membros#invite-members) | Membri | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Invita fino a 100 persone in una volta, con il risultato riga per riga |
| [`update_member_role`](/mcp/ferramentas-membros#update-member-role) | Membri | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Cambia il ruolo di un membro |
| [`remove_member`](/mcp/ferramentas-membros#remove-member) | Membri | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Toglie una persona dalla community |
| [`list_groups`](/mcp/ferramentas-membros#list-groups) | Membri | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> | Gruppi, con colore, responsabile, gruppo padre e quante persone |
| [`create_group`](/mcp/ferramentas-membros#create-group) | Membri | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> | Crea un gruppo di membri |
| [`update_group`](/mcp/ferramentas-membros#update-group) | Membri | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> | Rinomina o modifica un gruppo |
| [`delete_group`](/mcp/ferramentas-membros#delete-group) | Membri | Moderatore | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Elimina un gruppo; le persone restano nella community |
| [`update_group_members`](/mcp/ferramentas-membros#update-group-members) | Membri | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> | Aggiunge o toglie persone da un gruppo |
| [`list_tags`](/mcp/ferramentas-membros#list-tags) | Membri | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> | Tag usati, con colore e quante persone |
| [`update_member_tags`](/mcp/ferramentas-membros#update-member-tags) | Membri | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> | Aggiunge o toglie tag a una o più persone |
| [`update_tag`](/mcp/ferramentas-membros#update-tag) | Membri | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> | Rinomina un tag o ne cambia il colore |
| [`delete_tag`](/mcp/ferramentas-membros#delete-tag) | Membri | Moderatore | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Toglie un tag a tutte le persone |
| [`get_org_chart`](/mcp/ferramentas-membros#get-org-chart) | Membri | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> | Chi risponde a chi, con i gruppi |
| [`set_manager`](/mcp/ferramentas-membros#set-manager) | Membri | Moderatore | <span class="tool-kind tool-kind-write">Modifica</span> | Indica a chi risponde una persona |
| [`list_activity_logs`](/mcp/ferramentas-membros#list-activity-logs) | Membri | Amministratore | <span class="tool-kind tool-kind-read">Solo lettura</span> | Chi ha fatto cosa: team, assistente e membri |
| [`list_plans`](/mcp/ferramentas-vendas#list-plans) | Vendite e piani | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> | Piani, opzioni e componenti aggiuntivi |
| [`list_products`](/mcp/ferramentas-vendas#list-products) | Vendite e piani | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> | Opzioni di fatturazione e prodotti, con prezzo e stato |
| [`list_coupons`](/mcp/ferramentas-vendas#list-coupons) | Vendite e piani | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> | Coupon con stato e utilizzi |
| [`create_product`](/mcp/ferramentas-vendas#create-product) | Vendite e piani | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Crea un prodotto o un'opzione di fatturazione, in bozza |
| [`create_plan`](/mcp/ferramentas-vendas#create-plan) | Vendite e piani | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Opzioni, piano e componenti aggiuntivi, in una volta |
| [`publish_product`](/mcp/ferramentas-vendas#publish-product) | Vendite e piani | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Mette in vendita un prodotto |
| [`unpublish_product`](/mcp/ferramentas-vendas#unpublish-product) | Vendite e piani | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Ritira un prodotto dalla vendita |
| [`update_price`](/mcp/ferramentas-vendas#update-price) | Vendite e piani | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Cambia un prezzo, con conferma |
| [`create_coupon`](/mcp/ferramentas-vendas#create-coupon) | Vendite e piani | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Crea un coupon, con conferma |
| [`update_plan`](/mcp/ferramentas-vendas#update-plan) | Vendite e piani | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Cambia nome, indirizzo, opzioni e componenti aggiuntivi di un piano |
| [`update_product`](/mcp/ferramentas-vendas#update-product) | Vendite e piani | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Cambia titolo, spazi, giacenza, rate, prova e link diretto |
| [`update_coupon_status`](/mcp/ferramentas-vendas#update-coupon-status) | Vendite e piani | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Mette in pausa o riattiva un coupon |
| [`update_coupon`](/mcp/ferramentas-vendas#update-coupon) | Vendite e piani | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Cambia nome, sconto, durata, limiti, validità e prodotti di un coupon |
| [`delete_coupon`](/mcp/ferramentas-vendas#delete-coupon) | Vendite e piani | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Elimina un coupon |
| [`get_coupon_usage`](/mcp/ferramentas-vendas#get-coupon-usage) | Vendite e piani | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> | Chi ha usato un coupon |
| [`list_downsell_offers`](/mcp/ferramentas-vendas#list-downsell-offers) | Vendite e piani | Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> | Le offerte dell'ultima occasione di un piano, con la conversione |
| [`create_downsell_offer`](/mcp/ferramentas-vendas#create-downsell-offer) | Vendite e piani | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Crea un'offerta dell'ultima occasione |
| [`update_downsell_offer`](/mcp/ferramentas-vendas#update-downsell-offer) | Vendite e piani | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Cambia o mette in pausa un'offerta dell'ultima occasione |
| [`delete_downsell_offer`](/mcp/ferramentas-vendas#delete-downsell-offer) | Vendite e piani | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Elimina un'offerta dell'ultima occasione |
| [`delete_product`](/mcp/ferramentas-vendas#delete-product) | Vendite e piani | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Elimina un prodotto o un'opzione di fatturazione |
| [`delete_plan`](/mcp/ferramentas-vendas#delete-plan) | Vendite e piani | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Elimina un piano |
| [`reorder_plans`](/mcp/ferramentas-vendas#reorder-plans) | Vendite e piani | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Mette i piani in un nuovo ordine nella pagina dei prezzi |
| [`get_storefront`](/mcp/ferramentas-vendas#get-storefront) | Vendite e piani | Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> | Cosa mostra uno spazio Negozio |
| [`update_storefront`](/mcp/ferramentas-vendas#update-storefront) | Vendite e piani | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Sceglie i prodotti di un Negozio |
| [`list_subscriptions`](/mcp/ferramentas-assinaturas#list-subscriptions) | Abbonamenti | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> | Abbonamenti con stato, importo e prossimo addebito |
| [`cancel_subscription`](/mcp/ferramentas-assinaturas#cancel-subscription) | Abbonamenti | Admin o Finanza | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Annulla l'abbonamento di un membro, con conferma |
| [`get_subscription`](/mcp/ferramentas-assinaturas#get-subscription) | Abbonamenti | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> | Un abbonamento, con addebiti e prossimo addebito |
| [`create_manual_subscription`](/mcp/ferramentas-assinaturas#create-manual-subscription) | Abbonamenti | Admin o Finanza | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Omaggio o addebito futuro, senza checkout |
| [`update_subscription`](/mcp/ferramentas-assinaturas#update-subscription) | Abbonamenti | Admin o Finanza | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Sconto, estensione, componenti aggiuntivi, riattivazione, link di pagamento |
| [`export_subscriptions_csv`](/mcp/ferramentas-assinaturas#export-subscriptions-csv) | Abbonamenti | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> | Gli abbonamenti in CSV, con gli stessi filtri |
| [`list_my_subscriptions`](/mcp/ferramentas-assinaturas#list-my-subscriptions) | Abbonamenti | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | I tuoi abbonamenti |
| [`list_my_purchases`](/mcp/ferramentas-assinaturas#list-my-purchases) | Abbonamenti | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | I tuoi acquisti singoli |
| [`manage_my_subscription`](/mcp/ferramentas-assinaturas#manage-my-subscription) | Abbonamenti | Qualsiasi | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Annulla, mette in pausa, riprende o riattiva il tuo abbonamento |
| [`quote_plan_change`](/mcp/ferramentas-assinaturas#quote-plan-change) | Abbonamenti | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | Quanto costa e cosa cambia passando a un altro piano |
| [`change_my_plan`](/mcp/ferramentas-assinaturas#change-my-plan) | Abbonamenti | Qualsiasi | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Cambia il tuo piano: subito, addebitando la differenza sulla carta salvata, o alla fine del periodo |
| [`get_scheduled_plan_change`](/mcp/ferramentas-assinaturas#get-scheduled-plan-change) | Abbonamenti | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | Il cambio di piano programmato per la fine del periodo |
| [`cancel_scheduled_plan_change`](/mcp/ferramentas-assinaturas#cancel-scheduled-plan-change) | Abbonamenti | Qualsiasi | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Annulla il cambio di piano programmato |
| [`get_sales_summary`](/mcp/ferramentas-financeiro#get-sales-summary) | Finanze | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> | Ricavi, serie mensile, ricavi per prodotto e abbonati |
| [`list_customers`](/mcp/ferramentas-financeiro#list-customers) | Finanze | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> | Chi paga e quanto ha già pagato |
| [`list_ledger_entries`](/mcp/ferramentas-financeiro#list-ledger-entries) | Finanze | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> | Movimenti dell'estratto conto |
| [`get_balance`](/mcp/ferramentas-financeiro#get-balance) | Finanze | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> | Saldo totale, disponibile, trattenuto e da liberare |
| [`list_payouts`](/mcp/ferramentas-financeiro#list-payouts) | Finanze | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> | Prelievi e stato |
| [`simulate_fee`](/mcp/ferramentas-financeiro#simulate-fee) | Finanze | Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> | Quanto riceve la community da una vendita |
| [`request_payout`](/mcp/ferramentas-financeiro#request-payout) | Finanze | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Richiede un prelievo, con conferma |
| [`cancel_payout`](/mcp/ferramentas-financeiro#cancel-payout) | Finanze | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Annulla un prelievo in sospeso, con conferma |
| [`list_certificate_templates`](/mcp/ferramentas-certificados#list-certificate-templates) | Certificati | Moderatore o Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> | Modelli di uno spazio Certificati |
| [`get_certificate_template`](/mcp/ferramentas-certificados#get-certificate-template) | Certificati | Moderatore o Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> | Un modello, con l'anteprima come immagine |
| [`create_certificate_template`](/mcp/ferramentas-certificados#create-certificate-template) | Certificati | Moderatore o Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Crea un modello, dal design della piattaforma o con la grafica del brand |
| [`update_certificate_template`](/mcp/ferramentas-certificados#update-certificate-template) | Certificati | Moderatore o Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Cambia testi, firmatari, caselle e grafica |
| [`activate_certificate_template`](/mcp/ferramentas-certificados#activate-certificate-template) | Certificati | Moderatore o Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Attiva o archivia un modello |
| [`issue_certificate`](/mcp/ferramentas-certificados#issue-certificate) | Certificati | Moderatore o Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Rilascia a persone, gruppi e tag, dopo una prova |
| [`list_issued_certificates`](/mcp/ferramentas-certificados#list-issued-certificates) | Certificati | Moderatore o Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> | I rilasciati, con stato e ricerca |
| [`revoke_certificate`](/mcp/ferramentas-certificados#revoke-certificate) | Certificati | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Revoca un certificato |
| [`reissue_certificate`](/mcp/ferramentas-certificados#reissue-certificate) | Certificati | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Rilascia di nuovo con il nome attuale |
| [`delete_certificate`](/mcp/ferramentas-certificados#delete-certificate) | Certificati | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Elimina un certificato revocato o fallito |
| [`duplicate_certificate_template`](/mcp/ferramentas-certificados#duplicate-certificate-template) | Certificati | Moderatore o Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Copia un modello come nuova bozza |
| [`update_certificate_space_settings`](/mcp/ferramentas-certificados#update-certificate-space-settings) | Certificati | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Chi rilascia nello spazio: lo staff o solo gli Admin |
| [`resend_certificate_email`](/mcp/ferramentas-certificados#resend-certificate-email) | Certificati | Moderatore o Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Invia di nuovo l'e-mail del certificato |
| [`retry_certificate`](/mcp/ferramentas-certificados#retry-certificate) | Certificati | Moderatore o Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Rifà un certificato fallito |
| [`list_my_certificates`](/mcp/ferramentas-certificados#list-my-certificates) | Certificati | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | I tuoi certificati, con codice e link |
| [`set_certificate_indexing`](/mcp/ferramentas-certificados#set-certificate-indexing) | Certificati | Qualsiasi | <span class="tool-kind tool-kind-write">Modifica</span> | Mostra o nasconde un tuo certificato nei motori di ricerca |
| [`list_calls_for_papers`](/mcp/ferramentas-chamada#list-calls-for-papers) | Call for papers | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | Le call di uno spazio, con lo stato |
| [`get_call_space_settings`](/mcp/ferramentas-chamada#get-call-space-settings) | Call for papers | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | Come funziona lo spazio: una o più call, chi apre |
| [`update_call_space_settings`](/mcp/ferramentas-chamada#update-call-space-settings) | Call for papers | Admin | <span class="tool-kind tool-kind-write">Modifica</span> | Cambia la modalità dello spazio e chi può aprire una call |
| [`get_call_for_papers`](/mcp/ferramentas-chamada#get-call-for-papers) | Call for papers | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | Una call con date, track, giorni, responsabili e ciò che puoi fare |
| [`create_call_for_papers`](/mcp/ferramentas-chamada#create-call-for-papers) | Call for papers | Chi può aprire | <span class="tool-kind tool-kind-write">Modifica</span> | Apre una call in bozza, con track, giorni e banner |
| [`update_call_for_papers`](/mcp/ferramentas-chamada#update-call-for-papers) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> | Modifica testo, date, formati, costi, compenso e immagini |
| [`update_call_status`](/mcp/ferramentas-chamada#update-call-status) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> | Pubblica, riporta in bozza, chiude o riapre |
| [`delete_call_for_papers`](/mcp/ferramentas-chamada#delete-call-for-papers) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Elimina la call, con track e proposte |
| [`add_call_track`](/mcp/ferramentas-chamada#add-call-track) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> | Aggiunge un track |
| [`update_call_track`](/mcp/ferramentas-chamada#update-call-track) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> | Rinomina un track o ne cambia lo scopo |
| [`delete_call_track`](/mcp/ferramentas-chamada#delete-call-track) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Toglie un track |
| [`add_call_event_date`](/mcp/ferramentas-chamada#add-call-event-date) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> | Aggiunge un giorno all'evento |
| [`update_call_event_date`](/mcp/ferramentas-chamada#update-call-event-date) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> | Cambia l'orario di un giorno |
| [`delete_call_event_date`](/mcp/ferramentas-chamada#delete-call-event-date) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Toglie un giorno dall'evento |
| [`add_call_owner`](/mcp/ferramentas-chamada#add-call-owner) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> | Invita qualcuno a diventare responsabile della call |
| [`remove_call_owner`](/mcp/ferramentas-chamada#remove-call-owner) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Toglie un responsabile |
| [`list_track_reviewers`](/mcp/ferramentas-chamada#list-track-reviewers) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-read">Solo lettura</span> | I revisori di un track |
| [`invite_track_reviewer`](/mcp/ferramentas-chamada#invite-track-reviewer) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> | Mette qualcuno come revisore di un track |
| [`remove_track_reviewer`](/mcp/ferramentas-chamada#remove-track-reviewer) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Toglie un revisore |
| [`list_my_call_invitations`](/mcp/ferramentas-chamada#list-my-call-invitations) | Call for papers | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | I tuoi inviti in sospeso, come responsabile o revisore |
| [`respond_to_call_invitation`](/mcp/ferramentas-chamada#respond-to-call-invitation) | Call for papers | Qualsiasi | <span class="tool-kind tool-kind-write">Modifica</span> | Accetta o rifiuta un tuo invito |
| [`list_speakers`](/mcp/ferramentas-chamada#list-speakers) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-read">Solo lettura</span> | Chi ha già proposto nella community |
| [`invite_speaker`](/mcp/ferramentas-chamada#invite-speaker) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> | Invita qualcuno a proporre |
| [`list_proposals`](/mcp/ferramentas-chamada#list-proposals) | Call for papers | Secondo il ruolo nella call | <span class="tool-kind tool-kind-read">Solo lettura</span> | Le proposte, con stato, track e punteggi |
| [`get_proposal`](/mcp/ferramentas-chamada#get-proposal) | Call for papers | Responsabili, revisori del track e chi ha proposto | <span class="tool-kind tool-kind-read">Solo lettura</span> | Una proposta, con le valutazioni e la negoziazione |
| [`list_my_reviews`](/mcp/ferramentas-chamada#list-my-reviews) | Call for papers | Revisore | <span class="tool-kind tool-kind-read">Solo lettura</span> | La tua coda di revisione |
| [`review_proposal`](/mcp/ferramentas-chamada#review-proposal) | Call for papers | Revisore del track | <span class="tool-kind tool-kind-write">Modifica</span> | Dà un punteggio da 1 a 5 a una proposta |
| [`get_review_progress`](/mcp/ferramentas-chamada#get-review-progress) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-read">Solo lettura</span> | L'avanzamento della valutazione, rispetto al minimo |
| [`get_proposal_reviews`](/mcp/ferramentas-chamada#get-proposal-reviews) | Call for papers | Responsabili; revisori dopo aver valutato | <span class="tool-kind tool-kind-read">Solo lettura</span> | I punteggi di una proposta e il consenso |
| [`decide_proposal`](/mcp/ferramentas-chamada#decide-proposal) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> | Accetta o rifiuta una proposta |
| [`negotiate_proposal`](/mcp/ferramentas-chamada#negotiate-proposal) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> | Controproposta, ritirare, accettare o chiudere la negoziazione |
| [`confirm_proposal`](/mcp/ferramentas-chamada#confirm-proposal) | Call for papers | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> | Conferma nel programma la proposta accettata |
| [`list_votable_proposals`](/mcp/ferramentas-chamada#list-votable-proposals) | Call for papers | Chi può votare | <span class="tool-kind tool-kind-read">Solo lettura</span> | La scheda di voto: cosa puoi votare e il tuo voto |
| [`vote_on_proposal`](/mcp/ferramentas-chamada#vote-on-proposal) | Call for papers | Chi può votare | <span class="tool-kind tool-kind-write">Modifica</span> | Vota da 1 a 5, o toglie il voto |
| [`get_vote_results`](/mcp/ferramentas-chamada#get-vote-results) | Call for papers | Secondo la call | <span class="tool-kind tool-kind-read">Solo lettura</span> | Il risultato, fin dove la call lo mostra |
| [`list_my_proposals`](/mcp/ferramentas-chamada#list-my-proposals) | Call for papers | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> | Le tue proposte, con lo stato |
| [`submit_proposal`](/mcp/ferramentas-chamada#submit-proposal) | Call for papers | Qualsiasi membro | <span class="tool-kind tool-kind-write">Modifica</span> | Invia una proposta a una call aperta |
| [`update_proposal`](/mcp/ferramentas-chamada#update-proposal) | Call for papers | Chi ha proposto | <span class="tool-kind tool-kind-write">Modifica</span> | Modifica la proposta in bozza e la invia |
| [`withdraw_proposal`](/mcp/ferramentas-chamada#withdraw-proposal) | Call for papers | Chi ha proposto | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> | Ritira la proposta dalla call |
| [`respond_to_counter_offer`](/mcp/ferramentas-chamada#respond-to-counter-offer) | Call for papers | Chi ha proposto | <span class="tool-kind tool-kind-write">Modifica</span> | Accetta la controproposta o risponde con un'altra |
| [`sales_report`](/mcp/relatorios-e-graficos#sales-report) | Report e grafici | Admin o finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> | Vendite per giorno, settimana o mese, per piano, prodotto o metodo di pagamento, e il totale dalla prima vendita |
| [`subscriptions_report`](/mcp/relatorios-e-graficos#subscriptions-report) | Report e grafici | Admin o finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> | MRR, abbonamenti nuovi e annullati, churn, omaggi e downsell |
| [`members_report`](/mcp/relatorios-e-graficos#members-report) | Report e grafici | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> | Membri nuovi, attivi e inattivi, per gruppo e per tag |
| [`engagement_report`](/mcp/relatorios-e-graficos#engagement-report) | Report e grafici | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> | Post, commenti, reazioni, chi partecipa di più, post senza risposta e i punti della classifica |
| [`events_report`](/mcp/relatorios-e-graficos#events-report) | Report e grafici | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> | Eventi e quanti hanno risposto ci sarò, forse e non ci sarò |
| [`courses_report`](/mcp/relatorios-e-graficos#courses-report) | Report e grafici | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> | Iscrizioni, completamenti e avanzamento per corso |
| [`member_activity`](/mcp/relatorios-e-graficos#member-activity) | Report e grafici | Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> | Cosa ha fatto una persona: conteggi, punti della classifica e link |
| [`community_overview`](/mcp/relatorios-e-graficos#community-overview) | Report e grafici | Moderatore o finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> | Questo mese rispetto al mese scorso, in una sola richiesta |

## Quanti strumenti vede ogni ruolo

| Ruolo | Strumenti |
|---|---|
| **Proprietario** e **Admin** | Tutti e 188 |
| **Moderatore** | 111: i 40 della call for papers, la lettura aperta a tutti, post e post brevi (compresi spostare e fissare), commenti, reazioni e galleria, la moderazione, `create_event`, `update_event` e la diretta, `list_members` e gli 11 di gruppi, tag e organigramma, i modelli, il rilascio, il reinvio e il rifacimento dei certificati (secondo **Chi rilascia** nello spazio), le proprie iscrizioni, presenze, punti, abbonamenti, acquisti e certificati, e i report di membri, coinvolgimento, eventi e corsi e `community_overview` |
| **Finanza** | 90: i 40 della call for papers, la lettura aperta a tutti, post, commenti, reazioni e galleria, la lettura di piani, prodotti e coupon, i 9 di lettura finanziaria, gli abbonamenti della community (elencare, vedere, esportare, omaggio, azioni e annullare), i propri abbonamenti, acquisti, punti e certificati, e i report di vendite e abbonamenti e `community_overview` |
| **Membro** | 76: i 40 della call for papers, la lettura aperta a tutti, post e post brevi, commenti, reazioni e galleria (modificare ed eliminare solo ciò che è tuo), iscrizione e avanzamento nei corsi, presenza agli eventi, e i propri abbonamenti, acquisti, punti e certificati |

I 40 della call for papers compaiono a tutti perché il responsabile di una call può essere un membro qualsiasi, e qualsiasi membro propone, valuta o vota quando la call lo consente. Memberfy controlla ogni call con la regola del modulo. Vedi [Call for papers](/mcp/ferramentas-chamada#chi-usa-cosa).

Un collegamento autorizzato solo in lettura vede solo gli strumenti di lettura del ruolo.

Vedere uno strumento nell'elenco non garantisce che ogni chiamata passi: Memberfy controlla ogni azione come se fosse fatta dalla schermata. Un membro vede `create_post`, ma pubblicare in uno spazio con **Chi può pubblicare = Staff** viene rifiutato. Vedi [Ruoli e permessi](/conceitos/papeis-e-permissoes).

## Regole comuni

### Gli id

Gli strumenti parlano tramite **id**, e dove chiedono un id accettano anche il link copiato dall'app (vedi [`open_link`](/mcp/ferramentas-comunidade#open-link)). Quasi tutte le conversazioni iniziano con `get_community_context`, che restituisce le sezioni e gli spazi con gli id; gli elenchi restituiscono gli id di ciò che elencano. La descrizione di ogni strumento dice da dove viene ogni id, e l'assistente li concatena da solo: tu chiedi *"pubblica nello spazio Avvisi"*, lui cerca l'id dello spazio *Avvisi* e pubblica.

### Paginazione

Gli elenchi accettano `page` (la pagina, a partire da 1) e `limit` (quanti per pagina). La risposta riporta gli elementi e il totale, così l'assistente sa se deve chiedere la pagina successiva.

### Prima la bozza

Tutto ciò che si vende nasce in **bozza**: `create_product`, il prodotto di `create_course`, il biglietto di `create_event` e le opzioni di `create_plan`. Niente va in vendita senza `publish_product` (o `publish: true` nel composto). Così puoi rivedere prima.

La creazione non dipende dalle [informazioni aziendali](/pagamentos/informacao-comercial) approvate; la pubblicazione sì. In una community senza approvazione, il composto che ha chiesto di pubblicare **non annulla nulla**: il corso, l'evento o il piano resta in bozza, la risposta riporta il motivo in `publish_blocked`, e il passo successivo suggerito è compilare le informazioni aziendali e pubblicare dopo. Vedi [Bozza prima dell'approvazione](/mcp/ferramentas-vendas#bozza-prima-dell-approvazione).

### Idempotenza nei composti

I tre composti accettano `idempotency_key` (fino a 100 caratteri). Ripetere la chiamata con la stessa chiave restituisce il risultato della prima, senza creare di nuovo. Serve quando il collegamento cade a metà e l'assistente non sa se la chiamata è andata a buon fine.

### Annullare quando un passaggio fallisce

I composti creano in ordine e, se un passaggio fallisce, eliminano ciò che avevano già creato (tranne quando ciò che è fallito è la pubblicazione senza informazioni aziendali approvate: allora resta tutto in bozza), dal più recente al più vecchio, e dicono quale passaggio è fallito: *"Il passaggio "módulo 2" è fallito e tutto ciò che questa chiamata aveva creato è stato annullato."* Se qualcosa non può essere annullato, la risposta elenca ciò che è rimasto, da controllare nel pannello.

### Prossimi passi

Quando ha senso continuare, la risposta dello strumento porta `next_steps`: fino a **tre azioni suggerite**, ognuna con lo strumento, il motivo (nella lingua di chi ha collegato) e, a volte, gli argomenti già pronti. Dipendono da cosa è tornato e dal tuo ruolo: entrano solo strumenti che puoi usare. L'assistente propone queste azioni prima di suggerire qualsiasi altra cosa, e nessuna avviene senza che tu la chieda.

| Quando | Cosa suggerisce Memberfy |
|---|---|
| Ci sono proposte in attesa di decisione | Decidere ciascuna (`decide_proposal`) |
| Il report di coinvolgimento mostra post senza risposta | Rispondere (`create_comment`) |
| Un post è stato pubblicato senza copertina | Generare un'immagine e usarla come copertina (`update_post`) |
| Un modello di certificato è appena stato creato | Controllare l'anteprima e regolarlo (`update_certificate_template`), poi attivarlo (`activate_certificate_template`) |
| Un report delle vendite | Lo stesso report sul periodo precedente, per confrontare (`sales_report`, con le date già pronte) |
| Elementi in attesa di moderazione | Approvare o rifiutare (`moderate_item`) |
| Abbonamenti in ritardo | Inviare il link di pagamento (`update_subscription`) |
| Saldo disponibile | Richiedere un prelievo (`request_payout`) |
| Un prodotto, corso o biglietto creato in bozza | Pubblicarlo (`publish_product`) |
| La pubblicazione è stata rifiutata perché mancano le informazioni aziendali approvate | Compilare **Impostazioni › Informazioni Aziendali**, attendere l'approvazione e pubblicare (`publish_product`) |
| Una call for papers creata senza track, o ancora in bozza | Aggiungere track (`add_call_track`), assegnare revisori (`invite_track_reviewer`) e pubblicare (`update_call_status`) |
| Una proposta accettata | Confermarla nel programma (`confirm_proposal`) |

### Errori

Quando Memberfy rifiuta, l'assistente riceve il suo messaggio, lo stesso della schermata:

| Situazione | Cosa riceve l'assistente |
|---|---|
| Il ruolo non lo consente | *"Il tuo ruolo (moderator) non consente questa azione in questa community."*, più il motivo |
| Un dato non valido | *"L'API ha rifiutato (400): …"*, con il campo e il messaggio |
| Troppe chiamate | *"Troppe chiamate in poco tempo. Attendi un minuto e riprova."* |

### Versione del server e dell'elenco

Ogni deploy di Memberfy cambia la versione del server, e l'elenco di strumenti che riceve una connessione ha una propria impronta. È così che si capisce se un assistente ha l'elenco aggiornato.

| Dove | Cosa arriva |
|---|---|
| `serverInfo.version`, in `initialize` | `<versione>+<commit>`, per esempio `1.0.0+4a9b547`. Cambia a ogni deploy |
| `_meta.memberfy`, in `initialize` e in `tools/list` | `server_version`, `tools_fingerprint` (un codice breve che cambia quando cambia un nome o uno schema di input dell'elenco che riceve questa connessione) e `tool_count` |
| Le istruzioni del server | Finiscono con una riga che ripete la versione dell'elenco |

Chiamare uno strumento che non è nell'elenco della connessione restituisce un errore di strumento (`isError`) che chiede alla persona di aprire una nuova conversazione o di ricollegarsi; se il nome è uno di quelli vecchi in portoghese, la risposta include `renamed_to` con il nome nuovo. La chiamata resta nell'audit come `tool.unknown`.

Il proprietario e gli amministratori confrontano l'ultimo elenco ricevuto da una connessione con quello attuale in [`GET /api/oauth/connections/{id}/diagnostics`](/api/referencia/mcp/get-oauth-connections-by-id-diagnostics): il campo `listUpToDate` dice se è aggiornato. Vedi [Audit](/mcp/seguranca#audit).

### Chiedono conferma

Chiedono conferma solo gli strumenti che **toccano il denaro** e quelli che **eliminano** (quelli che iniziano con `delete_`, `remove_`, `revoke_`, `withdraw_` o `cancel_`). Con l'etichetta <span class="tool-kind tool-kind-confirm">Chiede conferma</span>, non agiscono alla prima chiamata: restituiscono un riepilogo e un codice, e agiscono solo quando l'assistente ripete la chiamata con il codice, dopo il tuo sì. Tutti gli altri, compresi inviti, cambio di ruolo, impostazioni e rilascio di certificati, vengono eseguiti alla prima chiamata. La tabella qui sopra mostra l'etichetta di ciascuno. Vedi [Denaro e conferma](/mcp/dinheiro-e-confirmacao).

### Testo in Markdown

L'assistente scrive e legge il testo di Memberfy in **Markdown**. Memberfy lo converte nel testo formattato dell'app all'andata, e di nuovo in Markdown al ritorno: il post compare nell'app con grassetto ed elenchi, non con asterischi.

| Campo | Cosa accetta |
|---|---|
| Il testo di un post (`create_post`, `update_post`), la descrizione di un evento (`create_event`, `update_event`), il testo della call for papers (`create_call_for_papers`, `update_call_for_papers`) e la descrizione di una proposta (`submit_proposal`, `update_proposal`) | Markdown completo: **grassetto**, *corsivo*, elenchi, link, sottotitoli (il `#` diventa un sottotitolo di livello 2; non c'è un titolo di livello 1 dentro il testo), citazione e codice |
| Il testo di un post breve (`create_short_post`, oppure `update_post` con `type: status`) | Solo grassetto, corsivo, link e a capo |
| Titoli, nomi, commenti, e la descrizione di corso, prodotto, piano, gruppo, spazio e sezione | Testo semplice: i segni di Markdown vengono tolti, perché l'app mostra questi campi senza formattazione |

Cosa non passa all'app:

- **Un'immagine dentro il testo** diventa un link all'immagine. Per la copertina di un post o il banner di un evento, usa `image_url` (vedi [Immagini](#immagini)).
- **Una tabella** diventa righe di testo, una per riga della tabella.
- Script, attributi di evento e link `javascript:` vengono rimossi.

Anche l'HTML già pronto è accettato e passa dallo stesso filtro. In lettura, gli strumenti restituiscono il testo formattato in Markdown e segnano il risultato con `text_format: "markdown"`. Leggere e salvare di nuovo lo stesso testo non cambia nulla.

### Immagini

`create_post`, `add_gallery_image`, `create_course`, `create_event`, `update_post`, `update_event` e `update_course` accettano l'immagine in due modi:

- `image_url`: il link di un'immagine che si trova su internet. Memberfy la scarica e la conserva come se l'avessi caricata dal pannello.
- `image_base64` (con `image_type`, facoltativo): il file stesso, fino a 5 MB. È la strada per un'immagine generata dall'assistente stesso nella conversazione. L'SVG è accettato e diventa PNG; un SVG che punta a file esterni viene rifiutato.

| Regola | |
|---|---|
| Indirizzo | Solo `http` o `https`, pubblico. Gli indirizzi interni e privati vengono rifiutati, anche dopo un reindirizzamento |
| Formato | JPEG, PNG, WebP o GIF, verificato dal contenuto del file |
| Dimensione | Fino a 10 MB |
| Tempo | Il download ha 10 secondi |

Un link a una pagina (e non all'immagine stessa) viene rifiutato con *"il file non è un'immagine JPEG, PNG, WebP o GIF"*.

Nei composti, un'immagine non valida **non annulla** il resto: il corso o l'evento viene creato senza la copertina, e la risposta riporta il motivo in `warnings` (*"Non è stato possibile usare l'immagine di …: l'immagine supera i 10 MB."*). Chiedi di nuovo con un altro link, oppure metti l'immagine dal pannello. Negli strumenti che fanno una cosa sola (`create_post`, `add_gallery_image`), l'immagine non valida impedisce la creazione.

## Correlati

- [Ricette](/mcp/receitas)
- [Denaro e conferma](/mcp/dinheiro-e-confirmacao)
- [Sicurezza e limiti](/mcp/seguranca)