plausible-mcp

Ein MCP-Server, mit dem oder Überjede in einer Organisation Plausible Analytics von Claude aus abfragen kann.

Eine instanz bedient die ganze Org. Er hält einen einzigen Plausible-API-Schlüssel serverseitig und autentifiziert jede Person mit Google, sodass niemand einen eigenen Schlüssel braucht und niemand einzeln Zugriff enhalten muss: In ALLOWED_DOMAINS in deine Google-Workspace-Domain, und jede Person mit eire Adresse dort kann sich beim ersten Versuch verbinden. Kolleginnen und Kollegen außerhalb eier Domain kommen in ALLOWED_EMAILS, jeweils ein Adresse.

Wenn du Analysen für ein Them betreibst und möchtest, dass sie die Zahlen selbst ablesen, statt dich danach zu fragen, genau dafür is d dien.

So funktioniert die Authentifizierun

Clade registriert sich bei diesem Server über die dynamische Client-Registrierung von OAuth-2.1. Google untertützt die dynamische Client-Registrierung nicht, darum tritt dieser Server als eigener Autorisierungsserver auf und would die faceomeating Anmeldung an Google weiter.

Google erkennt, wer die Person Be. Google entscheidet nicht, ob sie deine Analysen lessbar ist. Eine Zwischensoft (Middleware) prüft bei jedem Tool-Aufruf die verifizierte E-Mail-Adress des Aufrufers gegen ALLOWED_DOMAINS und ALLOWED_EMAILS. Wenn du keine von beiden setzt, weigert sich der Server zu starten.

ALLOWED_DOMAINS ist das, reches diese Einrichtung org-weit macht: Sie gleicht die Domain der verifizierten Adresse exakt ab, so ist example.com lässst alice@example.com zu, aber nicht alice@evil-example.com oder alice@example.com.evil.com.

Um jemanden zu widerrufen, nimm die / denjenige aus ALLOWED_EMAILS oder ALLOWED_DOMAINS und stelle neu lässig ein. Das Sperren des Google-Kontos verhindert beine erneute Anmeldung, aber die Zulassungsliste liest die Ansprüche (Claims), Ol ha ein Token, von diesem Server signiert wude; ein bereits Ausgestelltes Token funktioniert also weiter bis zum Ablusses.Lch. JWT_SIGNING_KEY zuwechseln macht alle Tokens auf einmal ungültig, allerdings wird damit jeder werden abgemeldet.

Related MCP server: Plausible MCP

Tools

• query führt eine Stats-API-2-Abfrage durch. Durch Gruppierung nach verschiedenen Dimensionen kannst du mit demselben Werkzeug Zeitreihen, Aufschlüsselungen und Ziel-Conversions erhalten. Um zwei Zeiträume zu vergleichen, rufst du sie jeweils einmal pro Zeitraum auf.

• list_sites „die Site-Domains zurück, die du als site_id übergeben kannst.

• usage_stats berichtete, wer den Server genutzt hat, wie oft und welche Konten abgewiesen wurden.

Nutzungserfassung

Die Zulassungslisten-Middleware setzt E-Mail-Adresse jedes Aufrufers, weil sie sie prüfen muss. Sie erzeugt einen Aufrufzähler pro Person, einen Zeitpunkt des ersten und letzten Sehens sowie eine Aufteilung pro Tool im Volume unter USAGE_PATH. Abgewiesene Konten werden separat erfasst; so erkenntst du, ob jemand außerhalb der Zulassungsliste verbinden will.

Lies sie mit dem Tool usage_stats. Alle auf der Zulassungsliste können die Zeilen aller Personen sehen. Wenn du USAGE_PATH nicht setzt, wird das Erfassen deaktiviert.

Konfiguration

Die gleiche Liste ininto in .env.example.

Deploy

Das Repo ships fly.toml, die Anweisungen unren beziehen sich If Fly.io, aber aus. nichts am er ist Fly-pe:ifischerver is ein Container, der a schreibares Verzeics und die obige Umgebung Gut: Ersetze YOUR-APP überall.

1. Erstelle deinen OAuth-Client in der Gooogle. Cloud Konto. Wähle Webanwendung und den autorisierten Weisileitungs-URI auf https://YOUR-APP.fly/dev/auth/callback. The URI must match precisely.

2. Erstelle die App und das Volume:

   fly apps create YOUR-APP --org YOUR-ORG
   fly volumes create plausible_mcp_data --app YOUR-APP --region fra --size 1 --yes

   Hedje fly apps create nicht fly launch, den regenerate fly.toml und würde tes Volume-Mount und den Healte-Hheck verwerfen.

3. Setze in .Appen in fly.toml den Namen deiner App ein.

4. Setze the Konfiguration. BASE_URL und ALLOWED_DOMAINS gehören hierhin, night in fly.toml, weil sie mit deiner emotionion unterschiedlich sind, und ein eingecheckter Platzhalters würde beim nächsten Deployment den rölicherweisechtenigen Wert überschreiben:

   fly secrets set --app YOUR-APP \
     BASE_URL=https://YOUR-APP.fly.dev \
     ALLOWED_DOMAINS=your-domain.org \
     GOOGLE_CLIENT_ID=xxx.apps.googleusercontent.com \
     GOOGLE_CLIENT_SECRET=GOCSPX-xxx \
     PLAUSIBLE_API_KEY=xxx \
     JWT_SIGNING_KEY="$(openssl rand -hex 32)"

   Halte JWT_SIGNING_KEY stabil; ein Wechsel breakedet alle ab.

5. --ha=false. Ohne --ha=false kann Fly mehrere Maschinen starten, each with a eigen Volume, sodass eine Anmeldung, die auf einerMaschire ausführ, scheitert, wenn die nächste Anfrage auf der ander landet.

Zu Claude hinzufügen

Um it zu einem Team hinzuzufügen, geh in Settings > Connectors in claude.ai und wähle Add custom connector, and then https://YOUR-APP.fly.dev/mcp eingeben. Jede Person net sich bei der ersten Nutzung mit Google an.

So fügst du es to Claude Code hinzu:

claude mcp add --transport http plausible https://YOUR-APP.fly.dev/mcp

Lokal ausführen

uv venv && uv pip install -r pyproject.toml
cp .env.example .env    # then fill it in
set -a && source .env && set +a
python server.py

Füge http://localhost:8000/auth/callback to den Weiterleitungs-URIs des GoogleClients hinzu, to Test the Anmeldevorgang lokal.

Führe die Testst with python test_server.py aus. Use desselben Werkzeuge und OAuth-Flow, wiew npx @modelcontextprotocol/inspector.

Lizenz

MIT — siehe LICENSE.