Claude Code + Google Ads API cez MCP | Návod pre PPC špecialistov

Čo keby si sa Claude Code mohol spýtať: „Ktoré kampane minulý mesiac presiahli CPA 15 € bez jedinej konverzie?", a on ti odpovedal na základe živých dát priamo z tvojho Google Ads účtu? Presne to umožňuje kombinácia Google Ads API a MCP servera. Žiadny export, žiadne kopírovanie tabuliek. Len otázka a odpoveď.

Čo je MCP a prečo ti zmení prácu

MCP (Model Context Protocol) je otvorený štandard od Anthropic, ktorý umožňuje Claude Code pripojiť sa k externým nástrojom, databázam a API. Funguje ako „zásuvka". Nainštaluješ MCP server pre Google Ads a Claude zrazu vie čítať tvoje kampane ako súbor na disku.

Bez MCP musíš dáta exportovať, nakopírovať do chatu a Claude len interpretuje to, čo si mu dal. S MCP sa Claude sám pýta API v reálnom čase: vždy aktuálne čísla, vždy celý účet.

💡 Pre koho je tento návod: PPC špecialistov, ktorí chcú automatizovať reporting, rýchlo analyzovať výkonnosť kampaní alebo nechcú denne otvárať Google Ads UI pre rutinné kontroly.

Čo budeš potrebovať

Claude Code, nainštalovaný a funkčný (claude.ai/download)
Node.js 18+ a npm, overí Claude Code za teba (prompt nižšie)
Google Ads účet s administrátorským prístupom
Google Cloud Console účet, zadarmo na console.cloud.google.com
Asi 5 minút (alebo 45, ak si masochista)

Nechaj Claude Code overiť prostredie za teba:

Skontroluj, či mám nainštalovaný Node.js verzie 18 alebo novšej a npm. Ak nie, povedz mi presne čo nainštalovať a ako.

Kroky 1-3: získanie prístupu

Tieto tri kroky musíš urobiť manuálne, bez ohľadu na zvolený postup. Google vyžaduje autentifikáciu cez UI.

Krok 1

Prihlás sa do Google Ads. V ľavom dolnom rohu klikni na ikonu Admin, potom v ľavom menu vyber API centre. Vyplň formulár: Company name, Company URL, Company type a Intended use (napr. „Personal use - connecting Claude Code AI assistant to Google Ads API for campaign analysis"). Potvrď podmienky a odošli. Developer Token sa zobrazí po schválení, zvyčajne do 24 hodín. Skopíruj ho a ulož, budeš ho potrebovať v Kroku 4.

Google Ads API Centre - formulár na žiadosť o prístup k API

⚠️ Pozor: Developer Token je viazaný na manažérsky (MCC) účet, nie na klientský. Ak spravuješ viacero klientov, token vytvoríš v nadradenom MCC účte.

Krok 2

Otvor Google Cloud Console. Vytvor nový projekt, napr. s názvom claude-ads-mcp. V ľavom menu vyber APIs & Services → Library, vyhľadaj „Google Ads API" a klikni Enable. Potom choď na APIs & Services → Credentials → + Create Credentials → OAuth client ID. Ako typ aplikácie vyber Desktop app, pomenuj ju napr. Claude MCP a potvrď. Stiahni JSON súbor s prihlasovacími údajmi. Uložíš z neho Client ID a Client Secret.

🔨 Pracuje sa na tom

Krok 3

Na získanie Refresh Tokenu použij OAuth 2.0 Playground od Googlu. Klikni na ozubené koliesko vpravo hore, zaškrtni Use your own OAuth credentials a vlož svoj Client ID a Client Secret. V ľavom zozname nájdi Google Ads API v18, zaškrtni scope https://www.googleapis.com/auth/adwords a klikni Authorize APIs. Po povolení klikni Exchange authorization code for tokens. Skopíruj hodnotu Refresh token.

🔨 Pracuje sa na tom

Krok 4

Máš všetky štyri hodnoty z krokov 1-3? Skopíruj prompt nižšie, doplň svoje credentials namiesto zástupných hodnôt a celý text vlož do Claude Code. Ten sa postará o zvyšok.

Pred kopírovaním si priprav 5 hodnôt:

Developer Tokenz Krok 1, Google Ads API Center

Client IDz Krok 2, Google Cloud Credentials

Client Secretz Krok 2, Google Cloud Credentials

Refresh Tokenz Krok 3, OAuth Playground

Vytvor mi Google Ads MCP server pre Claude Code. Urob tieto kroky postupne:

1. Vytvor priečinok google-ads-mcp v mojom domovskom adresári (~)
2. Spusti v ňom: npm init -y
   Potom: npm install google-ads-api @modelcontextprotocol/sdk
3. V package.json nastav "type": "module"
4. Vytvor index.js s MCP serverom (ES module) so 3 nástrojmi:
   - get_campaigns: zoznam kampaní (id, name, status, channel_type,
     budget_micros) pomocou GAQL
   - get_campaign_performance: metriky (clicks, impressions, ctr,
     cost_micros, conversions, cost_per_conversion, average_cpc)
     s parametrom date_range (default LAST_30_DAYS)
   - get_keywords: kľúčové slová s metrikami, voliteľný filter
     campaign_name, LIMIT 100
   Server používa StdioServerTransport, credentials berie z env:
   CLIENT_ID, CLIENT_SECRET, DEVELOPER_TOKEN, REFRESH_TOKEN
5. Pridaj konfiguráciu do ~/.claude/settings.json (ak súbor neexistuje,
   vytvor ho). Do sekcie mcpServers vlož kľúč "google-ads":
   {
     "command": "node",
     "args": ["<absolútna cesta k index.js>"],
     "env": {
       "DEVELOPER_TOKEN": "VLOZsemDeveloperToken",
       "CLIENT_ID": "VLOZsemClientId.apps.googleusercontent.com",
       "CLIENT_SECRET": "VLOZsemClientSecret",
       "REFRESH_TOKEN": "VLOZsemRefreshToken"
     }
   }
   Nahraď VLOZ* skutočnými hodnotami, ktoré ti poviem:
   DEVELOPER_TOKEN: [vlož sem]
   CLIENT_ID: [vlož sem]
   CLIENT_SECRET: [vlož sem]
   REFRESH_TOKEN: [vlož sem]

💡 Tip: Credentials vlož priamo do promptu pred odoslaním. Claude Code ich zapíše priamo do settings.json a ty ich nikde inde nemusíš zadávať ručne.

Po dokončení nechaj Claude Code overiť, či všetko sedí:

Over, či bol MCP server správne nastavený:
1. Existuje ~/google-ads-mcp/index.js?
2. Má package.json nastavený "type": "module"?
3. Je v ~/.claude/settings.json sekcia mcpServers s kľúčom "google-ads" a vyplnenými env hodnotami?
Ak niečo chýba alebo je nesprávne, oprav to.

Krok 5

Reštartuj Claude Code. MCP servery sa načítajú pri spustení. V ľavom paneli klikni na ikonu MCP (zásuvka) a over, že google-ads svieti na zeleno. Ak je červený, skontroluj, či Claude Code správne zapísal cestu k súboru a credentials do settings.json.

🔨 Pracuje sa na tom

Klasický postup krok za krokom. Budeš potrebovať asi 30-45 minút a žiadne predchádzajúce skúsenosti s API.

Krok 4

Teraz vytvoríme MCP server. Otvor terminál a spusti tieto príkazy:

mkdir google-ads-mcp
cd google-ads-mcp
npm init -y
npm install google-ads-api @modelcontextprotocol/sdk

Vytvor súbor index.js s týmto obsahom:

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
import { GoogleAdsApi } from "google-ads-api";

const client = new GoogleAdsApi({
  client_id:       process.env.CLIENT_ID,
  client_secret:   process.env.CLIENT_SECRET,
  developer_token: process.env.DEVELOPER_TOKEN,
});

const server = new Server(
  { name: "google-ads-mcp", version: "1.0.0" },
  { capabilities: { tools: {} } }
);

server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [
    {
      name: "get_campaigns",
      description: "Vráti zoznam aktívnych kampaní z Google Ads účtu",
      inputSchema: {
        type: "object",
        properties: {
          customer_id: { type: "string", description: "Google Ads Customer ID (bez pomlčiek)" }
        },
        required: ["customer_id"]
      }
    },
    {
      name: "get_campaign_performance",
      description: "Vráti metriky kampaní: kliky, impresie, náklady, konverzie, CPA",
      inputSchema: {
        type: "object",
        properties: {
          customer_id: { type: "string" },
          date_range:  { type: "string", description: "napr. LAST_30_DAYS, LAST_7_DAYS, THIS_MONTH" }
        },
        required: ["customer_id"]
      }
    },
    {
      name: "get_keywords",
      description: "Vráti kľúčové slová s výkonnostnými metrikami",
      inputSchema: {
        type: "object",
        properties: {
          customer_id:   { type: "string" },
          campaign_name: { type: "string", description: "Filtrovať podľa názvu kampane (nepovinné)" },
          date_range:    { type: "string" }
        },
        required: ["customer_id"]
      }
    }
  ]
}));

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  const { name, arguments: args } = request.params;
  const customer = client.Customer({
    customer_id:   args.customer_id,
    refresh_token: process.env.REFRESH_TOKEN,
  });
  const dateRange = args.date_range || "LAST_30_DAYS";

  if (name === "get_campaigns") {
    const rows = await customer.query(`
      SELECT campaign.id, campaign.name, campaign.status,
             campaign.advertising_channel_type, campaign_budget.amount_micros
      FROM campaign
      WHERE campaign.status != 'REMOVED'
      ORDER BY campaign.name
    `);
    return { content: [{ type: "text", text: JSON.stringify(rows, null, 2) }] };
  }

  if (name === "get_campaign_performance") {
    const rows = await customer.query(`
      SELECT campaign.name, campaign.status,
             metrics.clicks, metrics.impressions, metrics.ctr,
             metrics.cost_micros, metrics.conversions,
             metrics.cost_per_conversion, metrics.average_cpc
      FROM campaign
      WHERE segments.date DURING ${dateRange}
        AND campaign.status != 'REMOVED'
      ORDER BY metrics.cost_micros DESC
    `);
    return { content: [{ type: "text", text: JSON.stringify(rows, null, 2) }] };
  }

  if (name === "get_keywords") {
    let whereClause = `segments.date DURING ${dateRange}`;
    if (args.campaign_name) {
      whereClause += ` AND campaign.name LIKE '%${args.campaign_name}%'`;
    }
    const rows = await customer.query(`
      SELECT ad_group_criterion.keyword.text,
             ad_group_criterion.keyword.match_type,
             ad_group.name, campaign.name,
             metrics.clicks, metrics.impressions,
             metrics.cost_micros, metrics.conversions,
             metrics.cost_per_conversion
      FROM keyword_view
      WHERE ${whereClause}
        AND ad_group_criterion.status != 'REMOVED'
      ORDER BY metrics.cost_micros DESC
      LIMIT 100
    `);
    return { content: [{ type: "text", text: JSON.stringify(rows, null, 2) }] };
  }

  throw new Error(`Neznámy nástroj: ${name}`);
});

const transport = new StdioServerTransport();
await server.connect(transport);
console.error("Google Ads MCP server spustený");

Uprav package.json: pridaj "type": "module":

{
  "name": "google-ads-mcp",
  "version": "1.0.0",
  "type": "module",
  "main": "index.js",
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.0.0",
    "google-ads-api": "^17.0.0"
  }
}

Krok 5

Otvor (alebo vytvor) konfiguračný súbor Claude Code: ~/.claude/settings.json. Na Macu/Linuxe je to /Users/tvoje-meno/.claude/settings.json, na Windows C:\Users\tvoje-meno\.claude\settings.json. Pridaj sekciu mcpServers:

{
  "mcpServers": {
    "google-ads": {
      "command": "node",
      "args": ["/ABSOLUTNA/CESTA/google-ads-mcp/index.js"],
      "env": {
        "DEVELOPER_TOKEN": "sem_vloz_developer_token",
        "CLIENT_ID":       "sem_vloz_client_id.apps.googleusercontent.com",
        "CLIENT_SECRET":   "sem_vloz_client_secret",
        "REFRESH_TOKEN":   "sem_vloz_refresh_token"
      }
    }
  }
}

⚠️ Bezpečnosť: Súbor settings.json obsahuje citlivé API kľúče. Nikdy ho necommituj do Git repozitára. Pridaj .claude/settings.json do svojho .gitignore.

Krok 6

Reštartuj Claude Code. MCP servery sa načítajú pri spustení. V ľavom paneli klikni na ikonu MCP (zásuvka) a over, že google-ads svieti na zeleno. Ak je červený, skontroluj cestu k súboru a premenné prostredia v settings.json.

🔨 Pracuje sa na tom

Prvý test: opýtaj sa Claude

Otvor nový chat v Claude Code a skús niektorú z týchto otázok. Claude automaticky zavolá MCP nástroj a stiahne dáta z tvojho účtu:

Aké kampane mám aktívne v účte 1234567890?

Porovnaj výkon všetkých kampaní za posledných 30 dní.
Ktoré majú CPA nad 20 €?

Ukáž mi kľúčové slová v kampani "Brand_SK" za tento mesiac.
Zoraď ich podľa nákladov zostupne.

🔨 Pracuje sa na tom

Príklady otázok pre každodenné PPC použitie

Keď máš MCP funkčný, toto sú otázky, ktoré ti ušetria hodiny práce každý týždeň:

Denný reporting: „Zhrň výkon všetkých kampaní za včerajší deň: kliky, náklady, konverzie a porovnaj s predchádzajúcim týždňom."
Budget kontrola: „Ktoré kampane utratili viac ako 80 % mesačného budgetu a ešte nie sú ani v polovici mesiaca?"
Optimalizácia kľúčových slov: „Nájdi kľúčové slová s viac ako 100 klikmi a nulou konverzií za posledných 30 dní."
Anomálie: „Porovnaj CTR tento týždeň vs minulý. Kde je pokles väčší ako 20 %?"
Prioritizácia: „Zoraď kampane podľa ROAS zostupne a navrhni, kde zvýšiť budget."

💡 Tip: MCP server môžeš rozšíriť o ďalšie nástroje, napríklad get_ads pre analýzu inzerátov, get_search_terms pre vyhľadávacie výrazy alebo get_audiences. Štruktúra kódu ostáva rovnaká, stačí pridať nový blok do ListToolsRequestSchema a CallToolRequestSchema.

Riešenie bežných problémov

„MCP server sa nespúšťa": over, či je v args absolútna cesta k súboru (nie relatívna). Skontroluj aj node -v, potrebuješ Node.js 18+.
„PERMISSION_DENIED": Developer Token musí byť z MCC (manažérskeho) účtu, nie z klientského. Skontroluj tiež, že máš povolený scope adwords pri generovaní refresh tokenu.
„INVALID_CUSTOMER_ID": Customer ID zadávaj Claude Code priamo v dotaze, bez pomlčiek, len čísla (napr. „kampane v účte 1234567890").
„Token expired": Refresh token by nemal expírovať, ale ak si OAuth súhlas odvolal v Google účte, musíš zopakovať Krok 3.

Záver

Kombinácia Claude Code a Google Ads API cez MCP mení spôsob, akým PPC špecialistia pracujú s dátami. Namiesto hodín strávených v reportoch a tabuľkách sa pýtaš v prirodzenom jazyku a dostávaš odpovede z živého účtu okamžite. Toto nastavenie je investícia 5 minút (alebo 45, ak si vybral/a druhý tab), ktorá ti každý týždeň vráti niekoľkonásobok.

Čo je MCP a prečo ti zmení prácu

Čo budeš potrebovať

Kroky 1-3: získanie prístupu

Prvý test: opýtaj sa Claude

Príklady otázok pre každodenné PPC použitie

Riešenie bežných problémov

Záver

Ďalšie články