Report e grafici
Otto strumenti MCP di sola lettura per vedere come va la community e trasformarlo in un grafico o in una tabella nella conversazione — vendite, abbonamenti e MRR, membri attivi, coinvolgimento e classifica, eventi, corsi, l'attività di un membro e il pannello del mese — con ricette pronte.
Chiedi all'assistente come vanno le vendite, chi partecipa di più o cosa ha fatto una persona, e lui risponde con i numeri e, se vuoi, con un grafico o una tabella direttamente nella conversazione (in Claude, come artefatto). Gli otto strumenti di questa pagina consultano soltanto: nessuno cambia nulla nella community.
In sintesi
| Strumento | Cosa fa | Ruolo minimo | Tipo |
|---|---|---|---|
sales_report | Vendite per giorno, settimana o mese, per piano, prodotto o metodo di pagamento, e il totale dalla prima vendita | Admin o finanza | Solo lettura |
subscriptions_report | MRR, abbonamenti nuovi e annullati, churn, omaggi e downsell | Admin o finanza | Solo lettura |
members_report | Membri nuovi, attivi e inattivi, per gruppo e per tag | Moderatore | Solo lettura |
engagement_report | Post, commenti, reazioni, chi partecipa di più, post senza risposta e i punti della classifica | Moderatore | Solo lettura |
events_report | Eventi e quanti hanno risposto ci sarò, forse e non ci sarò | Moderatore | Solo lettura |
courses_report | Iscrizioni, completamenti e avanzamento per corso | Moderatore | Solo lettura |
member_activity | Cosa ha fatto una persona: conteggi, punti della classifica e link | Admin | Solo lettura |
community_overview | Questo mese rispetto al mese scorso, in una sola richiesta | Moderatore o finanza | Solo lettura |
Chi vede cosa. Il denaro (vendite e abbonamenti) è del proprietario, dell'admin e di finanza. La community (membri, coinvolgimento, eventi e corsi) è del proprietario, dell'admin e del moderatore. L'attività di una persona specifica è solo del proprietario e dell'admin. In community_overview, ognuno vede solo il blocco della propria area: finanza vede il denaro, il moderatore vede la community.
Come arrivano le risposte
Ogni risposta arriva pronta per diventare un grafico:
| Parte | Cos'è |
|---|---|
series | Una riga per periodo (period), con i numeri di quel periodo. I periodi vuoti compaiono con zero, così il grafico non salta un mese |
totals | La somma dell'intervallo richiesto |
currency | La valuta degli importi (una per consultazione; di default, la valuta in cui la community vende di più) |
timezone | Il fuso orario usato per contare i giorni |
Parametri comuni:
| Parametro | Valori | Default |
|---|---|---|
interval | day, week (inizia il lunedì) o month | month |
from, to | Date AAAA-MM-GG, incluse. Vengono allargate fino all'inizio e alla fine del periodo: con month, il 15/03 diventa l'01/03 | 30 giorni, 12 settimane o 12 mesi fino a oggi |
timezone | Un fuso orario come America/Sao_Paulo | Il fuso del paese della community |
Una consultazione copre al massimo 366 giorni, 156 settimane o 120 mesi. Per un periodo più lungo, usa un intervallo più ampio.
Cosa significa ogni numero:
- Le vendite vengono dall'estratto conto: il netto del report è il netto dell'estratto conto nello stesso periodo. L'unica commissione che compare è la commissione della piattaforma, che non dipende dal metodo di pagamento.
- L'MRR è il ricavo ricorrente mensile: ogni abbonamento pagante convertito al mese (l'annuale diviso per 12). Gli omaggi e gli abbonamenti in prova restano fuori.
- Attivo è chi ha fatto almeno una cosa nel periodo: ha pubblicato, commentato, reagito, risposto a un evento (ci sarò o forse), si è iscritto o ha studiato in un corso, o ha guadagnato punti in classifica (incluso l'accesso giornaliero, quando la classifica è attiva). Solo leggere non conta, perché le visualizzazioni non vengono registrate.
- La presenza agli eventi non esiste: Memberfy registra la risposta di ogni persona (ci sarò, forse, non ci sarò), non chi ha partecipato. Il report lo dice (
attendanceTracked: false).
sales_report
Solo lettura
Report delle vendite. Per periodo: lordo, commissione della piattaforma, interessi della rateizzazione, netto, numero di vendite, scontrino medio, rimborsi e contestazioni (separati), e il netto dopo di essi. Riporta anche i prelievi richiesti e completati e il totale dalla prima vendita. Ruolo minimo: admin o finanza.
Parametri: quelli comuni, più group_by (product, plan, payment_method o product_type) e currency.
Restituisce: series, totals, allTime (da sempre), payouts e, con group_by, groups: ogni piano, prodotto o metodo di pagamento con la propria serie. Una vendita che non appartiene a nessun piano finisce nel gruppo senza nome.
Chiedi così: "Quanto ho guadagnato in totale da quando ho iniziato a vendere?"
Dopo: la risposta suggerisce, in next_steps, lo stesso report sul periodo immediatamente precedente, con le date già pronte, per confrontare. Vedi Prossimi passi.
subscriptions_report
Solo lettura
Report degli abbonamenti. Per periodo: MRR, abbonamenti paganti, nuovi, annullati, churn (la percentuale di quelli attivi all'inizio del periodo che sono stati annullati), in prova e omaggi. Ruolo minimo: admin o finanza.
Parametri: quelli comuni, più currency.
Restituisce: series, totals, la fotografia di oggi in current (MRR, ARR, per stato, quanti termineranno a fine periodo, in ritardo, omaggi), byPlan e downsell (offerte di ultima occasione mostrate e accettate).
Chiedi così: "Com'è andato l'MRR quest'anno? Qual è stato il churn di ogni mese?"
Lo storico viene ricostruito a partire dalle date di inizio e di fine di ogni abbonamento. Un ritardo già risolto o una pausa non lasciano una data, quindi compaiono solo nella fotografia di oggi.
members_report
Solo lettura
Report dei membri. Per periodo: quanti sono entrati, quanti erano attivi, il totale a fine periodo e gli inattivi. Ruolo minimo: moderatore.
Parametri: quelli comuni.
Restituisce: series, totals, current (totale, attivi e inattivi negli ultimi 30 giorni, per ruolo), byGroup e byTag.
Chiedi così: "Quanti nuovi membri abbiamo avuto ogni settimana nell'ultimo trimestre, e quanti erano attivi?"
engagement_report
Solo lettura
Report di coinvolgimento e classifica. Per periodo: post del feed, contenuti, commenti, reazioni, membri attivi e punti della classifica. Mostra anche dove avviene la conversazione, chi ha partecipato di più, i post a cui nessuno ha risposto e i dati che formano la classifica. Ruolo minimo: moderatore.
Parametri: quelli comuni, più order_by (points, interactions, posts, comments o reactions; di default points con la classifica attiva), page e limit (fino a 100).
Restituisce: series, totals, bySpace, members (paginato: post, commenti, reazioni, interazioni, punti nel periodo e il livello di oggi), unansweredPosts e ranking (le regole dei punti, i punti per azione e per periodo e quanti membri ci sono in ogni livello).
Chiedi così: "Chi sono i 10 più coinvolti del mese? E quali azioni hanno dato più punti?"
events_report
Solo lettura
Report degli eventi. Per periodo: gli eventi che si sono svolti e le risposte ricevute. Per evento: quanti hanno detto ci sarò, forse e non ci sarò, con il link. Ruolo minimo: moderatore.
Parametri: quelli comuni, più page e limit.
Restituisce: series, totals ed events. La presenza non viene registrata, e l'assistente lo dice se chiedi chi ha partecipato.
Chiedi così: "Quante persone hanno confermato a ogni evento di questo semestre?"
courses_report
Solo lettura
Report dei corsi. Per periodo: iscrizioni, corsi completati e lezioni completate. Per corso: iscrizioni, completamenti, tasso di completamento e l'avanzamento medio degli iscritti. Ruolo minimo: moderatore.
Parametri: quelli comuni, più page e limit.
Restituisce: series, totals e courses, con il link di ogni corso.
Chiedi così: "Quale corso ha il tasso di completamento più basso?"
member_activity
Solo lettura
Attività di un membro. Cosa ha fatto una persona nella community, nel periodo e da sempre: post, commenti, reazioni, risposte agli eventi, iscrizioni, acquisti, abbonamenti, corsi completati e certificati. Riporta i punti della classifica per azione, il livello e la posizione, e gli elementi recenti con il link. Ruolo minimo: admin.
Parametri: member (l'id del profilo, da list_members, l'e-mail o il link del profilo copiato dall'app) e quelli comuni. Per la cronologia di tutto ciò che la persona ha fatto, con data e ora, usa list_activity_logs.
Restituisce: counts, ranking e recent. Degli acquisti, solo l'importo pagato e il metodo di pagamento. Non c'è registro della navigazione: il report mostra cosa la persona ha fatto, non cosa ha visto.
Chiedi così: "Cosa ha fatto maria.silva@memberfy.net nella community negli ultimi 3 mesi?"
community_overview
Solo lettura
Pannello generale della community. Questo mese fino a oggi rispetto al mese scorso intero e rispetto al mese scorso fino allo stesso giorno: ricavi e MRR, nuovi membri, coinvolgimento e gli eventi dei prossimi 30 giorni. Ruolo minimo: moderatore o finanza; ognuno vede il blocco della propria area.
Parametri: timezone.
Restituisce: money (per proprietario, admin e finanza) e community (per proprietario, admin e moderatore).
Chiedi così: "Come va il mese rispetto al precedente?"
Ricette
Grafico dei ricavi per mese e per piano
Per chi: proprietario, admin o finanza.
Fai un grafico a barre impilate dei ricavi netti mese per mese nel 2026, un colore per piano, e sotto una tabella con il totale di ogni piano e lo scontrino medio.
| # | Strumento | Cosa fa |
|---|---|---|
| 1 | sales_report | interval: month, from: 2026-01-01, to: 2026-12-31, group_by: plan |
Risultato: il grafico e la tabella nella conversazione. Ogni piano in groups arriva già con la serie completa, con zero nei mesi senza vendite. Per vedere anche i rimborsi, chiedi "e una linea con i rimborsi".
I 10 più coinvolti
Per chi: proprietario, admin o moderatore.
Chi sono stati i 10 membri più coinvolti negli ultimi 30 giorni? Mostrali in una tabella con post, commenti, reazioni, punti e livello, e dimmi quali azioni hanno dato più punti.
| # | Strumento | Cosa fa |
|---|---|---|
| 1 | engagement_report | interval: day, limit: 10, order_by: points |
Risultato: la tabella con i primi 10 e un riassunto di ranking.byAction. Con la classifica disattivata, chiedi order_by: interactions. Per vedere il dettaglio di una persona dell'elenco, prosegui con member_activity.
Riepilogo della settimana
Per chi: qualsiasi ruolo dello staff. Finanza riceve solo la parte del denaro; il moderatore, solo quella della community.
Fai il riepilogo della settimana: vendite e abbonamenti nuovi, nuovi membri, chi ha partecipato di più, i post rimasti senza risposta e i prossimi eventi con quanti hanno confermato. Chiudi con tre suggerimenti su cosa fare.
| # | Strumento | Cosa fa |
|---|---|---|
| 1 | community_overview | Il mese fino a oggi, per dare contesto |
| 2 | sales_report | interval: day, gli ultimi 7 giorni |
| 3 | engagement_report | interval: day, gli ultimi 7 giorni, limit: 5 |
| 4 | events_report | Dalla prossima settimana in poi |
Risultato: il riepilogo nella conversazione. Se vuoi pubblicarlo, chiedi "scrivi un post con questo per il Feed e mostramelo prima": l'assistente usa create_post dopo il tuo ok.