google-ads-mcp

Ein schreibgeschützter MCP-Server für die Google Ads API. Er stellt Reporting-Tools (Kampagnen, Anzeigengruppen, Keywords und rohe GAQL-Abfragen) bere it, sodass ein MCP-Client (Claude Code, Claude Desktop usw.) Ihr Google-Ads-Konto abfragen kann. Es gibt keine Mutate-/Write-Tools – dieser Server kann keine Kampagnen, Budgets oder Gebote ändern.

Tools

Voraussetzungen

Für die Google Ads API benötigen Sie Zugangsdaten:

1. Ein Entwickeltoken aus dem Google Ads API Center (Tools und Einstellungen → API Center) auf dem Verwaltungskonto, mit dem Sie sich authentizieren.

2. Eine OAuth2-Client-ID / Client-Secret aus einem Google-Cloud-Projekt, in dem die Google Ads API aktiv ert (ist.

3. Ein Refresh-Token für einen Benutzer mit Zugriff auf das Zielkonto (oder die Zielkonten). Siehe Googles Leitfaden für den OAuth-Desktop-Ablauf oder führe das Hilfsskript aus, das der Python-Biblio the k google-ads entalten ist.

4. Wenn Sie sich im Auftrag eines Kundenkontos über ein Verwaltungskonto (MCC) authentifiziern, benötigen Sie dessen login_customer_id.

Einrichtung

# from the repo root
pip install -e .

Konfigurieren Sie die Zugangsdaten eine auf zwei Arten:

Option A: YAML-Datei

cp google-ads.yaml.example google-ads.yaml
# edit google-ads.yaml with your values

Option B: Umgebungsvariabelen

cp .env.example .env
# edit .env, then export the variables into your shell environment

google-ads.yaml im aktuellen Verzeichnis oder die GOOGLE_ADS_*- Umgebungsvariabelen werden automatisch erkannt. Seten Sie GOOGLE_ADS_CONFIGURATION_FILE_PATH, um eine YAML-Datei an einem anderen Speicherort zu verwenden, wenn Sie das bevorzugst.

Eigenständiges Ausführen

python -m google_ads_mcp
# or, after `pip install -e .`:
google-ads-mcp

Der Server oder communiciert über stdio, gemäß der MCP-Spezifikation.

Bei einem MCP-Client registrieren

C laude Code (.mcp.json auf Projetebene oder claude mcp add):

{
  "mcpServers": {
    "google-ads": {
      "command": "google-ads-mcp",
      "env": {
        "GOOGLE_ADS_CONFIGURATION_FILE_PATH": "/absolute/path/to/google-ads.yaml"
      }
    }
  }
}

C laude Desktop (claude_desktop_config.json): derelbe mcpServes- Eintrag wie oben.

Sicherheitshinweise

• Dieser Server gibt ausschließlich GAQL-SELECT- Abfragen über GoogleAdsService.SearchStream aus. GAQL hat keinINSERT/UPDATE/DELETE- Syntax, sodass es ein kein möglich way gibt, Google Ads-Daten über diese Tools zu ändern.

• Commiten Sie nie google-ads.yaml oder .env – beide sind, von Git ignoriert. Behandln Sie Ihr Entwickertoken, OAuth-Client-Secret und Refresh-Token als sicherheitsre Anmeldedaten.

• customer_id und Entität-IDs werden numerisch validiert, bevor sie in GAQL-Query-Strings interpoliert werden.