Google Ads, verifiziert

MCP-Server von Google · Verifiziert

Query Google Ads accounts with GAQL and inspect campaign data and performance metrics through the Google Ads API.

Läuft lokal (Läuft auf deinem Rechner: Die Seite nennt den Installationsbefehl)Läuft mit pipxBraucht API-Schlüssel

Google Ads installieren

Läuft auf deinem Rechner. Dein Client startet ihn mit diesem Befehl:

pipx run google-ads-mcp

Braucht pipx (Python) auf deinem Rechner. Die Schritte unten zeigen, wo der Befehl in jedem Client hingehört.

  • GOOGLE_ADS_DEVELOPER_TOKEN geheim Google Ads API developer token.
  • GOOGLE_PROJECT_ID Google Cloud project ID (credentials come from ADC or GOOGLE_APPLICATION_CREDENTIALS).

Diesen Server teilen

Öffnet diese Seite, mit dem Installationsbefehl und den Einrichtungsschritten.

mcp.tc/i/google-ads

Über den Server

Connects to the Google Ads API so an assistant can search account data, run GAQL queries, look up resource metadata and list the customer accounts the signed-in user can access. Resources expose the API discovery document, available metrics and segments, and release notes.

Runs locally over stdio with pipx (pipx run google-ads-mcp). It needs Google credentials (Application Default Credentials or a credentials file), a Google Cloud project with the Google Ads API enabled, and a Google Ads developer token with at least Explorer access for production accounts. An optional OAuth proxy mode serves streamable HTTP.

Was du damit machen kannst

  • Run searches and GAQL queries against Google Ads accounts
  • Get metadata and available fields for a Google Ads resource such as campaign
  • List customer accounts accessible to the authenticated user
  • Read the Google Ads API discovery document, metrics and segments
  • Read the latest Google Ads API release notes
  • Enable or rename tools through a tools_config.yaml file

Tools

Google Ads zeigt seine Tools nur Clients mit Schlüssel, deshalb können wir sie hier nicht auflisten.

Beispiel-Prompts

  • List the Google Ads customer accounts I can access

  • Show clicks, cost and conversions per campaign for the last 30 days

  • What fields can I query on the ad_group resource?

  • Which campaigns had the highest cost per conversion last week?

Einrichtung

Jeder Client startet Google Ads mit demselben Befehl auf deinem Rechner. Wähl deinen; die Seite merkt sich deine Wahl.

Claude Code

  1. Führe das in einem Terminal in deinem Projektordner aus:
claude mcp add --transport stdio google-ads --env "GOOGLE_ADS_DEVELOPER_TOKEN=<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>" --env "GOOGLE_PROJECT_ID=<YOUR_GOOGLE_PROJECT_ID>" -- pipx run google-ads-mcp
  1. Starte Claude Code und tippe /mcp. google-ads sollte als verbunden angezeigt werden.

Ergänze --scope user, damit er in jedem Projekt verfügbar ist. Ersetze die Platzhalter durch deine eigenen Werte.

Claude Desktop

  1. Öffne Settings → Developer → Edit Config. Das öffnet claude_desktop_config.json. Füge hinzu:
claude_desktop_config.json
{
  "mcpServers": {
    "google-ads": {
      "command": "pipx",
      "args": [
        "run",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_PROJECT_ID": "<YOUR_GOOGLE_PROJECT_ID>"
      }
    }
  }
}
  1. Speichere die Datei und starte Claude Desktop neu. Ersetze die Platzhalter durch deine eigenen Werte.

Braucht pipx (Python) auf deinem Rechner. Die Datei liegt unter macOS in ~/Library/Application Support/Claude/ und unter Windows in %APPDATA%\Claude\.

Cursor

Oder trag ihn von Hand in ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (dieses Projekt) ein:

mcp.json
{
  "mcpServers": {
    "google-ads": {
      "command": "pipx",
      "args": [
        "run",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_PROJECT_ID": "<YOUR_GOOGLE_PROJECT_ID>"
      }
    }
  }
}

Braucht pipx (Python) auf deinem Rechner. Ersetze die Platzhalter durch deine eigenen Werte.

VS Code

Füge ihn zu .vscode/mcp.json hinzu. VS Code fragt beim ersten Mal nach dem Secret und speichert es sicher:

.vscode/mcp.json
{
  "servers": {
    "google-ads": {
      "type": "stdio",
      "command": "pipx",
      "args": [
        "run",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "${input:google-ads-developer-token}",
        "GOOGLE_PROJECT_ID": "<YOUR_GOOGLE_PROJECT_ID>"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "google-ads-developer-token",
      "description": "GOOGLE_ADS_DEVELOPER_TOKEN",
      "password": true
    }
  ]
}

Braucht pipx (Python) auf deinem Rechner.

Devin Desktop

  1. Füge ihn zu ~/.config/devin/mcp_config.json (macOS und Linux) oder %APPDATA%\devin\mcp_config.json (Windows) hinzu:
mcp_config.json
{
  "mcpServers": {
    "google-ads": {
      "command": "pipx",
      "args": [
        "run",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_PROJECT_ID": "<YOUR_GOOGLE_PROJECT_ID>"
      }
    }
  }
}
  1. Aktualisiere die Liste der MCP-Server in Cascade. Ersetze die Platzhalter durch deine eigenen Werte.

Devin Desktop ist der neue Name von Windsurf.

Codex

codex mcp add google-ads --env "GOOGLE_ADS_DEVELOPER_TOKEN=<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>" --env "GOOGLE_PROJECT_ID=<YOUR_GOOGLE_PROJECT_ID>" -- pipx run google-ads-mcp

Oder bearbeite ~/.codex/config.toml direkt:

config.toml
[mcp_servers.google-ads]
command = "pipx"
args = ["run", "google-ads-mcp"]
env = { GOOGLE_ADS_DEVELOPER_TOKEN = "<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>", GOOGLE_PROJECT_ID = "<YOUR_GOOGLE_PROJECT_ID>" }

Braucht pipx (Python) auf deinem Rechner. Ersetze die Platzhalter durch deine eigenen Werte.

Gemini CLI

gemini mcp add -e "GOOGLE_ADS_DEVELOPER_TOKEN=<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>" -e "GOOGLE_PROJECT_ID=<YOUR_GOOGLE_PROJECT_ID>" google-ads pipx run google-ads-mcp

Damit fügst du ihn dem aktuellen Projekt hinzu. Ergänze -s user, um ihn überall zu nutzen.

Jeder Client

Die meisten Clients, die lokale Server starten, akzeptieren diese Form:

{
  "mcpServers": {
    "google-ads": {
      "command": "pipx",
      "args": [
        "run",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_PROJECT_ID": "<YOUR_GOOGLE_PROJECT_ID>"
      }
    }
  }
}

Zed legt Server in seinen Einstellungen unter context_servers ab, mit denselben Feldern command, args und env.

Braucht pipx (Python) auf deinem Rechner. Ersetze die Platzhalter durch deine eigenen Werte.

Häufige Fragen

Kann ich mcp.tc/i/google-ads in meinen MCP-Client einfügen?

Nein. Google Ads läuft auf deinem eigenen Rechner und wird von deinem Client gestartet, hat also keine Webadresse, mit der man sich verbinden könnte. Der Quick-Link ist die Seite zum Teilen; der Installationsbefehl lautet pipx run google-ads-mcp.

Braucht Google Ads einen API-Schlüssel?

Ja. Er liest GOOGLE_ADS_DEVELOPER_TOKEN und GOOGLE_PROJECT_ID aus seiner Umgebung, und GOOGLE_ADS_DEVELOPER_TOKEN ist geheim. Trag den Wert in die Konfiguration deines Clients auf deinem eigenen Rechner ein, nie in eine geteilte Datei.

Ist Google Ads ein Remote- oder ein lokaler Server?

Lokal. Dein Client startet ihn als Prozess auf deinem Rechner, mit pipx run google-ads-mcp, was pipx (Python) braucht.

Welche Clients können ihn nutzen?

Jeder Client, der lokale Server startet: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed und andere. claude.ai und ChatGPT verbinden sich nur mit Remote-Servern.

Wer hat diese Seite geschrieben?

Der Roboter von mcp.tc hat die öffentlichen Metadaten von Google Ads (seine Paket- und Repository-Seiten) gelesen, und ein KI-Modell hat daraus den Text entworfen. Ein Mensch prüft alles, was die Prüfungen nicht bestätigen können. Der Text kann trotzdem falsch sein; wenn dir ein Fehler auffällt, nutze Eintrag melden auf dieser Seite.

Einbinden

Zeig Google Ads in einem README oder auf deiner Website. Jede Einbindung verlinkt auf diese Seite, nutzt den Installationsbefehl des Servers und setzt keine Cookies. So funktionieren Einbindungen

README-Badge

Badge-Vorschau, hellBadge-Vorschau, dunkel
Markdown
[![Google Ads on mcp.tc](https://mcp.tc/i/google-ads/badge.svg)](https://mcp.tc/i/google-ads)
HTML
<a href="https://mcp.tc/i/google-ads"><img src="https://mcp.tc/i/google-ads/badge.svg" alt="Google Ads on mcp.tc" height="20"></a>

Es folgt dem hellen oder dunklen Modus der Lesenden. Hänge ?theme=light oder ?theme=dark an, um ihn festzulegen, oder ?style=compact, um das Zeichen ohne Schriftzug zu zeigen.

Website-Karte

HTML
<script src="https://mcp.tc/w/google-ads.js" async></script>

Die Karte erscheint dort, wo das Tag steht. Füge dem Tag data-theme="dark" oder data-size="compact" hinzu, um sie zu ändern. Die Datei enthält alles, was sie braucht, stellt also keine weiteren Anfragen und setzt keine Cookies.

iframe

HTML
<iframe src="https://mcp.tc/embed/google-ads" title="Google Ads on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Nutze es auf Seiten, die keine Skripte erlauben. Hänge ?theme=light oder ?theme=dark an die Adresse an, um die Farben festzulegen.

JSON

Der Eintrag als Daten für deine eigenen Seiten und Tools: Name, Kurzbeschreibung, Installationsbefehl, Tools und die „Add to“-Links. Jede Website kann ihn lesen (CORS ist offen).

https://mcp.tc/i/google-ads.json

Was jedes Feld bedeutet

mcp.tc ist nicht mit Google verbunden. Diese Seite entstand aus den öffentlichen Metadaten von Google Ads, zuletzt geprüft am 3. Okt. 2026, und ein KI-Modell hat die Beschreibung geschrieben, sie kann also Fehler enthalten. Namen und Marken gehören ihren Inhabern. Stimmt etwas nicht? Eintrag melden.