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

Developer Token, OAuth-Credentials und Refresh Token liegen gebündelt in der google-ads.yaml ausserhalb des Projekts. Solange Claude reine Abfrage-Scripts schreibt, wird nichts verändert.

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):

  1. Öffne das API Center deines Verwaltungskontos direkt über ads.google.com/aw/apicenter.
  2. 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

  1. Öffne die Google Cloud Console und wähle oder erstelle ein Projekt.
  2. Aktiviere die Google Ads API über die API-Library.
  3. 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”.
  4. Lege im selben Bereich unter “Clients” einen OAuth-Client vom Typ Desktop app an. Du erhältst client_id und client_secret. Kopiere das client_secret direkt 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

Developer Token aus dem API Center des Verwaltungskontos, client_id und client_secret aus der Google Cloud Console, Refresh Token aus dem OAuth Playground. Die login_customer_id ist die Nummer des Verwaltungskontos, abgefragt wird eine andere 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.yaml bü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 mit validate_only laufen 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 als login_customer_id gesetzt sein. Die abgefragte Customer ID ist eine andere.
  • Kontonummer mit Bindestrichen: Die Customer ID gehört ohne Bindestriche ins Script, also 1234567890, nicht 123-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.