Google Ads mit einem Befehl in Claude Code
Claude Code
Um Google Ads mit Claude Code zu verbinden, fügen Sie PaidSync.ai hinzu: Führen Sie claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp aus, geben Sie /mcp ein und melden Sie sich mit Ihrem PaidSync Login an.
Claude Code erreicht dann Ihre Google-Ads-Konten über 158 Tools: Audits, Suchbegriffe, Keywords, Budgets, Gebote und Kampagnenaufbau. Claude Code fragt vor jedem Tool nach, und die meisten Google-Ads-Schreibaktionen zeigen zuerst einen Testlauf als Vorschau.
Ein Befehl. OAuth-Login, kein Key. Gratis-Plan mit 100 Aufgaben im Monat, Wert $50, ohne Karte.
Der Befehl
Claude Code spricht über Streamable HTTP mit Remote-MCP-Servern. PaidSync ist einer davon. Fügen Sie ihn einmal hinzu, und dasselbe Terminal, das Ihren Code bearbeitet, kann Ihre Google-Ads-Konten lesen und ändern.
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.
2Google Ads im PaidSync-Dashboard verbinden
Klicken Sie bei Google Ads auf Verbinden und melden Sie sich mit dem Google-Konto an, das Ihre Werbekonten erreicht. Google Ads wird über Google OAuth autorisiert. PaidSync speichert die Token im Ruhezustand mit AES-256-GCM verschlüsselt und sieht Ihr Google-Passwort nie.
Schon in Claude Code? Bitten Sie es, connect_google_ads auszuführen. Das Tool liefert einen OAuth-Link, den Sie in Ihrem Browser öffnen.
3Wählen Sie die Konten, die Claude Code sehen soll
Nach der Anmeldung listet PaidSync die Google-Ads-Konten auf, die dieses Login erreicht. Haken Sie die an, die in diesen Workspace gehören. In einer Sitzung zeigt list_accounts sie an, und set_active_account wählt das Konto aus, mit dem Claude Code arbeitet.
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: „Zeige mir die Google-Ads-Leistung der letzten 7 Tage nach Kampagne“
Claude Code liefert Impressionen, Klicks, Kosten und Conversions für jede Kampagne im aktiven Konto. Die Verbindung steht.
Der Free-Plan enthält 100 Tasks im Monat. Pro ab $99 im Monat, Team ab $249.
Google-Ads-Prompts für Claude Code
Jeder Prompt unten entspricht Tools in der PaidSync-Gruppe für Google Ads. Claude Code wählt das Tool. Die letzte Spalte sagt, ob der Aufruf etwas im Konto ändern kann.
| Anfrage | Aufgerufene Tools | Ändert Ihr Konto? |
|---|---|---|
| „Auditiere das Konto und liste die fünf Korrekturen mit dem meisten Budget dahinter“ | run_account_audit | Nein |
| „Zeige die Kampagnenleistung der letzten 30 Tage nach Kosten sortiert, mit Conversions“ | get_campaign_performance | Nein |
| “Which search terms spent money this month with zero conversions?” | get_search_terms_report, get_wasted_spend_report | Nein |
| „Zerlege die Suchbegriffe der letzten 30 Tage in N-Gramme und schlage Ausschluss-Keywords vor“ | analyze_search_term_ngrams | Nein |
| „Füge diese fünf Begriffe als Ausschluss-Keywords mit passender Wortgruppe zur Brand-Kampagne hinzu“ | add_negative_keywords | Ja, nach Ihrer Bestätigung |
| „Senke das Tagesbudget der Generic-Kampagne um 20 Prozent“ | update_campaign_budget | Ja, nach Ihrer Bestätigung |
| „Pausiere jede Kampagne, die letzte Woche Geld ausgegeben hat, ohne Conversions“ | get_campaign_performance, pause_campaign | Ja, nach Ihrer Bestätigung |
| „Baue eine pausierte Suchkampagne für die neue Produktlinie“ | create_search_campaign | 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 "Pull last 7 days Google Ads performance by campaign and flag any campaign that spent money with zero conversions." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/google-ads-$(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 158 Google-Ads-Tools lesen 64 nur und 94 können schreiben.
Mehr lesen
Lesen umfasst Leistung, Keywords, Suchbegriffe, Qualitätsfaktor, Auktionsdaten, Budget-Pacing und Änderungsverlauf, über Tools wie get_keyword_performance, get_quality_score_report, get_auction_insights, get_budget_pacing und get_change_history.
Schreiben umfasst Budgets, Gebote, Keywords, Ausschluss-Keywords, Anzeigen, Erweiterungen, Zielgruppen und Kampagnenaufbau. Create-Tools für Google Ads und die meisten anderen Schreibaktionen zeigen standardmäßig mit dry_run eine Vorschau, sodass der erste Aufruf die Änderung zeigt und ein zweiter sie anwendet.
Ü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
create_search_campaignbaut eine reine Suchkampagne im pausierten Zustand. Suchpartner und das Displaynetzwerk starten ausgeschaltet, das Geotargeting gilt nur nach Präsenz, und die Gebote laufen über manuellen CPC, sofern Sie keine andere Strategie nennen.- Eine Budgetänderung von mehr als 50 Prozent braucht
confirm_large_changezusätzlich zuconfirm_destructive. Dieser Schutz verhindert ein versehentliches 10-faches Budget oder ein Budget von null. remove_campaignist in Google Ads dauerhaft. Eine entfernte Kampagne kann nicht wieder aktiviert werden. Nutzen Siepause_campaign, wenn nur die Auslieferung stoppen soll.Das Kontoaudit deckt die letzten 30 Tage ab und scannt den obersten Teil jeder Dimension nach Kosten, sodass die Werte zeigen, wohin das Geld fließt, und nicht jedes Keyword.
Der Keyword-Bericht liefert die Top 100 Keywords und der Qualitätsfaktor-Bericht die Top 200.
Häufig gestellte Fragen
Wie verbinde ich Google Ads mit Claude Code?
Registrieren Sie sich unter paidsync.ai, verbinden Sie Google Ads im Dashboard über Google OAuth und führen Sie dann in Ihrem Terminal claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp aus. Geben Sie in einer Sitzung /mcp ein, wählen Sie paidsync und melden Sie sich mit Ihrem PaidSync-Login an.
Kann Claude Code meine Google-Ads-Kampagnen ändern?
Ja. Claude Code kann Ausschluss-Keywords hinzufügen, Budgets ändern, Kampagnen pausieren und aktivieren und pausierte Suchkampagnen aufbauen. Claude Code fragt vor jedem Tool nach, sofern Sie es nicht erlaubt haben. Die meisten Schreibaktionen zeigen zuerst einen Testlauf als Vorschau, und Löschungen, Pausierungen und Budgetänderungen brauchen eine ausdrückliche Bestätigung.
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.
Brauche ich ein Google-Ads-Developer-Token?
Nein. PaidSync ist ein gehosteter Server unter https://mcp.paidsync.ai/mcp. Sie melden sich bei Google Ads über Google OAuth im PaidSync-Dashboard an und bei PaidSync über /mcp in Claude Code.
Ist es kostenlos?
Ja. Der Free-Tarif kostet $0 für 100 Aufgaben im Monat ohne Karte. Pro beginnt bei $99 im Monat und Team bei $249 im Monat. Claude Code selbst benötigt einen Anthropic-Tarif, der es enthält.
158 Google-Ads-Tools. Ein Befehl in Claude Code.