★ DISPONIBILE PER FORMAZIONE E PROGETTI
enrico chiolo

Google Ads MCP Server

Il server MCP ufficiale della Google Ads API: gestito in proprio e in sola lettura, con query GAQL per recuperare dati di account e campagne.

Google Ads MCP Server è il server ufficiale che collega applicazioni AI alla Google Ads API. Google lo ha pubblicato come progetto open source nel 2025 e annunciato formalmente nell’aprile 2026. Il server permette di interrogare account e campagne attraverso GAQL, il linguaggio di query di Google Ads. Opera soltanto in lettura: non può modificare offerte, mettere in pausa campagne o creare annunci.1

Specifiche

Il server è scritto in Python. Può essere avviato come processo locale, comunicando con il client attraverso gli stream standard, oppure distribuito su Cloud Run. L’accesso usa OAuth 2.0 o un account di servizio.

La configurazione richiede un progetto Google Cloud, le relative credenziali e un developer token della Google Ads API. Il server può essere collegato a client come Claude Desktop, Claude Code, Gemini CLI, Cursor e Windsurf.1

I tre tool

Il server espone tre tool:1

  • list_accessible_customers elenca gli account che le credenziali possono leggere;
  • search esegue una query GAQL e restituisce dati di campagne, budget, stato e metriche;
  • get_resource_metadata descrive i campi disponibili per una risorsa, aiutando il modello a costruire la query.

La maggior parte delle domande passa quindi da search. È un’interfaccia compatta, ma sposta sul modello la responsabilità di scrivere GAQL corretto. Alcune versioni create dalla comunità aggiungono strumenti che mostrano la documentazione del linguaggio durante la preparazione della query.2

GOOGLE ADS MCP · I TRE TOOL Google Ads MCP Server sola lettura · Python Google Ads API risorse reportable list_accessible_customers quali account posso leggere search query GAQL su qualunque risorsa get_resource_metadata schema e campi per scrivere GAQL un solo tool search copre quasi ogni domanda: GAQL è il linguaggio completo dell’API

I tre tool del server ufficiale: l'elenco degli account, le query GAQL tramite `search` e i metadati che aiutano il modello a costruirle. La sola lettura impedisce modifiche dirette alle campagne.

Il modello di sicurezza

La sola lettura separa l’analisi dall’esecuzione. Il modello può esaminare campagne e proporre modifiche, ma non applicarle attraverso questo server. Le operazioni di scrittura devono passare da un’integrazione diversa, con autorizzazioni e controlli propri.34

Questa scelta riduce il rischio di spesa o modifiche accidentali. Non garantisce però che l’analisi sia corretta e non impedisce al server di leggere dati sensibili ai quali le credenziali hanno accesso.

Limiti

Il server presenta quattro limiti principali:

  • non esegue alcuna operazione di scrittura;
  • una query GAQL formulata male può restituire numeri plausibili ma non pertinenti;
  • il developer token prevede livelli e quote differenti, con approvazione per l’uso standard;
  • vengono esposti dati strutturati, non la qualità di immagini, video e landing page né il funzionamento interno di Smart Bidding o Performance Max.12

Le credenziali OAuth e i relativi token devono inoltre essere conservati e rinnovati correttamente.

Voci correlate

Bibliografia e sitografia

  • Google Developers, Google Ads MCP server: Developer integration guide, 3 agosto 2026. developers.google.com
  • The Ad Spend, Google Ads MCP Limitations: Read-Only and Self-Hosted, 27 giugno 2026. theadspend.com
  • Soku, Google Ads MCP: The Complete Guide (2026), 8 giugno 2026. soku.ai
  • Stape, AI in Google Tag Manager: give it access, not control, 11 agosto 2026. stape.io

Footnotes

  1. Google Developers, Google Ads MCP server, 2026. ↩ ↩2 ↩3 ↩4

  2. Soku, Google Ads MCP: The Complete Guide, 2026. ↩ ↩2

  3. Stape, AI in Google Tag Manager: give it access, not control, 2026. ↩

  4. The Ad Spend, Google Ads MCP Limitations, 2026. ↩