← MCP-Verzeichnis

Google Analytics (GA4) MCP-Server

Beta

Google stellt einen eigenen Open-Source-MCP-Server für Google Analytics bereit, über den KI-Agenten GA4-Berichte über die Data API und Admin API abrufen können. Er läuft lokal oder selbst gehostet und liest standardmäßig nur.

Was ein Agent tun kann

  • → Konten und Properties auflisten
  • → Standard- und Trichterberichte ausführen
  • → Echtzeitdaten und Conversions lesen
  • → Benutzerdefinierte Dimensionen, Schlüsselereignisse lesen
  • → Google-Ads-Verknüpfungen anzeigen

Standardmäßig kann der Server in GA4 nichts ändern. Mit dem Schalter --allow-write gestartet, kann er Anmerkungen, benutzerdefinierte Dimensionen und Schlüsselereignisse anlegen, aber nicht ändern oder löschen.

Über den Google Analytics (GA4) MCP-Server

Der Google Analytics MCP-Server ist ein Open-Source-Programm, das Google in der GitHub-Organisation googleanalytics und als Paket analytics-mcp veröffentlicht. Er verbindet einen KI-Assistenten über Googles eigene Admin API und Data API mit Google Analytics. Eine gemeinsame, von Google gehostete Adresse gibt es nicht. Sie starten ihn lokal auf einem Rechner oder betreiben ihn selbst als Dienst über HTTP, zum Beispiel auf Google Cloud Run.

Teams stellen damit Fragen zu ihrem Traffic mit eigenen Worten: Nutzer pro Tag, die häufigsten Ereignisse der letzten 90 Tage, was gerade passiert, wo ein Trichter Besucher verliert und welche Schlüsselereignisse Conversions bringen. Der Server zeigt außerdem, auf welche Konten und Properties Sie zugreifen können, die Einstellungen einer Property, benutzerdefinierte Dimensionen und Messwerte, Verknüpfungen mit Google Ads und die Anmerkungen einer Property.

Standardmäßig liest der Server nur, mit dem Scope analytics.readonly, und die angemeldete Person braucht die Rolle Betrachter für die Property. Die README des Projekts beschreibt drei Schreibwerkzeuge, die Anmerkungen, benutzerdefinierte Dimensionen und Schlüsselereignisse anlegen. Es gibt sie nur, wenn der Server mit dem Schalter --allow-write und dem Scope analytics.edit gestartet wird, und sie setzen eine höhere Rolle in der Property voraus. Löschen kann der Server nichts, und Anfragelimits nennt Google auf der Dokumentationsseite nicht.

Das können Sie fragen

  • Welche Ereignisse waren in unserer Property in den letzten 90 Tagen am häufigsten?
  • Zeigen Sie die Zahl der Nutzer pro Tag in diesem Monat im Vergleich zum Vormonat.
  • Wie viele Personen sind gerade auf der Website, und auf welchen Seiten?
  • Bauen Sie einen Trichter von der Landingpage bis zum abgeschickten Formular und zeigen Sie, wo die meisten abspringen.
  • Welche benutzerdefinierten Dimensionen und Messwerte gibt es in der Property, und welche Google-Ads-Konten sind verknüpft?

Werkzeuge des Servers

  • get_account_summaries
  • get_property_details
  • list_google_ads_links
  • list_property_annotations
  • list_key_events
  • get_custom_dimensions_and_metrics
  • run_report
  • run_realtime_report
  • run_funnel_report
  • run_conversions_report
  • create_property_annotation
  • create_custom_dimension
  • create_key_event
Ratgeber · auf EnglischSo richten Sie Google Analytics (GA4) MCP ein →

Enthalten in diesen Paketen

Google Analytics (GA4) ist in diesen Walma-Paketen enthalten.

Fragen zu Google Analytics (GA4) MCP

Ist der Google Analytics MCP-Server kostenlos?+

Der Server ist Open Source unter der Apache-2.0-Lizenz und auf GitHub sowie als Paket analytics-mcp verfügbar. Für den Server selbst nennt Google keine Gebühr. Sie brauchen ein Google-Cloud-Projekt, in dem die Google Analytics Admin API und die Google Analytics Data API aktiviert sind, und Python 3.10 oder neuer, um ihn auszuführen.

Wie lautet die URL des Google Analytics MCP-Servers?+

Eine gemeinsame Adresse bei Google gibt es nicht. Der Server ist das Paket analytics-mcp, der Quellcode liegt unter github.com/googleanalytics/google-analytics-mcp, gestartet wird er lokal mit pipx run analytics-mcp. Die README des Projekts beschreibt außerdem, wie Sie ihn selbst über HTTP betreiben, mit Docker oder auf Google Cloud Run. Dann erhalten Sie eine eigene Adresse.

Wie funktioniert die Anmeldung?+

Der Server nutzt Application Default Credentials. Entweder melden Sie sich über gcloud mit Ihrem eigenen Google-Konto an, oder Sie verwenden ein Dienstkonto mit Schlüsseldatei oder Identitätswechsel. Erforderlich ist der Scope analytics.readonly, und das Konto braucht die Rolle Betrachter für die Property. Als Remote-Dienst hat der Server eine eingebaute OAuth-Anmeldung, die mit dem Schalter --oauth eingeschaltet wird.

Ist der Server schreibgeschützt?+

Standardmäßig ja. Googles Dokumentation beschreibt ihn als ausschließlich für Leseanfragen verfügbar. Die README des Projekts ergänzt drei Schreibwerkzeuge, die Anmerkungen, benutzerdefinierte Dimensionen und Schlüsselereignisse anlegen, allerdings nur, wenn der Server mit --allow-write und dem Scope analytics.edit gestartet wird. Ohne den Schalter kann der Server in Google Analytics nichts anlegen, ändern oder löschen.

Mit welchen KI-Assistenten funktioniert er?+

Googles Dokumentation zeigt die Konfiguration für Antigravity, Claude Desktop, Claude Code und Cursor. Die README des Projekts nennt außerdem Gemini CLI, Gemini Code Assist in VS Code und Googles Framework ADK für eigene Agenten. In allen Fällen startet der Client den Server als lokalen Befehl, sofern Sie ihn nicht selbst über HTTP betreiben.

Welche Berichte kann der Assistent ausführen?+

Vier Arten von Berichten: Standardberichte mit frei gewählten Dimensionen und Messwerten, Echtzeitberichte, Trichterberichte und Conversion-Berichte. Der Assistent kann außerdem die benutzerdefinierten Dimensionen und Messwerte der Property nachschlagen, damit er weiß, welche Felder sich abfragen lassen. Abgerufen werden die Berichte über die Google Analytics Data API.

Warum erhalte ich einen 403-Fehler, wenn der Server Daten abruft?+

Google nennt drei häufige Ursachen. PERMISSION_DENIED bedeutet, dass eine der beiden APIs nicht aktiviert ist oder dem Konto der Zugriff auf die Property fehlt. ACCESS_NOT_CONFIGURED heißt meist, dass ein Kontingentprojekt fehlt, was sich mit GOOGLE_CLOUD_PROJECT beheben lässt. Unzureichende Scopes erfordern eine erneute Anmeldung mit den richtigen Scopes. Verwenden Sie in Desktop-Clients absolute Pfade zur Schlüsseldatei.

Fehlt Ihnen eine Anbindung?

Wir bauen und prüfen MCP-Server für Teams, die sie brauchen, und betreiben sie hinter derselben Richtlinie und demselben Protokoll wie das restliche Gateway.