# 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`](#sales-report) | Vendite per giorno, settimana o mese, per piano, prodotto o metodo di pagamento, e il totale dalla prima vendita | Admin o finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`subscriptions_report`](#subscriptions-report) | MRR, abbonamenti nuovi e annullati, churn, omaggi e downsell | Admin o finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`members_report`](#members-report) | Membri nuovi, attivi e inattivi, per gruppo e per tag | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`engagement_report`](#engagement-report) | Post, commenti, reazioni, chi partecipa di più, post senza risposta e i punti della classifica | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`events_report`](#events-report) | Eventi e quanti hanno risposto ci sarò, forse e non ci sarò | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`courses_report`](#courses-report) | Iscrizioni, completamenti e avanzamento per corso | Moderatore | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`member_activity`](#member-activity) | Cosa ha fatto una persona: conteggi, punti della classifica e link | Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`community_overview`](#community-overview) | Questo mese rispetto al mese scorso, in una sola richiesta | Moderatore o finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> |

**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](/pagamentos/saldo-e-extrato): il netto del report è il netto dell'estratto conto nello stesso periodo. L'unica commissione che compare è la [commissione della piattaforma](/pagamentos/taxa-da-plataforma), 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`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**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](/mcp/ferramentas#prossimi-passi).

## `subscriptions_report`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**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?"*

> [!NOTE]
> 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`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**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`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**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](/espacos/ranking). *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`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**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`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**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`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**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`](/mcp/ferramentas-membros#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`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**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.

## Correlati

- [Strumenti](/mcp/ferramentas)
- [Ricette](/mcp/receitas)
- [Strumenti · Finanze](/mcp/ferramentas-financeiro)
- [Sicurezza e limiti](/mcp/seguranca)