Google Ads MCP server [Wiki]

Tato stránka je pouze pro čtení. Můžete si pouze prohlédnout zdrojový kód, ale ne ho měnit. Zeptejte se správce, pokud si myslíte, že něco není v pořádku.
====== 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:

<code bash>
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
</code>

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.

<code json>
{
  "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"
      }
    }
  }
}
</code>

===== 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.

===== Zdroje =====

  * [[https://github.com/googleads/google-ads-mcp|GitHub: googleads/google-ads-mcp]]
  * [[https://developers.google.com/google-ads/api|Google Ads API]]
  * [[https://developers.google.com/google-ads/api/reference/rpc/v21/overview|Google Ads API RPC reference]]
  * [[https://developers.google.com/google-ads/api/docs/get-started/dev-token|Obtaining a Developer Token]]
  * [[https://support.google.com/googleapi/answer/6158841|Enable APIs in Google Cloud project]]