GA4 mit einem Befehl in Claude Code
Claude Code
GA4 mit Claude Code verbinden: claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp ausführen, /mcp eingeben, mit PaidSync.ai anmelden.
Claude Code erreicht Ihre Google-Analytics-4-Properties dann über 26 Tools: eigene Berichte, Echtzeit-Checks, Key Events, eigene Dimensionen, Zielgruppen und Google-Ads-Verknüpfungen. Claude Code fragt vor jedem Tool nach, und GA4-Schreibvorgänge gelten sofort, ohne Testlauf.
Ein Befehl. OAuth-Login, kein Key. Gratis-Plan mit 100 Aufgaben im Monat, Wert $50, ohne Karte.
Der Befehl
Claude Code spricht mit Remote-MCP-Servern über Streamable HTTP. PaidSync ist einer davon. Fügen Sie ihn einmal hinzu, und dasselbe Terminal, das Ihren Code bearbeitet, kann Ihre GA4-Properties abfragen und konfigurieren.
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpStandardmäßig registriert das den Server nur für das aktuelle Projekt. Fügen Sie --scope user hinzu, damit er in jedem Projekt auf Ihrem Rechner verfügbar ist.
Führen Sie claude mcp list aus, um zu prüfen, dass er da ist, starten Sie dann eine Sitzung und tippen Sie /mcp, um sich anzumelden.
Einrichtung in 5 Schritten
1Bei paidsync.ai/signup registrieren
Dauert 10 Sekunden. Anmeldung mit Google oder E-Mail. Der Free-Plan sind 100 Tasks im Monat für $0, keine Karte.
2GA4 im PaidSync-Dashboard verbinden
Klicken Sie bei Google Analytics 4 auf Verbinden. GA4 wird über Google OAuth autorisiert, mit dem Google-Konto, das Zugriff auf Ihre Properties hat. Es nutzt dieselbe Google-Anmeldung wie Google Ads und fragt die Analytics-Scopes analytics.edit und analytics.readonly an.
Schon in Claude Code? Bitten Sie es, connect_ga4 auszuführen. Das Tool liefert einen OAuth-Link, den Sie in Ihrem Browser öffnen.
3Die Property wählen, mit der Claude Code arbeiten soll
In einer Sitzung zeigen list_ga4_accounts und list_ga4_properties jede Property, die Ihre Anmeldung erreichen kann. Nennen Sie die Property in Ihrem Prompt oder legen Sie sie in der CLAUDE.md Ihres Projekts fest, damit jede Sitzung sie nutzt.
4PaidSync zu Claude Code hinzufügen
Führen Sie in Ihrem Terminal aus:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpStarten Sie eine Sitzung, tippen Sie /mcp, wählen Sie paidsync und melden Sie sich im sich öffnenden Browserfenster mit Ihrem PaidSync-Login an. Claude Code speichert das OAuth-Token für Sie. Es wird nirgends ein Schlüssel eingefügt.
Richten Sie das für ein Team ein? Committen Sie eine .mcp.json im Repo-Stammverzeichnis, damit jeder Entwickler denselben Connector bekommt:
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}Lieber einen API-Schlüssel, zum Beispiel für Headless-Läufe? Senden Sie ihn in einem Header, nie in der URL, wo er in Logs landen würde:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"Fügen Sie in einer committeten .mcp.json "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } hinzu, damit der Schlüssel in der Umgebung jedes Entwicklers bleibt und nie in Git gelangt. Eine Änderung in Google Ads anzuwenden erfordert weiterhin die OAuth-Anmeldung. Auf anderen Plattformen kann ein Schlüssel ebenfalls Änderungen anwenden, behandeln Sie ihn also wie ein Passwort und bevorzugen Sie OAuth.
5Die Verbindung testen
Fragen Sie in einer Claude-Code-Sitzung: “Zeig mir Sessions und Key Events nach Quelle und Medium der letzten 28 Tage”
Claude Code führt einen GA4-Bericht für die Property aus und liefert die Tabelle. Die Verbindung steht.
Der Free-Plan enthält 100 Tasks im Monat. Pro ab $99 im Monat, Team ab $249.
GA4-Prompts für Claude Code
Jeder Prompt unten gehört zu Tools in der PaidSync-GA4-Gruppe. Claude Code wählt das Tool. Die letzte Spalte zeigt, ob der Aufruf etwas in der Property ändern kann.
| Anfrage | Aufgerufene Tools | Ändert Ihr Konto? |
|---|---|---|
| “Liste meine GA4-Properties und ihre Datenstreams auf” | list_ga4_properties, list_ga4_data_streams | Nein |
| “Sessions und Conversions nach Quelle und Medium, letzte 28 Tage” | run_ga4_report | Nein |
| “Feuert das Ereignis purchase gerade?” | run_ga4_realtime_report | Nein |
| “Welche Key Events sind eingerichtet, und ist Google Ads verknüpft?” | list_ga4_conversion_events, list_ga4_google_ads_links | Nein |
| “Welche Ereignisse der erweiterten Messung sind für den Web-Stream aktiv?” | get_ga4_enhanced_measurement | Nein |
| “Markiere generate_lead als Key Event” | create_ga4_conversion_event | Ja, nach Ihrer Bestätigung |
| “Füge eine benutzerdefinierte Dimension für den Ereignisparameter plan_tier hinzu” | create_ga4_custom_dimension | Ja, nach Ihrer Bestätigung |
| “Verknüpfe das Google-Ads-Konto 123-456-7890 mit dieser Property” | create_ga4_google_ads_link | Ja, nach Ihrer Bestätigung |
Headless ausführen mit claude -p
Das Flag -p führt Claude Code ohne interaktive Sitzung aus. Melden Sie sich einmal über /mcp an, und das gespeicherte OAuth-Token wird übernommen. Ein Bericht, der in einer Datei landet, sieht so aus:
claude -p "Run a GA4 report for the last 7 days of sessions and key events by source and medium, and flag any source whose key events dropped against the week before." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/ga4-$(date +%F).jsonLesezugriffe laufen direkt durch, Schreibzugriffe ebenso. --allowedTools "mcp__paidsync" erlaubt jedes PaidSync-Tool, auch die schreibenden, ohne Abfrage.
Erlauben Sie für einen unbeaufsichtigten Job nur die Lese-Tools, die er braucht, jeweils namentlich als mcp__paidsync__tool_name.
Was liest und was schreibt
Von den 26 GA4-Tools lesen 11 nur und 13 können schreiben.
Mehr lesen
Lesezugriffe und Berichte umfassen Properties, Datenstreams, Key Events, benutzerdefinierte Dimensionen und Messwerte, Zielgruppen, Google-Ads-Verknüpfungen, erweiterte Messung, eigene Berichte über run_ga4_report und die letzten 30 Minuten über run_ga4_realtime_report.
Schreibzugriffe ändern die Property-Konfiguration: Properties, Datenstreams, Key Events, benutzerdefinierte Dimensionen und Messwerte, Zielgruppen, erweiterte Messung und Google-Ads-Verknüpfungen. Kein GA4-Schreibzugriff hat einen Dry-Run. Jeder wird beim ersten Aufruf angewendet, lesen Sie also die Argumente in der Claude-Code-Abfrage, bevor Sie ihn erlauben. Löschen braucht confirm_destructive.
Über MCP ist die Freigabe die eigene Abfrage von Claude Code. Sie fragt vor dem Ausführen eines Tools nach, außer Sie haben es mit --allowedTools oder in Ihren Einstellungen erlaubt. PaidSync ergänzt Prüfungen auf seiner Seite. Löschen, Pausieren und Budgetänderungen brauchen confirm_destructive, und eine Regelprüfung vor dem Schreiben blockiert unsichere Argumente. Die Freigabekarte und Rückgängig bei einer angewendeten Karte, deren Änderung sich sicher umkehren lässt, gelten nur im PaidSync-Workspace.
Zu ChatGPT hinzufügen: Öffnen Sie PaidSync.ai im Plugin-Verzeichnis von ChatGPT, installieren Sie es und melden Sie sich an.
Zu Claude hinzufügen: Öffnen Sie PaidSync.ai im Connector-Verzeichnis von Claude, klicken Sie auf Verbinden und melden Sie sich an.
Limits im Blick
- Ein Ereignis muss in Ihrem Datenstream bereits feuern, bevor
create_ga4_conversion_eventes als Key Event markieren kann. - GA4-Tools setzen keine Tags auf Ihre Website. Tags liegen im Google Tag Manager, der eine eigene Claude-Code-Einrichtung hat.
setup_ga4_eventerstellt ein GA4-Ereignis-Tag in einem GTM-Workspace, dafür muss also auch GTM verbunden sein. - Wenn Sie ein Key Event mit
delete_ga4_conversion_evententfernen, zählt es nicht mehr als Key Event. GA4 erfasst das Ereignis selbst weiter. - Der Echtzeitbericht deckt nur die letzten 30 Minuten ab. Nutzen Sie
run_ga4_reportfür alles Ältere.
Häufig gestellte Fragen
Wie verbinde ich GA4 mit Claude Code?
Registrieren Sie sich unter paidsync.ai, verbinden Sie Google Analytics 4 im Dashboard mit Ihrer Google-Anmeldung und führen Sie dann in Ihrem Terminal claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp aus. Tippen Sie in einer Sitzung /mcp, wählen Sie paidsync und melden Sie sich mit Ihrem PaidSync-Login an.
Kann Claude Code mein GA4-Setup ändern?
Ja. Claude Code kann Key Events markieren, benutzerdefinierte Dimensionen und Messwerte hinzufügen, Zielgruppen erstellen, die erweiterte Messung ändern und Google Ads verknüpfen. GA4-Schreibzugriffe haben keinen Dry-Run und werden beim ersten Aufruf angewendet, die Abfrage von Claude Code ist also Ihre Kontrolle. Löschen braucht eine ausdrückliche Bestätigung.
Kann Claude Code prüfen, ob das Tracking funktioniert?
Ja. run_ga4_realtime_report zeigt die letzten 30 Minuten, Sie können also ein Testereignis auf Ihrer Website auslösen und Claude Code fragen, ob es angekommen ist.
Funktioniert es im Headless-Modus mit claude -p?
Ja. Sobald Sie sich über /mcp angemeldet haben, nutzt claude -p das gespeicherte OAuth-Token weiter. Lesezugriffe laufen direkt durch. Schreibzugriffe brauchen Sorgfalt. Niemand ist da, um die Claude-Code-Abfrage zu beantworten, deshalb läuft jedes Schreib-Tool, das Sie mit --allowedTools erlaubt haben, direkt durch. Erlauben Sie für einen unbeaufsichtigten Job nur die Lese-Tools, die er braucht.
Ist es kostenlos?
Ja. Der Free-Plan kostet $0 für 100 Tasks im Monat, ohne Karte. Pro beginnt bei $99 im Monat und Team bei $249 im Monat.
26 GA4-Tools. Ein Befehl in Claude Code.