# Berichte und Diagramme

> Acht MCP-Tools, die nur lesen, um zu sehen, wie es der Community geht, und daraus im Gespräch ein Diagramm oder eine Tabelle zu machen — Verkäufe, Abonnements und MRR, aktive Mitglieder, Interaktion und Rangliste, Veranstaltungen, Kurse, die Aktivität eines Mitglieds und das Monats-Dashboard — mit fertigen Rezepten.

Frag den Assistenten, wie die Verkäufe laufen, wer am meisten mitmacht oder was eine Person getan hat, und er antwortet mit Zahlen und, wenn du willst, mit einem Diagramm oder einer Tabelle direkt im Gespräch (in Claude als Artefakt). Die acht Tools auf dieser Seite lesen nur: Keines ändert etwas in der Community.

## Kurz gesagt

| Tool | Was es tut | Mindestrolle | Typ |
|---|---|---|---|
| [`sales_report`](#sales-report) | Verkäufe pro Tag, Woche oder Monat, nach Plan, Produkt oder Zahlungsart, und die Summe seit dem ersten Verkauf | Administrator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`subscriptions_report`](#subscriptions-report) | MRR, neue und gekündigte Abonnements, Churn, Gratisabos und Downsell | Administrator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`members_report`](#members-report) | Neue, aktive und inaktive Mitglieder, nach Gruppe und Tag | Moderator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`engagement_report`](#engagement-report) | Posts, Kommentare, Reaktionen, wer am meisten mitmacht, unbeantwortete Posts und die Punkte der Rangliste | Moderator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`events_report`](#events-report) | Veranstaltungen und wie viele mit Dabei, Vielleicht und Nicht dabei geantwortet haben | Moderator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`courses_report`](#courses-report) | Einschreibungen, Abschlüsse und Fortschritt pro Kurs | Moderator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`member_activity`](#member-activity) | Was eine Person getan hat: Zählungen, Ranglistenpunkte und Links | Administrator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`community_overview`](#community-overview) | Dieser Monat gegen den letzten, in einer einzigen Anfrage | Moderator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |

**Wer was sieht.** Geld (Verkäufe und Abonnements) gehört dem Eigentümer, dem Administrator und **Finanzen**. Die Community (Mitglieder, Interaktion, Veranstaltungen und Kurse) gehört dem Eigentümer, dem Administrator und dem **Moderator**. Die Aktivität einer bestimmten Person sehen nur Eigentümer und Administrator. Im `community_overview` sieht jeder nur den Block seines Bereichs: Finanzen sieht das Geld, der Moderator die Community.

## Wie die Antworten ankommen

Jede Antwort ist schon bereit, zum Diagramm zu werden:

| Teil | Was es ist |
|---|---|
| `series` | Eine Zeile pro Zeitraum (`period`), mit den Zahlen dieses Zeitraums. Zeiträume ohne Daten erscheinen mit null, damit das Diagramm keinen Monat überspringt |
| `totals` | Die Summe des angefragten Zeitraums |
| `currency` | Die Währung der Beträge (eine pro Abfrage; standardmäßig die Währung, in der die Community am meisten verkauft) |
| `timezone` | Die Zeitzone, nach der die Tage gezählt werden |

Gemeinsame Parameter:

| Parameter | Werte | Standard |
|---|---|---|
| `interval` | `day`, `week` (beginnt montags) oder `month` | `month` |
| `from`, `to` | Daten `JJJJ-MM-TT`, einschließlich. Sie werden auf Anfang und Ende des Zeitraums erweitert: Mit `month` wird aus dem 15.03. der 01.03. | 30 Tage, 12 Wochen oder 12 Monate bis heute |
| `timezone` | Eine Zeitzone wie `America/Sao_Paulo` | Die Zeitzone des Landes der Community |

Eine Abfrage umfasst höchstens 366 Tage, 156 Wochen oder 120 Monate. Für einen längeren Zeitraum nimm ein größeres Intervall.

**Was jede Zahl bedeutet:**

- **Verkäufe** kommen aus dem [Kontoauszug](/pagamentos/saldo-e-extrato): Der Nettobetrag des Berichts ist der Nettobetrag des Kontoauszugs im selben Zeitraum. Die einzige Gebühr, die erscheint, ist die [Plattformgebühr](/pagamentos/taxa-da-plataforma), die nicht von der Zahlungsart abhängt.
- **MRR** ist der monatlich wiederkehrende Umsatz: jedes zahlende Abonnement auf den Monat umgerechnet (das jährliche durch 12 geteilt). Gratisabos und Abonnements in der Testphase zählen nicht mit.
- **Aktiv** ist, wer im Zeitraum mindestens eine Sache getan hat: gepostet, kommentiert, reagiert, auf eine Veranstaltung geantwortet (Dabei oder Vielleicht), sich in einen Kurs eingeschrieben oder darin gelernt, oder Punkte in der Rangliste gesammelt (inklusive des täglichen Logins, wenn die Rangliste eingeschaltet ist). Nur Lesen zählt nicht, weil Aufrufe nicht gespeichert werden.
- **Anwesenheit bei Veranstaltungen** gibt es nicht: Memberfy speichert die Antwort jeder Person (Dabei, Vielleicht, Nicht dabei), nicht, wer tatsächlich da war. Der Bericht sagt das (`attendanceTracked: false`).

## `sales_report`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Verkaufsbericht.** Pro Zeitraum: brutto, Plattformgebühr, Ratenzinsen, netto, Anzahl der Verkäufe, durchschnittlicher Bestellwert, Rückerstattungen und Rückbuchungen (getrennt), und der Nettobetrag danach. Dazu die angeforderten und abgeschlossenen Auszahlungen und die Summe seit dem ersten Verkauf. *Mindestrolle: Administrator oder Finanzen.*

Parameter: die gemeinsamen, dazu `group_by` (`product`, `plan`, `payment_method` oder `product_type`) und `currency`.

**Gibt zurück:** `series`, `totals`, `allTime` (seit jeher), `payouts` und, mit `group_by`, `groups`: jeder Plan, jedes Produkt oder jede Zahlungsart mit eigener Reihe. Ein Verkauf, der zu keinem Plan gehört, landet in der Gruppe ohne Namen.

**Frag so:** *„Wie viel habe ich insgesamt verdient, seit ich angefangen habe zu verkaufen?“*

**Danach:** Die Antwort schlägt in `next_steps` denselben Bericht für den unmittelbar vorherigen Zeitraum vor, mit fertigen Daten, zum Vergleich. Siehe [Nächste Schritte](/mcp/ferramentas#nachste-schritte).

## `subscriptions_report`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Abonnementbericht.** Pro Zeitraum: MRR, zahlende Abonnements, neue, gekündigte, Churn (der Anteil der zu Beginn des Zeitraums aktiven, die gekündigt wurden), in der Testphase und Gratisabos. *Mindestrolle: Administrator oder Finanzen.*

Parameter: die gemeinsamen, dazu `currency`.

**Gibt zurück:** `series`, `totals`, die Momentaufnahme von heute in `current` (MRR, ARR, nach Status, wie viele zum Periodenende auslaufen, überfällig, Gratisabos), `byPlan` und `downsell` (angezeigte und angenommene Letzte-Chance-Angebote).

**Frag so:** *„Wie hat sich der MRR dieses Jahr entwickelt? Wie hoch war der Churn in jedem Monat?“*

> [!NOTE]
> Der Verlauf wird aus dem Start- und Enddatum jedes Abonnements rekonstruiert. Ein bereits erledigter Zahlungsrückstand oder eine Pause hinterlassen kein Datum und erscheinen deshalb nur in der Momentaufnahme von heute.

## `members_report`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Mitgliederbericht.** Pro Zeitraum: wie viele beigetreten sind, wie viele aktiv waren, die Gesamtzahl am Ende des Zeitraums und die Inaktiven. *Mindestrolle: Moderator.*

Parameter: die gemeinsamen.

**Gibt zurück:** `series`, `totals`, `current` (gesamt, aktiv und inaktiv in den letzten 30 Tagen, nach Rolle), `byGroup` und `byTag`.

**Frag so:** *„Wie viele neue Mitglieder hatten wir pro Woche im letzten Quartal, und wie viele waren aktiv?“*

## `engagement_report`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Bericht über Interaktion und Rangliste.** Pro Zeitraum: Feed-Posts, Inhalte, Kommentare, Reaktionen, aktive Mitglieder und Ranglistenpunkte. Er zeigt auch, wo das Gespräch stattfindet, wer am meisten mitgemacht hat, die Posts, auf die niemand geantwortet hat, und die Daten, aus denen die [Rangliste](/espacos/ranking) entsteht. *Mindestrolle: Moderator.*

Parameter: die gemeinsamen, dazu `order_by` (`points`, `interactions`, `posts`, `comments` oder `reactions`; standardmäßig `points`, wenn die Rangliste eingeschaltet ist), `page` und `limit` (bis 100).

**Gibt zurück:** `series`, `totals`, `bySpace`, `members` (seitenweise: Posts, Kommentare, Reaktionen, Interaktionen, Punkte im Zeitraum und die heutige Stufe), `unansweredPosts` und `ranking` (die Punkteregeln, die Punkte pro Aktion und pro Zeitraum und wie viele Mitglieder auf jeder Stufe sind).

**Frag so:** *„Wer sind die 10 Aktivsten des Monats? Und welche Aktionen haben die meisten Punkte gebracht?“*

## `events_report`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Veranstaltungsbericht.** Pro Zeitraum: die Veranstaltungen, die stattgefunden haben, und die eingegangenen Antworten. Pro Veranstaltung: wie viele Dabei, Vielleicht und Nicht dabei gesagt haben, mit dem Link. *Mindestrolle: Moderator.*

Parameter: die gemeinsamen, dazu `page` und `limit`.

**Gibt zurück:** `series`, `totals` und `events`. Anwesenheit wird nicht gespeichert, und der Assistent sagt das, wenn du fragst, wer da war.

**Frag so:** *„Wie viele Personen haben für jede Veranstaltung dieses Halbjahres zugesagt?“*

## `courses_report`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Kursbericht.** Pro Zeitraum: Einschreibungen, abgeschlossene Kurse und abgeschlossene Lektionen. Pro Kurs: Einschreibungen, Abschlüsse, Abschlussquote und der durchschnittliche Fortschritt der Eingeschriebenen. *Mindestrolle: Moderator.*

Parameter: die gemeinsamen, dazu `page` und `limit`.

**Gibt zurück:** `series`, `totals` und `courses`, mit dem Link zu jedem Kurs.

**Frag so:** *„Welcher Kurs hat die niedrigste Abschlussquote?“*

## `member_activity`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Aktivität eines Mitglieds.** Was eine Person in der Community getan hat, im Zeitraum und seit jeher: Posts, Kommentare, Reaktionen, Antworten auf Veranstaltungen, Einschreibungen, Käufe, Abonnements, abgeschlossene Kurse und Zertifikate. Dazu die Ranglistenpunkte pro Aktion, Stufe und Platz und die letzten Einträge mit Link. *Mindestrolle: Administrator.*

Parameter: `member` (die Profil-ID aus `list_members`, die E-Mail oder der aus der App kopierte Link zum Profil) und die gemeinsamen. Für die Zeitleiste von allem, was die Person getan hat, mit Datum und Uhrzeit, nutze [`list_activity_logs`](/mcp/ferramentas-membros#list-activity-logs).

**Gibt zurück:** `counts`, `ranking` und `recent`. Von den Käufen nur der bezahlte Betrag und die Zahlungsart. Es gibt kein Protokoll der Seitenaufrufe: Der Bericht zeigt, was die Person getan hat, nicht, was sie gesehen hat.

**Frag so:** *„Was hat maria.silva@memberfy.net in den letzten 3 Monaten in der Community gemacht?“*

## `community_overview`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Gesamt-Dashboard der Community.** Dieser Monat bis heute gegen den ganzen letzten Monat und gegen den letzten Monat bis zum selben Tag: Umsatz und MRR, neue Mitglieder, Interaktion und die Veranstaltungen der nächsten 30 Tage. *Mindestrolle: Moderator oder Finanzen; jeder sieht den Block seines Bereichs.*

Parameter: `timezone`.

**Gibt zurück:** `money` (für Eigentümer, Administrator und Finanzen) und `community` (für Eigentümer, Administrator und Moderator).

**Frag so:** *„Wie läuft der Monat im Vergleich zum letzten?“*

## Rezepte

### Umsatzdiagramm pro Monat und Plan

**Für wen:** Eigentümer, Administrator oder Finanzen.

> Mach ein gestapeltes Balkendiagramm mit dem Nettoumsatz Monat für Monat im Jahr 2026, eine Farbe pro Plan, und darunter eine Tabelle mit der Summe jedes Plans und dem durchschnittlichen Bestellwert.

| # | Tool | Was es tut |
|---|---|---|
| 1 | `sales_report` | `interval: month`, `from: 2026-01-01`, `to: 2026-12-31`, `group_by: plan` |

**Ergebnis:** das Diagramm und die Tabelle im Gespräch. Jeder Plan in `groups` kommt schon mit der vollständigen Reihe, mit null in Monaten ohne Verkauf. Um auch die Rückerstattungen zu sehen, sag *„und eine Linie mit den Rückerstattungen“*.

### Die 10 Aktivsten

**Für wen:** Eigentümer, Administrator oder Moderator.

> Wer waren die 10 aktivsten Mitglieder der letzten 30 Tage? Zeig sie in einer Tabelle mit Posts, Kommentaren, Reaktionen, Punkten und Stufe, und sag mir, welche Aktionen die meisten Punkte gebracht haben.

| # | Tool | Was es tut |
|---|---|---|
| 1 | `engagement_report` | `interval: day`, `limit: 10`, `order_by: points` |

**Ergebnis:** die Tabelle mit den ersten 10 und eine Zusammenfassung von `ranking.byAction`. Bei ausgeschalteter Rangliste frag nach `order_by: interactions`. Für die Details einer Person aus der Liste geht es mit `member_activity` weiter.

### Wochenrückblick

**Für wen:** jede Rolle im Team. Finanzen bekommt nur den Geldteil, der Moderator nur den Community-Teil.

> Mach den Wochenrückblick: Verkäufe und neue Abonnements, neue Mitglieder, wer am meisten mitgemacht hat, die Posts ohne Antwort und die nächsten Veranstaltungen mit der Zahl der Zusagen. Schließ mit drei Vorschlägen, was zu tun ist.

| # | Tool | Was es tut |
|---|---|---|
| 1 | `community_overview` | Der Monat bis heute, als Kontext |
| 2 | `sales_report` | `interval: day`, die letzten 7 Tage |
| 3 | `engagement_report` | `interval: day`, die letzten 7 Tage, `limit: 5` |
| 4 | `events_report` | Ab der nächsten Woche |

**Ergebnis:** der Rückblick im Gespräch. Wenn du ihn veröffentlichen willst, sag *„schreib daraus einen Post für den Feed und zeig ihn mir vorher“*: Der Assistent nutzt `create_post` nach deinem Okay.

## Verwandt

- [Werkzeuge](/mcp/ferramentas)
- [Rezepte](/mcp/receitas)
- [Werkzeuge · Finanzen](/mcp/ferramentas-financeiro)
- [Sicherheit und Grenzen](/mcp/seguranca)