Utilizzare il server MCP di Google Ad Manager

Google Ad Manager offre un server Model Context Protocol (MCP) remoto che consente agli agenti AI di interagire in modo sicuro con le reti, l'inventario, gli ordini e i dati utente di Google Ad Manager. Configurando il server MCP di Ad Manager, consenti alle applicazioni di AI come Google Antigravity, Claude e ChatGPT di eseguire azioni come utente Ad Manager.

Il server MCP è disponibile all'indirizzo https://admanager.googleapis.com/mcp.

Prerequisiti

  • Accesso per creare progetti Google Cloud o per visualizzare un progetto Google Cloud esistente.
  • Accesso per modificare le connessioni o le app nei tuoi client AI (ad esempio ChatGPT o Claude).

Configura il server MCP di Ad Manager

Per utilizzare il server MCP di Ad Manager, devi completare i seguenti passaggi:

  • Abilita l'API Ad Manager nel tuo progetto Google Cloud.
  • Configura l'autenticazione dell'utente finale OAuth 2.0.
  • Aggiungi il server MCP al tuo client AI.

Abilita l'API Ad Manager

Per utilizzare il server MCP di Ad Manager, devi abilitare l'API Ad Manager nel tuo progetto Google Cloud. Se devi creare un progetto Google Cloud, consulta la sezione Nuovo progetto.

Abilita l'API

Il server MCP di Ad Manager utilizza OAuth 2.0 per l'autenticazione e l'autorizzazione dell'utente finale. Quando un client AI si connette al server MCP, si autentica come l'utente che esegue il client AI. L'agente AI eredita esattamente i ruoli utente, le appartenenze alle reti e le autorizzazioni di Google Ad Manager dell'utente.

  1. Nella console Google Cloud, vai a Google Auth Platform > Branding.

    Vai a Branding

  2. Se hai già configurato la piattaforma Google Auth, puoi configurare le seguenti impostazioni della schermata per il consenso OAuth in Branding, Pubblico e Accesso ai dati. Se visualizzi il messaggio Google Auth Platform non ancora configurata, fai clic su Inizia:

    1. Nella sezione Informazioni sull'app, per Nome app, inserisci Ad Manager MCP Server o il nome che preferisci.
    2. In Email di assistenza utenti, seleziona il tuo indirizzo email o un gruppo appropriato.
    3. Fai clic su Avanti.
    4. Per Pubblico, seleziona Interno.
    5. Fai clic su Avanti.
    6. In Informazioni di contatto, inserisci un indirizzo email a cui ricevere notifiche in caso di modifiche al tuo progetto.
    7. Fai clic su Avanti.
    8. Nella sezione Fine, leggi le Norme relative ai dati utente: servizi API di Google e, se le accetti, seleziona Accetto le Norme relative ai dati utente: servizi API di Google.
    9. Fai clic su Continua.
    10. Fai clic su Crea.

  3. Fai clic su Accesso ai dati > Aggiungi o rimuovi ambiti. Viene visualizzato un riquadro con un elenco di ambiti per ogni API che hai abilitato nel tuo progetto Google Cloud.

    1. In Aggiungi ambiti manualmente, inserisci gli ambiti OAuth richiesti per il server MCP di Ad Manager:
      • https://www.googleapis.com/auth/admanager (accesso completo per visualizzare e gestire le campagne)
    2. Fai clic su Aggiungi alla tabella.
    3. Fai clic su Aggiorna.
    4. Dopo aver selezionato gli ambiti richiesti dalla tua app, fai clic su Salva nella pagina Accesso ai dati.

Aggiungi il server MCP al client AI

Per aggiungere il server MCP di Ad Manager al client AI, segui le istruzioni per il tuo client:

Antigravity

Per aggiungere il server MCP di Ad Manager ad Antigravity, completa i seguenti passaggi:

  1. Crea un ID client e un client secret OAuth 2.0:

    1. Nella console API di Google, vai a Google Auth Platform > Clients > Create client.

      Vai a Crea client

      Se non hai selezionato un progetto, ti viene chiesto di crearne uno.

    2. Nell'elenco Tipo di applicazione, seleziona Applicazione web.

    3. Nel campo Nome, inserisci un nome per l'applicazione.

    4. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI e poi inserisci https://antigravity.google/oauth-callback nel campo URI.

    5. Fai clic su Crea. Il client è stato creato.

      Si apre la finestra di dialogo Client OAuth 2.0 creato.

    6. Nella sezione Client secret, copia il client secret e salvalo in un luogo sicuro. Puoi copiarlo una sola volta. Se lo perdi, elimina il secret e creane uno nuovo.

  2. Per aggiungere il server MCP di Ad Manager ad Antigravity, aggiorna il file ~/.gemini/config/mcp_config.json:

    {
  "mcpServers": {
    "AdManager-MCP": {
      // Use your chosen MCP server URL.
      "serverUrl": "https://admanager.googleapis.com/mcp",
      "oauth": {
        "clientId": "CLIENT_ID",
        "clientSecret": "CLIENT_SECRET"
      }
    }
  }
}

    Sostituisci CLIENT_ID e CLIENT_SECRET con le tue credenziali client OAuth 2.0.

  3. Per autenticare il server MCP di Ad Manager, consulta Antigravity: Authenticate with OAuth.

Claude.ai

Per aggiungere il server MCP di Ad Manager a Claude.ai, configura un connettore personalizzato con un ID client OAuth e un client secret OAuth:

  1. Crea un ID client e un client secret OAuth 2.0:

    1. Nella console API di Google, vai a Google Auth Platform > Clients > Create client.

      Vai a Crea client

      Se non hai selezionato un progetto, ti viene chiesto di crearne uno.

    2. Nell'elenco Tipo di applicazione, seleziona Applicazione web.

    3. Nel campo Nome, inserisci un nome per l'applicazione.

    4. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI e poi inserisci https://claude.ai/api/mcp/auth_callback nel campo URI.

    5. Fai clic su Crea. Il client è stato creato.

      Si apre la finestra di dialogo Client OAuth 2.0 creato.

    6. Nella sezione Client secret, copia il client secret e salvalo in un luogo sicuro. Puoi copiarlo una sola volta. Se lo perdi, elimina il secret e creane uno nuovo.

  2. Segui le istruzioni per creare un connettore personalizzato. Inserisci l'ID client e il client secret nel menu Impostazioni avanzate.

Claude Code

Per aggiungere il server MCP di Ad Manager a Claude Code, configura un connettore personalizzato con un ID client OAuth e un client secret OAuth:

  1. Installa Claude Code.

  2. Crea un ID client e un client secret OAuth 2.0:

    1. Nella console API di Google, vai a Google Auth Platform > Clients > Create client.

      Vai a Crea client

      Se non hai selezionato un progetto, ti viene chiesto di crearne uno.

    2. Nell'elenco Tipo di applicazione, seleziona Applicazione web.

    3. Nel campo Nome, inserisci un nome per l'applicazione.

    4. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI e poi inserisci https://claude.ai/api/mcp/auth_callback nel campo URI.

    5. Fai clic su Crea. Il client è stato creato.

      Si apre la finestra di dialogo Client OAuth 2.0 creato.

    6. Nella sezione Client secret, copia il client secret e salvalo in un luogo sicuro. Puoi copiarlo una sola volta. Se lo perdi, elimina il secret e creane uno nuovo.

  3. Segui le istruzioni per creare un connettore personalizzato. Inserisci l'ID client e il client secret nel menu Impostazioni avanzate.

Claude Desktop

Per aggiungere il server MCP di Ad Manager a Claude Desktop, configura un connettore personalizzato con un ID client OAuth e un segreto client OAuth:

  1. Installa Claude Desktop.

  2. Crea un ID client e un client secret OAuth 2.0:

    1. Nella console API di Google, vai a Google Auth Platform > Clients > Create client.

      Vai a Crea client

      Se non hai selezionato un progetto, ti viene chiesto di crearne uno.

    2. Nell'elenco Tipo di applicazione, seleziona Applicazione web.

    3. Nel campo Nome, inserisci un nome per l'applicazione.

    4. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI e poi inserisci https://claude.ai/api/mcp/auth_callback nel campo URI.

    5. Fai clic su Crea. Il client è stato creato.

      Si apre la finestra di dialogo Client OAuth 2.0 creato.

    6. Nella sezione Client secret, copia il client secret e salvalo in un luogo sicuro. Puoi copiarlo una sola volta. Se lo perdi, elimina il secret e creane uno nuovo.

  3. Segui le istruzioni per creare un connettore personalizzato. Inserisci l'ID client e il client secret nel menu Impostazioni avanzate.

ChatGPT

Per utilizzare il server MCP di Ad Manager con ChatGPT, devi disporre di un abbonamento a ChatGPT Business.

Per aggiungere il server MCP a ChatGPT, crea un ID client e un client secret OAuth 2.0 di Google, quindi aggiungi il server MCP come app in ChatGPT.

Creare un ID client e un client secret OAuth 2.0

  1. Nella console API di Google, vai a Google Auth Platform > Clients > Create client.

    Vai a Crea client

    Se non hai selezionato un progetto, ti viene chiesto di crearne uno.

  2. Nell'elenco Tipo di applicazione, seleziona Applicazione web.

  3. Nel campo Nome, inserisci un nome per l'applicazione.

  4. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI e poi inserisci https://chatgpt.com/connector_platform_oauth_redirect nel campo URI.

  5. Fai clic su Crea. Il client è stato creato.

    Si apre la finestra di dialogo Client OAuth 2.0 creato.

  6. Nella sezione Client secret, copia il client secret e salvalo in un luogo sicuro. Puoi copiarlo una sola volta. Se lo perdi, elimina il secret e creane uno nuovo.

Aggiungere il server MCP come app in ChatGPT

  1. Accedi a ChatGPT.
  2. Attiva la modalità sviluppatore.
  3. Apri le impostazioni delle app ChatGPT.
  4. Fai clic su Crea app e crea un'app per il server MCP remoto.
  5. Nella sezione OAuth, fornisci l'ID client e il client secret.
  6. Conferma di aver compreso il rischio associato all'utilizzo del server MCP, quindi fai clic su Crea.

Il server MCP viene visualizzato nel menu App ed è pronto per l'uso tramite i prompt della chat.

Cursore

Per aggiungere il server MCP di Ad Manager a Cursor, crea un ID client e un secret. Configura il server MCP con OAuth statico. Cursor utilizza URI di reindirizzamento a seconda di ciò che utilizzi per accedere a Cursor, ad esempio tramite un'applicazione web o desktop.

  1. Crea un ID client e un client secret OAuth 2.0:

    Agenti web o con cursore

    1. Nella console API di Google, vai a Google Auth Platform > Clients > Create client.

      Vai a Crea client

      Se non hai selezionato un progetto, ti viene chiesto di crearne uno.

    2. Nell'elenco Tipo di applicazione, seleziona Applicazione web.

    3. Nel campo Nome, inserisci un nome per l'applicazione.

    4. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI e poi inserisci https://www.cursor.com/agents/mcp/oauth/callback nel campo URI.

    5. Fai clic su Crea. Il client è stato creato.

      Si apre la finestra di dialogo Client OAuth 2.0 creato.

    6. Nella sezione Client secret, copia il client secret e salvalo in un luogo sicuro. Puoi copiarlo una sola volta. Se lo perdi, elimina il secret e creane uno nuovo.

    Desktop

    1. Nella console API di Google, vai a Google Auth Platform > Clients > Create client.

      Vai a Crea client

      Se non hai selezionato un progetto, ti viene chiesto di crearne uno.

    2. Nell'elenco Tipo di applicazione, seleziona Applicazione web.

    3. Nel campo Nome, inserisci un nome per l'applicazione.

    4. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI e poi inserisci http://localhost:8787/callback nel campo URI.

    5. Fai clic su Crea. Il client è stato creato.

      Si apre la finestra di dialogo Client OAuth 2.0 creato.

    6. Nella sezione Client secret, copia il client secret e salvalo in un luogo sicuro. Puoi copiarlo una sola volta. Se lo perdi, elimina il secret e creane uno nuovo.

  2. Segui le istruzioni per configurare il server MCP con OAuth statico.
  3. Utilizzare il server MCP in Chat.

Testare il server MCP di Ad Manager

Dopo aver configurato e autenticato il client MCP, puoi verificare la connessione eseguendo prompt di test nell'interfaccia di chat AI.

Prova a porre al tuo client AI le seguenti domande:

  • "Elenca le reti Google Ad Manager a cui ho accesso".

    Il client chiama list_networks per recuperare e visualizzare i codici di rete e i nomi visualizzati di Ad Manager associati al tuo account utente.

  • "Trova i dettagli per il codice di rete NETWORK_CODE."

    Il client utilizza get_network per recuperare i metadati per la rete specificata.

  • "Mostra i primi 5 ordini nella rete NETWORK_CODE."

    Il client richiama list_orders per eseguire query sugli ordini nella tua rete e riepilogarli.

Se gli strumenti vengono eseguiti correttamente e restituiscono dati di Google Ad Manager, la connessione al server MCP è configurata correttamente.