Diese Anleitung zeigt, wie du Google Ads an Claude Code anbindest, sodass Claude Kampagnen, Kosten, Suchbegriffe und Auktionsdaten direkt auswerten kann. Sie ist Teil einer Serie über das Anbinden von Marketing-Daten an Claude Code.
Google Ads hat von den vier Plattformen der Serie das etwas aufwändigste Setup, weil drei Dinge zusammenkommen: ein Developer Token, OAuth-Credentials und ein Refresh Token. Einmal eingerichtet, läuft es dann genauso reibungslos wie die anderen.
Wie es funktioniert
Wie bei den anderen Plattformen spricht Claude Code nicht direkt mit Google. Es schreibt ein Python-Script, das die offizielle Google Ads API abfragt und das Ergebnis als JSON speichert. Die Zugangsdaten liegen gebündelt in einer Datei namens google-ads.yaml.
Script-Weg: Claude schreibt das Script, das Script fragt die API ab
- Du
Frage in normaler Sprache
- Claude Code
schreibt ein Python-Script
- Python-Script
fragt die API ab
- Google Ads API liest in dieser Konfiguration nur
- JSON-Datei
lokal gespeichert. Claude liest sie aus und antwortet
Zugangsdaten, die das Script liest:
~/.api-credentials/google-ads.yaml
Voraussetzungen
- Zugriff auf das Google-Ads-Konto, das du auswerten willst.
- Ein Google-Ads-Verwaltungskonto (MCC), denn nur dort lässt sich der Developer Token beantragen.
- Python 3 und Claude Code installiert.
- Ein Google-Cloud-Projekt.
Schritt 1: Developer Token beantragen
Der Developer Token ist der Schlüssel zur Google Ads API. Du beantragst ihn im Verwaltungskonto (MCC):
- Öffne das API Center deines Verwaltungskontos direkt über ads.google.com/aw/apicenter.
- Den Developer Token notieren.
Frisch erstellte Tokens haben zunächst nur “Test”-Zugriff, funktionieren also nur mit Testkonten. Für echte Konten brauchst du mindestens Basic Access. Den beantragst du im API Center über das Drop-down neben “Access level” mit “Apply for Basic Access”. Voraussetzung: eine gültige, regelmässig geprüfte API-Kontakt-E-Mail im API Center und alle aktiven Konten mit dem Verwaltungskonto verknüpft. Plane für die Freigabe einige Werktage ein.
Schritt 2: OAuth-Credentials in der Google Cloud Console
- Öffne die Google Cloud Console und wähle oder erstelle ein Projekt.
- Aktiviere die Google Ads API über die API-Library.
- Richte bei Bedarf die App im Bereich “Google Auth Platform” ein (früher “OAuth consent screen”): User Type External, eigene Mail als Test-User unter “Audience”.
- Lege im selben Bereich unter “Clients” einen OAuth-Client vom Typ Desktop app an. Du erhältst
client_idundclient_secret. Kopiere dasclient_secretdirekt beim Erstellen, bei neueren Clients ist es danach nicht mehr einsehbar.
Schritt 3: Refresh Token erzeugen
Der Refresh Token erlaubt dem Script den dauerhaften Zugriff, ohne dass du dich jedes Mal neu einloggst. Am einfachsten geht das über den Google OAuth Playground mit dem Scope https://www.googleapis.com/auth/adwords. Claude Code kann dich durch diesen einmaligen Schritt führen.
Schritt 4: google-ads.yaml zusammensetzen
Alle Zugangsdaten kommen gebündelt in eine Datei google-ads.yaml, abgelegt ausserhalb des Projektordners:
Drei Quellen, eine Datei: woher die Werte in der google-ads.yaml kommen
- Verwaltungskonto (MCC), API Center
developer_token - Google Cloud Console, Google Auth Platform
client_idclient_secret - Google OAuth Playground
refresh_token
google-ads.yaml ~/.api-credentials/google-ads.yaml
developer_tokenclient_idclient_secretrefresh_token-
login_customer_idMCC-Nummer, nicht die abgefragte Customer ID
developer_token: DEIN_DEVELOPER_TOKEN
client_id: DEINE_CLIENT_ID
client_secret: DEIN_CLIENT_SECRET
refresh_token: DEIN_REFRESH_TOKEN
login_customer_id: DEIN_MCC_KONTO # optional, bei Zugriff über ein MCC
use_proto_plus: true
Empfohlener Ort:
~/.api-credentials/google-ads.yaml
Diese Datei enthält vollwertige Zugangsdaten und gehört niemals in git.
Schritt 5: Verbindung testen lassen
Das nötige Paket:
pip install google-ads
Ab hier übernimmt Claude Code. Du nennst die Customer ID des Kontos, das ist die zehnstellige Kontonummer oben rechts in Google Ads, und Claude schreibt das Abfrage-Script. Die Google Ads API wird über eine eigene Abfragesprache namens GAQL angesprochen. Auch die musst du nicht kennen, Claude formuliert die Abfragen.
Schritt 6: Claude Code die Auswertung überlassen
Sobald die Verbindung steht, fragst du in normaler Sprache:
- “Zeig mir die Top-10-Kampagnen nach Kosten der letzten 14 Tage, mit Klicks, Conversions und CPA.”
- “Welche Suchbegriffe haben Geld gekostet, aber keine Conversion gebracht?”
- “Vergleiche die Kampagnen-Performance dieser Woche mit der Vorwoche und markiere die grössten Veränderungen.”
Claude schreibt für jede Frage die passende Abfrage, holt die Daten und wertet sie aus.
Sicherheit
google-ads.yamlbündelt mehrere Zugangsdaten in einer Datei. Ausserhalb des Repos ablegen, nie in git.- Der Zugang (Scope
adwords) erlaubt auch Änderungen am Konto. Claude liest nur, solange es reine Abfrage-Scripts schreibt. Ein Script, das etwas ändert, nur bewusst erstellen und zuerst mitvalidate_onlylaufen lassen: Google prüft dann die Änderung, ohne sie auszuführen. - Zugriff entziehen: in der Cloud Console den OAuth-Client löschen oder den Refresh Token im Google-Account widerrufen.
Häufige Stolpersteine
- Authentifizierungsfehler beim ersten Lauf: Refresh Token abgelaufen oder falsch. Über den OAuth Playground neu erzeugen.
- Der Developer Token funktioniert nur mit einem Testkonto: Du hast noch Test-Zugriff. “Basic Access” im API Center beantragen.
- Fehler rund um die
login_customer_id: Beim Zugriff über ein MCC muss die MCC-Kontonummer alslogin_customer_idgesetzt sein. Die abgefragte Customer ID ist eine andere. - Kontonummer mit Bindestrichen: Die Customer ID gehört ohne Bindestriche ins Script, also
1234567890, nicht123-456-7890.
Fazit
Das Setup hat drei Teile, das macht es etwas länger als bei den anderen Plattformen. Der Aufwand fällt aber nur einmal an. Danach beantwortet Claude Code Fragen zu Kosten, Suchbegriffen und Kampagnen in Sekunden. Den vollen Wert entfaltet das in Kombination mit GA4: Google Ads liefert die Kosten, GA4 die Conversions auf der Website.
Häufige Fragen
Warum brauche ich ein MCC-Verwaltungskonto?
Der Developer Token lässt sich nur in einem Verwaltungskonto beantragen. Hast du keines, kannst du kostenlos eines anlegen und dein Werbekonto damit verknüpfen.
Wie lange dauert die Freigabe des Developer Tokens?
Der Test-Zugriff steht sofort bereit. Die Freigabe für “Basic Access”, den du für echte Konten brauchst, kann einige Werktage dauern.
Kann Claude über diese Anbindung Kampagnen ändern?
Solange nur Abfrage-Scripts geschrieben werden, nicht. Die API kann technisch auch schreiben, dafür müsste aber bewusst ein änderndes Script erstellt werden. Für Reporting bleibt es bei reinem Lesen.
Anders beim offiziellen Google-Ads-MCP-Server: Seit Version 0.0.6 (November 2026) kann er Assets anlegen, Videos hochladen und Labels verwalten. Jede Änderung läuft zuerst als Prüflauf und wird erst nach Bestätigung ausgeführt. Kampagnen, Budgets und Gebote kann er nicht ändern.