Google Ads MCP-Server
offiziellGoogle stellt einen eigenen MCP-Server für die Google Ads API bereit, über den KI-Agenten Konto- und Kampagnendaten per GAQL-Abfrage abrufen, Assets anlegen und Labels verwalten können. Der Server läuft lokal oder auf Cloud Run und lässt sich auf reines Lesen einstellen.
Was ein Agent tun kann
- → Zugängliche Werbekonten auflisten
- → Kampagnenleistung per GAQL abrufen
- → Keywords, Suchbegriffe und Budgets analysieren
- → Assets anlegen und Videos hochladen
- → Labels anlegen und Kampagnen zuweisen
Der Server kann keine Gebote ändern, Kampagnen pausieren oder Anzeigen erstellen und keine Assets mit Kampagnen verknüpfen. Seit Version 0.0.6 legt er standardmäßig Assets und Labels an, nach Vorschlag und Bestätigung, und das lässt sich in tools_config.yaml abschalten.
Über den Google Ads MCP-Server
Der Google Ads MCP-Server ist ein Open-Source-Programm, das Google in der GitHub-Organisation googleads und als Paket google-ads-mcp veröffentlicht. Er bildet die Brücke zwischen einem KI-Assistenten und der Google Ads API. Eine gemeinsame, von Google gehostete Adresse gibt es nicht. Sie betreiben ihn selbst, entweder lokal auf einem Rechner oder als eigenen Dienst auf Google Cloud Run, mit dem sich mehrere Personen verbinden können.
Teams stellen damit Fragen zum Konto mit eigenen Worten: Kosten und Conversions pro Kampagne, Suchbegriffe, die Budget verbrauchen, Budgets und Kampagnenstatus. Der Server baut die Google-Ads-Abfrage für den Assistenten und kann nachschlagen, welche Felder sich auswählen, filtern und sortieren lassen. Seit Version 0.0.6 kann er außerdem Assets wie Texte, Bilder, Sitelinks und YouTube-Videos anlegen, Videos hochladen und Labels verwalten.
Der Server kann keine Kampagnen, Anzeigengruppen, Anzeigen, Budgets oder Gebote anlegen, ändern, pausieren oder aktivieren und keine Assets mit Kampagnen verknüpfen. Die möglichen Änderungen laufen in zwei Schritten: zuerst ein geprüfter Vorschlag, dann eine Bestätigung mit Prüfsumme. Für rein lesenden Betrieb schalten Sie die Kategorien für Labels und Assets in der Konfigurationsdatei ab. Der Zugriff auf echte Konten hängt von der Zugriffsstufe des Google-Cloud-Projekts ab.
Das können Sie fragen
- Auf welche Konten habe ich Zugriff, und welches davon ist unser Hauptkonto?
- Zeigen Sie Kosten, Klicks und Conversions pro Kampagne der letzten 30 Tage, sortiert nach Kosten.
- Welche Suchbegriffe haben diesen Monat am meisten gekostet, ohne eine einzige Conversion zu bringen?
- Welche Kampagnen werden derzeit durch ihr Budget begrenzt?
- Legen Sie ein Label namens Q4-Test an und schlagen Sie vor, welchen Kampagnen es zugewiesen werden soll.
Werkzeuge des Servers
- customers_list_accessible_customers
- search_search
- metadata_get_resource_metadata
- assets_create_asset
- assets_upload_video_asset
- labels_manage_labels
- labels_manage_label_associations
Enthalten in diesen Paketen
Google Ads ist in diesen Walma-Paketen enthalten.
Fragen zu Google Ads MCP
Ist der Google Ads MCP-Server kostenlos?+
Der Server ist Open Source unter der Apache-2.0-Lizenz und liegt auf GitHub sowie als Paket google-ads-mcp vor. Für den Server selbst nennt Google keine Gebühr. Sie brauchen ein Google-Cloud-Projekt, und dessen Zugriffsstufe für die Google Ads API entscheidet, ob er echte Konten erreicht. Betreiben Sie ihn auf Cloud Run, läuft das in Ihrem eigenen Projekt.
Wie lautet die URL des Google Ads MCP-Servers?+
Eine gemeinsame Adresse bei Google gibt es nicht. Der Server ist das Paket google-ads-mcp, der Quellcode liegt unter github.com/googleads/google-ads-mcp. Lokal wird er mit pipx gestartet. Wenn Sie ihn auf Google Cloud Run bereitstellen, erhalten Sie eine eigene Dienst-URL, und die Clients verbinden sich mit dieser URL und /mcp am Ende.
Wie funktioniert die Anmeldung?+
Lokal nutzt der Server Application Default Credentials, entweder aus einer OAuth-Clientdatei mit Ihrer eigenen Google-Anmeldung oder aus einem Dienstkonto. Als Remote-Dienst auf Cloud Run verwendet er einen OAuth-Client vom Typ Webanwendung, und jeder Werkzeugaufruf läuft dann unter der Identität der angemeldeten Person. Erforderlich ist der Scope adwords.
Ist der Server schreibgeschützt?+
Standardmäßig nicht. Neben den Lesewerkzeugen gibt es Werkzeuge, die Assets anlegen, Videos hochladen und Labels verwalten. Für rein lesenden Betrieb setzen Sie labels und assets in tools_config.yaml auf false. Kampagnen, Anzeigengruppen, Anzeigen, Budgets oder Gebote kann der Server nie anlegen, ändern, pausieren oder aktivieren.
Mit welchen KI-Assistenten funktioniert er?+
Googles Dokumentation zeigt Gemini CLI, Google Antigravity und Claude und nennt Claude und ChatGPT als Remote-Konnektoren für eine Cloud-Run-Bereitstellung. Die README des Projekts nennt außerdem Claude Code, Cursor, VS Code mit Copilot und Codex CLI. Clients ohne OAuth-Unterstützung erhalten vom Remote-Server die Antwort 401 und müssen die lokale Variante nutzen.
Wie wird eine Änderung vor der Ausführung bestätigt?+
Jedes Schreibwerkzeug beginnt mit einem Vorschlag, der geprüft wird, ohne etwas zu ändern. Der Vorschlag liefert eine Liste der Änderungen und eine Prüfsumme. Ausgeführt wird die Änderung erst, wenn das Werkzeug erneut mit denselben Angaben und der passenden Prüfsumme aufgerufen wird. Google weist darauf hin, dass die Prüfsumme keine Zugriffskontrolle ist: Wer Änderungen ganz verhindern will, schaltet die Kategorien ab.
Warum erreicht der Server nur Testkonten?+
Die Zugriffsstufe hängt am Google-Cloud-Projekt, dem der OAuth-Client oder das Dienstkonto gehört. Neue Projekte erhalten die Stufe Test, die nur Testkonten abdeckt. Für echte Konten ist die Stufe Explorer, Basic oder Standard nötig. Ohne sie schlagen Aufrufe mit dem Fehler CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION fehl.
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.