Server MCP di Google Ads: guida all'integrazione per gli sviluppatori

Il Model Context Protocol (MCP) è uno standard aperto che consente ai modelli linguistici di grandi dimensioni (LLM) di interagire in modo sicuro con dati e applicazioni esterni. Il server MCP di Google Ads fornisce un ponte standardizzato all'API Google Ads, consentendo agli agenti AI di analizzare e recuperare i dati delle campagne utilizzando il linguaggio naturale.

Panoramica tecnica

Implementando questo server MCP, non è più necessario scrivere "codice glue" personalizzato per l'autenticazione dell'API Google Ads, il recupero delle risorse e l'analisi dei dati. Il server espone strumenti specifici che un LLM può scoprire e richiamare in modo autonomo.

Specifiche principali

  • Protocollo: MCP (Model Context Protocol)
  • Modalità:sola lettura (versione attuale)
  • Lingua: Python
  • Trasporto: ingresso/uscita standard (stdio)
  • Autenticazione:OAuth 2.0 o service account

Come funziona il ciclo di interazione

  1. Richiesta:un utente invia una query come "Come sta andando il rendimento della mia campagna questa settimana?".
  2. Scoperta: l'LLM esamina gli strumenti disponibili e identifica le google-ads-mcp funzionalità di ricerca.
  3. Esecuzione:il server MCP esegue la logica Python sottostante per eseguire query sull'API Google Ads.
  4. Inserimento del contesto:i risultati strutturati vengono restituiti alla finestra di contesto dell'LLM.
  5. Risposta:l'LLM sintetizza i dati in una risposta leggibile da una persona.

Inizia

Segui questi passaggi per configurare e utilizzare il server MCP di Google Ads.

Prerequisiti

Prima della configurazione, assicurati di disporre delle seguenti credenziali della console per sviluppatori Google Ads:

  • Token sviluppatore:la tua stringa di accesso univoca di 22 caratteri.
  • ID progetto:l'identificatore del tuo progetto Google Cloud.
  • File delle credenziali:un credentials.json autorizzato (OAuth 2.0 o service account).

Configurazione

Per integrare il server in un host compatibile con MCP, aggiungi la seguente voce al file di configurazione MCP dell'host (ad es. settings.json). Consulta la documentazione del tuo host per la posizione e il nome file esatti di questa configurazione.

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/your/credentials.json",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

Funzionalità principali (strumenti)

Il server espone strumenti progettati per il rilevamento degli account e la generazione di report sul rendimento:

  • list_accessible_customers: restituisce l'elenco degli ID cliente Google Ads e dei nomi degli account accessibili all'utente autenticato.
  • search: esegue richieste Google Ads Query Language (GAQL) per recuperare metriche, budget e stato delle campagne.

Prompt di esempio per iniziare

Chiedi cosa può fare il server:

What can the google-ads-mcp server do?

Domande sui clienti:

What customers do I have access to?

Domande sulle campagne:

How many active campaigns do I have?
How is my campaign performance this week?

Risorse e assistenza della community