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:
searchpro dotazy nad daty Google Ads účtulist_accessible_customerspro 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
- 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.
Petr Nosek