Google Ads MCP: costruisci l’intero albero dal tuo agente, in modo atomico

Esiste un server MCP per Google Ads? Sì. Hermoso è un server MCP per Google Ads ospitato online. Aggiungi https://app.hermoso.ai/mcp a Claude, ChatGPT o Cursor e collega il tuo account Google Ads una sola volta. Il tuo assistente può poi creare campagne Search, display e Performance Max, trovare idee di parole chiave, impostare budget, offerte e targeting, ed eseguire report. Attivare una campagna richiede sempre la tua conferma esplicita.

Google Ads è un albero, e gli alberi sono il punto in cui la creazione di campagne via script di solito va storta. Crei un budget, poi una campagna, poi un gruppo di annunci, poi un annuncio. Se l’annuncio viene respinto al quarto passaggio ti ritrovi con tre oggetti orfani e un budget che non volevi. Ripulire tutto a mano è il motivo per cui la maggior parte delle persone rinuncia ad automatizzare Google Ads.

Il server MCP di Hermoso costruisce l’intero albero in una sola operazione atomica, usando id di risorsa temporanei in modo che i figli possano fare riferimento a genitori che non esistono ancora. O esistono tutti insieme campagna, gruppo di annunci, annuncio e parole chiave, oppure non esiste nessuno di loro. Un annuncio respinto significa che non è stato creato nemmeno il budget.

Installalo una volta: in Claude.ai o Claude Desktop incolla https://app.hermoso.ai/mcp in Impostazioni → Connettori e approvalo con il tuo account Hermoso. In un agente di programmazione basta un comando: /plugin marketplace add hermoso-ai/hermoso e poi /plugin install hermoso@hermoso in Claude Code, codex plugin marketplace add hermoso-ai/hermoso e poi codex plugin add hermoso@hermoso in Codex, oppure npx skills add hermoso-ai/hermoso -a cursor in Cursor (sostituisci -a con il nome del tuo agente), poi accedi una volta con npx -y hermoso auth login. Setup completo nella pagina MCP e CLI.

Gli strumenti di Google Ads

Costruire. create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad, add_google_ads_keywords, create_google_ads_performance_max_campaign, upload_google_ads_asset, add_google_ads_assets per sitelink, callout e snippet strutturati.

Configurare. set_google_ads_budget, set_google_ads_bidding (sei strategie), set_google_ads_targeting (area geografica e lingua), find_google_ads_locations, set_google_ads_networks (partner di Search e Display attivi o disattivati), create_google_ads_conversion_action e list_google_ads_conversion_actions.

Ricercare. google_ads_keyword_ideas porta Keyword Planner nella conversazione: volumi di ricerca mensili reali, concorrenza e fasce di offerta in cima alla pagina, partendo da un insieme di parole chiave, da una landing page o da un intero sito.

Leggere e modificare. list_google_ads_campaigns, google_ads_report per GAQL arbitrario, google_ads_change_history per sapere cosa è cambiato nell’account e quando, delete_google_ads_object per eliminarne uno, e set_google_ads_status, l’unico interruttore con conferma obbligatoria che avvia una spesa reale.

create_google_ads_campaign accetta anche una modalità dry run, così un agente può validare un intero albero sull’API live senza creare nulla. È un buon default quando propone un piano da approvare.

Cosa può fare il tuo agente con Google Ads MCP

Ogni riga è uno strumento reale del server. Chiedi in linguaggio naturale e l’agente sceglie quali eseguire.

Esempi di richieste

Incolla una di queste frasi in Claude, ChatGPT o Cursor una volta collegato Hermoso.

• “Trova 30 parole chiave per la nostra app di gestione progetti con un volume di ricerca superiore a 1.000 al mese negli Stati Uniti, e raggruppale per intento.”
  google_ads_keyword_ideas restituisce volumi, concorrenza e fasce di offerta di Keyword Planner, e l’agente le raggruppa.
• “Costruisci una campagna Search in pausa per queste parole chiave: $50 al giorno, Stati Uniti e Canada, inglese, massimizza le conversioni.”
  create_google_ads_campaign costruisce budget, campagna, gruppo di annunci, annuncio e parole chiave in un’unica operazione atomica, in pausa, poi la rilegge.
• “Imposta una campagna Performance Max per il nostro catalogo Shopify usando il feed di Merchant Center.”
  list_merchant_accounts sceglie il negozio, poi create_google_ads_performance_max_campaign la costruisce in pausa con il feed collegato.
• “Quali query di ricerca hanno speso denaro il mese scorso senza convertire? Aggiungi le peggiori dieci come negative.”
  google_ads_report estrae il report delle query di ricerca, poi add_google_ads_keywords aggiunge le negative.
• “Aggiungi quattro sitelink alla nostra campagna di brand: prezzi, demo, casi di studio e contatti.”
  add_google_ads_assets crea i sitelink e li collega alla campagna.
• “Disattiva i partner di Search su ogni campagna e mostrami il prima e il dopo.”
  set_google_ads_networks legge prima l’impostazione attuale, poi la cambia campagna per campagna.
• “Venerdì qualcuno ha cambiato le nostre offerte. Cosa è cambiato?”
  google_ads_change_history elenca le modifiche con gli orari.
• “Collega la nostra proprietà GA4 così che le registrazioni contino come conversioni in Google Ads.”
  link_google_ads_to_analytics le collega, e create_analytics_key_event segna l’evento di registrazione come evento chiave.

Performance Max, costruito allo stesso modo

create_google_ads_performance_max_campaign costruisce il tipo di campagna multicanale di Google (Search, YouTube, Display, Discover, Gmail e Maps da un’unica campagna), e lo fa in un’unica operazione atomica perché Google lo richiede: budget, campagna, targeting di località e lingua, il gruppo di asset e ogni collegamento di asset vanno su insieme, così un asset respinto non lascia dietro una campagna a metà. Viene creata in pausa, e l’intero albero viene riletto da Google prima che il tuo agente ti dica che esiste.

I minimi di asset di Google vengono controllati qui prima di inviare qualsiasi cosa, così un’immagine quadrata mancante produce un messaggio chiaro invece di un rifiuto opaco dell’API: da 3 a 15 titoli di 30 caratteri o meno, da 1 a 5 titoli lunghi fino a 90, da 2 a 5 descrizioni fino a 90, un nome di azienda fino a 25, e almeno un logo, un’immagine di marketing e un’immagine di marketing quadrata. Carica prima le immagini con upload_google_ads_asset e passa i nomi delle risorse. Un video YouTube è facoltativo. Google ne genererà uno dal gruppo di asset se lo ometti.

Performance Max non ha parole chiave e non ha offerte manuali: ottimizza solo verso le conversioni. Quindi la costruzione si rifiuta su un account senza un’azione di conversione attiva, invece di creare una campagna che non può ottimizzare, e indica entrambe le vie d’uscita: crearne una con create_google_ads_conversion_action, oppure usare una strategia che non ne ha bisogno. Le linee guida del brand sono attive di default per le nuove campagne PMax dalla Google Ads API v21, il che cambia dove il nome dell’azienda e il logo si collegano; Hermoso le collega alla campagna per te.

Performance Max basato sul feed Shopping (retail) funziona allo stesso modo: passa merchantCenterId e la campagna pubblicizza il tuo catalogo di Merchant Center, con feedLabel per restringerlo a un solo feed. Viene costruita e riletta esattamente come la campagna sopra. La rilettura riporta l’account di Merchant Center e l’etichetta del feed che Google ha effettivamente salvato, così puoi vedere che è davvero una campagna retail invece di fidarti della nostra parola. Pubblicizza l’intero feed sotto un unico listing group radice; la suddivisione di un feed per marchio, categoria o etichetta personalizzata non è implementata, e viene rifiutata per nome invece di essere ignorata in silenzio, così non puoi mai credere di aver ristretto un feed quando non l’hai fatto.

Merchant Center, così l’agente sa cosa sta vendendo

“Perché questo prodotto non compare?” è una domanda a cui il reporting di Google Ads non può rispondere per sua struttura, perché un prodotto disapprovato non ha impressioni da riportare. Quella risposta sta in Merchant Center, e la stessa connessione Google vi accede, senza un secondo login.

Il tuo agente può elencare gli account di Merchant Center a cui il tuo account Google collegato ha accesso con list_merchant_accounts (un’agenzia di solito ne ha più d’uno, quindi chiede quale negozio usare invece di indovinare), leggere i prodotti di un feed con list_merchant_products (il catalogo reale che una campagna Performance Max Shopping o retail serve) e leggere i problemi a livello di account che Google segnala con list_merchant_issues. Basta per scrivere testi di annunci su prodotti che esistono davvero, a prezzi davvero attivi, e per spiegare una campagna silenziosa.

Anche scrive. create_merchant_data_source crea un feed prodotti via API, upsert_merchant_product inserisce un prodotto al suo interno, update_merchant_product modifica i campi che cambiano ogni giorno (prezzo e disponibilità), e delete_merchant_product e delete_merchant_data_source rimuovono questi elementi previa conferma. list_merchant_data_sources mostra quali feed possono davvero accettare una scrittura.

Tre cose da sapere subito. Google blocca ogni chiamata all’API di Merchant finché il progetto Cloud di Hermoso non è registrato sul tuo account di Merchant Center, quindi register_merchant_developer esegue quel collegamento una volta sola e lo dichiara. Non è una connessione rotta, e riconnettersi non la risolve. Le scritture di prodotto vanno solo in un feed dati API: un feed file, un autofeed e il feed che crea l’interfaccia di Merchant Center stessa si elencano normalmente ma rifiutano tutte le scritture, quindi Hermoso risolve per te un feed scrivibile, ne crea uno se non ce n’è, e si rifiuta per nome se ce ne sono più di uno, invece di mettere il tuo prodotto in un mercato che le tue campagne potrebbero non coprire. E upsert_merchant_product è una scrittura di riga intera, mentre update_merchant_product è una patch. Al primo invia ogni campo che vuoi mantenere, al secondo solo i campi che stai cambiando.

Niente di tutto questo significa che devi spostare il catalogo. Se il feed vive già in Shopify o nella tua piattaforma, lascialo lì e lascia che l’agente lo legga; le scritture servono nei casi in cui nessuno possiede ancora il feed, o quando un prezzo o una disponibilità va corretto subito invece che alla sincronizzazione successiva.

Google Analytics 4, per vedere cosa hanno fatto i clic

Il reporting di Google Ads finisce al clic. Ciò che accade dopo (la sessione, la registrazione, l’ordine) vive in Google Analytics, e lo stesso accesso Google lo raggiunge (è una connessione a sé, perché richiede un permesso proprio).

Il tuo agente può risolvere quale proprietà GA4 leggere con list_analytics_properties. Conta perché ogni chiamata ad Analytics richiede un id numerico di proprietà, mentre quello che hai davvero è l’ID di misurazione G-XXXXXXXXX dal tuo snippet di tracciamento. Poi analytics_report restituisce sessioni, utenti, conversioni e ricavi suddivisi per canale, sorgente/mezzo, campagna, landing page, paese, dispositivo o data, e analytics_realtime mostra chi è sul sito in questo momento. Quindi “costruisci la campagna” e “dimmi quanto ha guadagnato” sono la stessa conversazione.

Anche scrive, e questa è la parte che torna direttamente in Google Ads: create_analytics_key_event segna un evento che GA4 già raccoglie come evento chiave, che è esattamente ciò che Google Ads importa come conversione, e un’azione di conversione è ciò senza cui ogni strategia smart bidding di questa pagina non può funzionare. create_analytics_custom_dimension registra un parametro di evento così che i report possano essere suddivisi per quel parametro, e list_analytics_definitions mostra cosa la proprietà già misura prima di aggiungere l’uno o l’altro. Due cose restano vere per sempre: questo è solo GA4, perché l’API non ha alcuna superficie Universal Analytics, e una dimensione personalizzata può essere archiviata ma mai eliminata, con 50 slot a livello di evento per proprietà, quindi l’agente controlla prima l’insieme esistente.

Il gate sulla spesa reale va oltre un solo strumento

Mettere in pausa una campagna non è l’unico modo per evitare la spesa, e trattarlo così è una trappola reale: creare un gruppo di annunci, un annuncio o una parola chiave attivi sotto un genitore già attivo viene servito alla prossima asta. Quindi la stessa conferma che protegge set_google_ads_status protegge anche create_google_ads_ad_group, create_google_ads_ad e add_google_ads_keywords ogni volta che il genitore è attivo, letto dalla riga che ciascuno di essi già recupera, senza un viaggio di andata e ritorno in più. Le parole chiave negative limitano soltanto la spesa, quindi non sono mai sottoposte al gate.

Report GAQL, con un’avvertenza da conoscere

google_ads_report accetta GAQL arbitrario, quindi il tuo agente può chiedere la fetta di dati che gli serve invece di essere costretto in una forma di report fissa. Una cosa da tenere a mente se scrivi le query a mano o lasci che un modello le scriva: GAQL non è SQL. Non ha sottoquery, e IN accetta una lista letterale. Un WHERE id IN (SELECT …) non è valido e fallirà invece di restituire in silenzio le righe sbagliate. Passa il risultato direttamente a un foglio di calcolo con create_sheet e append_to_sheet, oppure a un documento con create_doc.

Rileggi, poi riferisci

Dopo la mutazione, l’albero viene riletto da Google e il riepilogo che ricevi è costruito da quella rilettura, mai da ciò che era stato richiesto. È una piccola disciplina che intercetta il caso specifico in cui un agente racconta con sicurezza una campagna che la piattaforma ha in realtà forzato o respinto.

Cosa non farà senza chiedere

Un agente con un budget è utile solo se il raggio d’impatto è limitato, quindi l’autorità di spesa è vincolata nel server e non in un prompt. Le campagne, i gruppi di annunci e gli annunci Meta vengono creati PAUSED senza alcuna sostituzione da parte del chiamante. Gli interruttori di stato che possono attivare una spesa pubblicitaria reale (uno per ogni piattaforma pubblicitaria: set_meta_campaign_status, set_google_ads_status, set_microsoft_ads_status, set_reddit_ads_status, set_linkedin_ads_status, set_pinterest_ads_status, set_x_ads_status e set_openai_ads_status tra gli altri) rifiutano tutti di eseguire senza un flag di conferma esplicito, e lo stesso gate copre la creazione di un gruppo di annunci, annuncio o parola chiave attivi in Google Ads sotto un genitore già attivo, perché viene servito alla prossima asta immediatamente. Anche le eliminazioni richiedono conferma. Sul fronte della generazione, hermoso_capabilities pubblica il costo esatto in crediti di ogni modello prima che qualcosa venga eseguito, e ogni render riserva una stima e poi addebita il costo reale, quindi un invio fallito viene rimborsato invece di essere addebitato in silenzio.

Collegare il tuo account Google Ads

Colleghi Google Ads a Hermoso tramite il flusso OAuth ufficiale di Google nelle Impostazioni, Connettori; nessuna password passa attraverso il modello. Le connessioni a Google Ads sono condivise a livello di brand, quindi un intero team che lavora su un brand usa un’unica connessione invece che ognuno riautorizzi.

La parte creativa

La gestione delle campagne è utile solo se c’è qualcosa da pubblicare. Lo stesso server ricerca cosa sta già funzionando nel tuo mercato nelle librerie annunci di Meta, Google e LinkedIn, renderizza creatività finite di immagine e video basate sul tuo prodotto reale con oltre 100 modelli, e carica gli asset, così “cosa dovremmo pubblicare” e “costruisci la campagna” sono un’unica conversazione invece di due strumenti. Vedi la panoramica del marketing MCP, l’elenco completo degli strumenti, oppure il Meta Ads MCP se usi entrambi.

Domande frequenti

Esiste un server MCP per Google Ads?

Sì. Il server MCP di Hermoso costruisce e gestisce Google Ads da qualsiasi client MCP: create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad e add_google_ads_keywords per costruire un albero di ricerca o display; create_google_ads_performance_max_campaign per Performance Max; set_google_ads_budget, set_google_ads_bidding e set_google_ads_targeting per configurare; google_ads_keyword_ideas per la ricerca con Keyword Planner; list_google_ads_campaigns e google_ads_report per i report; letture di Merchant Center per il feed prodotti dietro una campagna Shopping; e set_google_ads_status, con conferma obbligatoria, per attivare.

Un agente IA può creare una campagna Google Ads?

Sì, e l’intero albero viene creato in un’unica operazione atomica usando id di risorsa temporanei: campagna, gruppo di annunci, annuncio responsive di ricerca o display e parole chiave insieme. Se l’annuncio viene respinto, non viene creato nemmeno il budget, quindi non resti a ripulire oggetti orfani. Una modalità dry run valida l’albero sull’API live senza creare nulla.

Può creare una campagna Performance Max?

Sì. create_google_ads_performance_max_campaign costruisce budget, campagna, targeting, gruppo di asset e ogni collegamento di asset in un’unica operazione atomica, perché Google li richiede insieme. La campagna viene creata in pausa e riletta prima che l’agente ne riferisca. I minimi di asset di Google vengono applicati prima di inviare qualsiasi cosa: da 3 a 15 titoli, da 1 a 5 titoli lunghi, da 2 a 5 descrizioni, un nome di azienda, e almeno un logo, un’immagine di marketing e un’immagine di marketing quadrata. PMax ottimizza solo sulle conversioni, quindi si rifiuta di costruirsi su un account senza un’azione di conversione attiva, invece di creare una campagna che non può ottimizzare. Anche Performance Max retail, basato sul feed Shopping, funziona allo stesso modo: passa merchantCenterId e la campagna pubblicizza il tuo catalogo di Merchant Center, con feedLabel per restringerlo a un solo feed, e la rilettura riporta l’account di Merchant Center e l’etichetta del feed che Google ha effettivamente salvato.

Funziona con Google Merchant Center?

Sì, in lettura e in scrittura, sulla stessa connessione Google. L’agente può elencare gli account di Merchant Center a cui il tuo account ha accesso, leggere i prodotti di un feed (il catalogo che una campagna Performance Max Shopping o retail serve davvero) e leggere i problemi a livello di account che Google segnala, che è l’unico posto dove scoprire perché un prodotto non compare, dato che un prodotto disapprovato non ha impressioni da mostrare nel reporting di Google Ads. Google richiede una registrazione una tantum del progetto Cloud di Hermoso sul tuo account di Merchant Center prima che l’API risponda, e c’è uno strumento che la esegue. Scrive anche: create_merchant_data_source, upsert_merchant_product, update_merchant_product per le modifiche di prezzo e disponibilità che cambiano ogni giorno, e delete_merchant_product e delete_merchant_data_source con conferma obbligatoria. Google accetta scritture di prodotto solo in un feed dati API, quindi Hermoso risolve un feed scrivibile per te e si rifiuta per nome se l’account ne ha più di uno.

Può fare ricerca di parole chiave?

Sì. google_ads_keyword_ideas chiama Keyword Planner di Google e restituisce volumi di ricerca mensili reali, concorrenza e fasce di offerta in cima alla pagina, partendo da parole chiave, dall’URL di una landing page o da un intero sito. L’agente può passare quelle parole direttamente a add_google_ads_keywords, oppure scriverle in un foglio Google.

Può avviare la spesa del mio budget Google Ads?

Solo con una conferma esplicita. set_google_ads_status è l’interruttore che attiva il denaro reale, e poiché creare un figlio attivo sotto un genitore già attivo viene servito alla prossima asta, la stessa conferma protegge anche create_google_ads_ad_group, create_google_ads_ad e add_google_ads_keywords quando il genitore è attivo. Le parole chiave negative limitano soltanto la spesa e non sono mai sottoposte al gate.

Può eseguire report?

Sì. google_ads_report accetta GAQL arbitrario, quindi l’agente può chiedere la fetta che gli serve. Nota che GAQL non è SQL: non ha sottoquery e IN accetta una lista letterale, quindi un WHERE id IN (SELECT …) non è valido. I risultati possono essere scritti direttamente in un foglio o in un documento Google.

Quali offerte e targeting può impostare?

Sei strategie di offerta, pianificazione della campagna e targeting geografico e linguistico, con find_google_ads_locations per risolvere per nome le località. I budget si impostano con set_google_ads_budget, e le parole chiave supportano le negative e il CPC per parola chiave.

L’agente riceve la mia password Google?

No. Colleghi Google Ads tramite il flusso OAuth ufficiale di Google nelle Impostazioni, Connettori di Hermoso, e Hermoso conserva il token risultante. L’agente chiama solo gli strumenti di Hermoso. Le connessioni a Google Ads sono condivise a livello di brand, quindi un intero team lavora da un’unica connessione.

Può creare anche la creatività dell’annuncio?

Sì. Lo stesso server ricerca gli annunci dei concorrenti, pianifica il concept, renderizza creatività finite di immagine e video con oltre 100 modelli e il tuo prodotto reale inserito, e carica gli asset con upload_google_ads_asset, quindi ricerca, creatività e costruzione della campagna avvengono in un’unica conversazione.