Google Ads MCP server

Google Ads MCP Server je experimentální lokální MCP server pro práci s Google Ads API. Umožňuje zpřístupnit data z reklamních účtů přes MCP klienta a hodí se hlavně pro dotazy nad kampaněmi, zákaznickými účty a výkonem reklam z AI nástrojů.

Co umí

Podle repozitáře server aktuálně nabízí hlavně tyto nástroje:

search pro dotazy nad daty Google Ads účtu
list_accessible_customers pro přehled zákaznických účtů, ke kterým má přihlášený uživatel přístup

Požadavky

Pro zprovoznění je podle README potřeba:

Python prostředí a pipx
zapnuté API Google Ads API
Application Default Credentials nebo konfigurace přes Python client library Google Ads
scope https://www.googleapis.com/auth/adwords
developer token pro Google Ads API

Autentizace

Tady je příkaz, který používám pro vytvoření Application Default Credentials:

gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=YOUR_CLIENT_JSON_FILE

README uvádí, že po dokončení příkazu je potřeba zkopírovat cestu k vygenerovanému souboru credentials z hlášky Credentials saved to file: [PATH_TO_CREDENTIALS_JSON].

Základní spuštění

README používá jako příklad spuštění přes pipx a přidání serveru do konfigurace Gemini CLI nebo Gemini Code Assist.

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

Poznámky k přístupu

Pokud je přístup ke konkrétnímu zákaznickému účtu vedený přes manager account, je podle README potřeba doplnit ještě GOOGLE_ADS_LOGIN_CUSTOMER_ID s ID manager účtu.

Agent bude pro většinu praktických dotazů potřebovat konkrétní customer ID. Pokud se přepíná mezi více účty, je jednodušší přidávat customer ID rovnou do promptu.

Obsah