Google Ads, verificato

Server MCP di Google · Verificato

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

Gira in locale (Gira sul tuo computer: la sua pagina riporta il comando di installazione)Gira con pipxServe una chiave API

Installa Google Ads

Gira sul tuo computer. Il tuo client lo avvia con questo comando:

pipx run google-ads-mcp

Richiede pipx (Python) sul tuo computer. I passaggi qui sotto mostrano dove va il comando in ogni client.

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

Condividi questo server

Apre questa pagina, con il comando di installazione e i passaggi di configurazione.

mcp.tc/i/google-ads

Descrizione

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.

Cosa puoi fare

  • 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

Tool

Google Ads mostra i suoi tool solo ai client con una chiave, quindi non possiamo elencarli qui.

Prompt di esempio

  • 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?

Configurazione

Ogni client avvia Google Ads sul tuo computer con lo stesso comando. Scegli il tuo; la pagina ricorda la tua scelta.

Claude Code

  1. Eseguilo in un terminale, nella cartella del tuo progetto:
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. Avvia Claude Code e digita /mcp. google-ads dovrebbe risultare collegato.

Aggiungi --scope user per renderlo disponibile in tutti i progetti. Sostituisci i segnaposto con i tuoi valori.

Claude Desktop

  1. Apri Settings → Developer → Edit Config. Si apre claude_desktop_config.json. Aggiungi:
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. Salva il file e riavvia Claude Desktop. Sostituisci i segnaposto con i tuoi valori.

Richiede pipx (Python) sul tuo computer. Il file si trova in ~/Library/Application Support/Claude/ su macOS e in %APPDATA%\Claude\ su Windows.

Cursor

Oppure aggiungilo a mano in ~/.cursor/mcp.json (tutti i progetti) o in .cursor/mcp.json (questo progetto):

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>"
      }
    }
  }
}

Richiede pipx (Python) sul tuo computer. Sostituisci i segnaposto con i tuoi valori.

VS Code

Aggiungilo a .vscode/mcp.json. VS Code chiede il segreto la prima volta e lo conserva in modo sicuro:

.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
    }
  ]
}

Richiede pipx (Python) sul tuo computer.

Devin Desktop

  1. Aggiungilo a ~/.config/devin/mcp_config.json (macOS e Linux) o a %APPDATA%\devin\mcp_config.json (Windows):
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. Aggiorna l’elenco dei server MCP in Cascade. Sostituisci i segnaposto con i tuoi valori.

Devin Desktop è il nuovo nome di 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

Oppure modifica direttamente ~/.codex/config.toml:

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>" }

Richiede pipx (Python) sul tuo computer. Sostituisci i segnaposto con i tuoi valori.

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

Così lo aggiungi al progetto corrente. Aggiungi -s user per usarlo ovunque.

Qualsiasi client

La maggior parte dei client che avviano server locali accetta questa forma:

{
  "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 mette i server sotto context_servers nelle sue impostazioni, con gli stessi campi command, args ed env.

Richiede pipx (Python) sul tuo computer. Sostituisci i segnaposto con i tuoi valori.

Domande frequenti

Posso incollare mcp.tc/i/google-ads nel mio client MCP?

No. Google Ads gira sul tuo computer, avviato dal tuo client, quindi non ha un indirizzo web a cui collegarsi. Il link rapido è la pagina da condividere; il comando di installazione è pipx run google-ads-mcp.

Google Ads richiede una chiave API?

Sì. Legge GOOGLE_ADS_DEVELOPER_TOKEN e GOOGLE_PROJECT_ID dal suo ambiente, e GOOGLE_ADS_DEVELOPER_TOKEN è un segreto. Metti il valore nella configurazione del tuo client sul tuo computer, mai in un file condiviso.

Google Ads è un server remoto o locale?

Locale. Il tuo client lo avvia come processo sul tuo computer con pipx run google-ads-mcp, che richiede pipx (Python).

Quali client possono usarlo?

Qualsiasi client che avvia server locali: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed e altri. claude.ai e ChatGPT si collegano solo a server remoti.

Chi ha scritto questa pagina?

Il robot di mcp.tc ha letto i metadati pubblici di Google Ads (le pagine del suo pacchetto e del repository), e un modello di AI ne ha ricavato il testo. Una persona esamina tutto ciò che i controlli non riescono a confermare. Il testo può comunque contenere errori, quindi se ne trovi uno usa Segnala questa scheda su questa pagina.

Embed

Mostra Google Ads in un README o sul tuo sito. Ogni embed rimanda a questa pagina, usa il comando di installazione del server e non imposta cookie. Come funzionano gli embed

Badge per il README

Anteprima del badge, chiaroAnteprima del badge, scuro
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>

Segue la modalità chiara o scura di chi legge. Aggiungi ?theme=light o ?theme=dark per fissarla, oppure ?style=compact per mostrare il simbolo senza la scritta.

Scheda per il sito

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

La scheda compare dove si trova il tag. Aggiungi data-theme="dark" o data-size="compact" al tag per cambiarla. Il file contiene tutto ciò che serve, quindi non fa altre richieste e non imposta cookie.

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>

Usalo nelle pagine che non consentono script. Aggiungi ?theme=light o ?theme=dark all’indirizzo per fissare i colori.

JSON

La scheda come dati per le tue pagine e i tuoi strumenti: nome, descrizione breve, comando di installazione, tool e i link «Aggiungi a». Qualsiasi sito può leggerla (CORS aperto).

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

Cosa significa ogni campo

mcp.tc non è affiliato a Google. Questa pagina è stata costruita dai metadati pubblici di Google Ads (ultimo controllo: 3 ott 2026), e la descrizione l’ha scritta un modello di AI, quindi può contenere errori. Nomi e marchi appartengono ai rispettivi titolari. Qualcosa non va? Segnala questa scheda.