Google Ads MCP: bouw de hele boom vanuit je agent, in één atomaire bewerking

Is er een Google Ads MCP-server? Ja. Hermoso is een gehoste Google Ads MCP-server. Voeg https://app.hermoso.ai/mcp toe aan Claude, ChatGPT of Cursor en koppel je Google Ads-account één keer. Je assistent kan daarna zoek-, display- en Performance Max-campagnes bouwen, zoekwoordideeën vinden, budgetten, biedingen en targeting instellen, en rapporten draaien. Een campagne aanzetten vraagt altijd om je uitdrukkelijke bevestiging.

Google Ads is een boomstructuur, en juist bij boomstructuren gaat scripted campagnecreatie meestal mis. Je maakt een budget, dan een campagne, dan een advertentiegroep, dan een advertentie. Als de advertentie bij stap vier wordt afgewezen, zit je met drie losse objecten en een budget dat je niet wilde. Dat handmatig opruimen is de reden waarom de meeste mensen het automatiseren van Google Ads opgeven.

Hermoso’s MCP-server bouwt de hele boom in één atomaire bewerking, met tijdelijke resource-id's zodat de onderliggende objecten kunnen verwijzen naar ouders die nog niet bestaan. Ofwel komen de campagne, advertentiegroep, advertentie en zoekwoorden allemaal tot stand, ofwel geen van die. Een afgewezen advertentie betekent dat ook het budget nooit is aangemaakt.

Eenmalig installeren: in Claude.ai of Claude Desktop plak je https://app.hermoso.ai/mcp onder Instellingen → Connectors en keur je het goed met je Hermoso-account. In een coding-agent is het één commando: /plugin marketplace add hermoso-ai/hermoso en daarna /plugin install hermoso@hermoso in Claude Code, codex plugin marketplace add hermoso-ai/hermoso en daarna codex plugin add hermoso@hermoso in Codex, of npx skills add hermoso-ai/hermoso -a cursor in Cursor (geef je eigen agent een naam na -a), en log daarna één keer in met npx -y hermoso auth login. De volledige installatie staat op de MCP- en CLI-pagina.

De Google Ads-tools

Bouwen. 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 voor sitelinks, callouts en gestructureerde fragmenten.

Instellen. set_google_ads_budget, set_google_ads_bidding (zes strategieën), set_google_ads_targeting (locatie en taal), find_google_ads_locations, set_google_ads_networks (zoekpartners en display aan of uit), create_google_ads_conversion_action en list_google_ads_conversion_actions.

Onderzoek. google_ads_keyword_ideas brengt Keyword Planner in het gesprek: echte maandelijkse zoekvolumes, concurrentie en biedbereiken voor de bovenste positie op de pagina, gebaseerd op een set zoekwoorden, een landingspagina of een hele site.

Lezen en wijzigen. list_google_ads_campaigns, google_ads_report voor willekeurige GAQL, google_ads_change_history voor wat er in het account is veranderd en wanneer, delete_google_ads_object om een object te verwijderen, en set_google_ads_status, de ene schakelaar met bevestigingsvereiste die echte uitgaven start.

create_google_ads_campaign accepteert ook een dry-runmodus, zodat een agent een hele boom tegen de live API kan valideren zonder iets aan te maken. Dat is een goede standaard wanneer hij een plan voorstelt dat jij moet goedkeuren.

Wat je agent kan doen met de Google Ads MCP

Elke rij is een echte tool op de server. Vraag het in gewone taal en de agent kiest welke hij draait.

Voorbeeldprompts

Plak een van deze in Claude, ChatGPT of Cursor zodra Hermoso is verbonden.

• “Zoek 30 zoekwoorden voor onze projectmanagement-app met een zoekvolume van meer dan 1.000 per maand in de VS, en groepeer ze op intentie.”
  google_ads_keyword_ideas geeft Keyword Planner-volumes, concurrentie en biedbereiken, en de agent groepeert ze.
• “Bouw een gepauzeerde Search-campagne voor die zoekwoorden: $50 per dag, VS en Canada, Engels, conversies maximaliseren.”
  create_google_ads_campaign bouwt budget, campagne, advertentiegroep, advertentie en zoekwoorden in één atomaire bewerking, gepauzeerd, en leest het daarna terug.
• “Zet een Performance Max-campagne op voor onze Shopify-catalogus met onze Merchant Center-feed.”
  list_merchant_accounts kiest de winkel, en create_google_ads_performance_max_campaign bouwt hem gepauzeerd met de feed eraan gekoppeld.
• “Welke zoektermen hebben vorige maand geld uitgegeven zonder te converteren? Voeg de slechtste tien toe als negatieven.”
  google_ads_report haalt het zoektermenrapport op, daarna voegt add_google_ads_keywords de negatieven toe.
• “Voeg vier sitelinks toe aan onze merkcampagne: prijzen, demo, klantcases en contact.”
  add_google_ads_assets maakt de sitelinks aan en koppelt ze aan de campagne.
• “Zet zoekpartners uit op elke campagne en laat me het voor en na zien.”
  set_google_ads_networks leest eerst de huidige instelling en past die daarna campagne voor campagne aan.
• “Iemand heeft vrijdag onze biedingen veranderd. Wat is er gewijzigd?”
  google_ads_change_history geeft de wijzigingen met tijdstippen.
• “Koppel onze GA4-property zodat aanmeldingen als conversies in Google Ads tellen.”
  link_google_ads_to_analytics koppelt de twee, en create_analytics_key_event markeert de aanmeldingsgebeurtenis als key event.

Performance Max, op dezelfde manier gebouwd

create_google_ads_performance_max_campaign bouwt Googles cross-surface-campagnetype (Search, YouTube, Display, Discover, Gmail en Maps vanuit één campagne), en bouwt het in één atomaire bewerking, omdat Google precies dat vereist: budget, campagne, locatie- en taaltargeting, de asset group en elke assetkoppeling gaan samen omhoog, zodat een afgewezen asset geen half gebouwde campagne achterlaat. Hij wordt gepauzeerd aangemaakt, en de hele boom wordt bij Google teruggelezen voordat je agent zegt dat hij bestaat.

Googles minimumeisen voor assets worden hier gecontroleerd voordat er iets wordt verstuurd, zodat een ontbrekend vierkant beeld een duidelijke melding is en geen ondoorzichtige afwijzing door de API: 3–15 koppen van maximaal 30 tekens, 1–5 lange koppen tot 90, 2–5 beschrijvingen tot 90, één bedrijfsnaam tot 25, en minstens één logo, één marketingbeeld en één vierkant marketingbeeld. Upload de beelden eerst met upload_google_ads_asset en geef de resourcenamen door. Een YouTube-video is optioneel. Google maakt er een uit de asset group als je hem weglaat.

Performance Max heeft geen zoekwoorden en geen handmatige bieding: hij optimaliseert alleen op conversies. Daarom weigert de build op een account zonder ingeschakelde conversieactie, in plaats van een campagne te maken die niet kan optimaliseren, en noemt hij beide uitwegen: maak er een aan met create_google_ads_conversion_action, of gebruik een strategie die dat niet nodig heeft. Merkrichtlijnen staan standaard aan voor nieuwe PMax-campagnes sinds Google Ads API v21, en dat bepaalt waar de bedrijfsnaam en het logo worden gekoppeld; Hermoso koppelt ze voor je aan de campagne.

Shopping-feed (retail) Performance Max werkt op dezelfde manier: geef merchantCenterId door en de campagne adverteert je Merchant Center-catalogus, met feedLabel om hem tot één feed te beperken. Hij wordt net zo gebouwd en teruggelezen als de campagne hierboven. De terugcontrole meldt het Merchant Center-account en het feedlabel die Google daadwerkelijk heeft opgeslagen, zodat je kunt zien dat het echt een retailcampagne is in plaats van ons woord te moeten geloven. Hij adverteert de hele feed onder één root listing group; het verdelen van een feed op merk, categorie of eigen label is niet gebouwd en wordt bij naam geweigerd in plaats van stilzwijgend genegeerd, zodat je nooit kunt denken dat je een feed hebt verkleind terwijl dat niet zo is.

Merchant Center, zodat de agent weet wat hij verkoopt

“Waarom wordt dit product niet getoond?” is een vraag die Google Ads-rapportage structureel niet kan beantwoorden, want een afgekeurd product heeft geen vertoningen om over te rapporteren. Dat antwoord zit in Merchant Center, en dezelfde Google-verbinding bereikt het, zonder tweede login.

Je agent kan de Merchant Center-accounts tonen die je verbonden Google-account kan bereiken met list_merchant_accounts (een bureau heeft er meestal meerdere, dus hij vraagt welke winkel in plaats van te gokken), de producten in een feed lezen met list_merchant_products (de werkelijke catalogus die een Shopping- of retail Performance Max-campagne bedient), en de accountbrede problemen lezen die Google bij het account meldt met list_merchant_issues. Dat is genoeg om advertentieteksten te schrijven over producten die echt bestaan, tegen prijzen die echt live zijn, en om een stille campagne te verklaren.

Het schrijft ook. create_merchant_data_source maakt een API-productfeed, upsert_merchant_product zet een product erin, update_merchant_product wijzigt de velden die dagelijks bewegen (prijs en beschikbaarheid), en delete_merchant_product en delete_merchant_data_source verwijderen ze achter een bevestiging. list_merchant_data_sources laat zien welke feeds echt kunnen worden beschreven.

Drie dingen om vooraf te weten. Google blokkeert elke Merchant API-aanroep totdat het Cloud-project van Hermoso is geregistreerd bij je Merchant Center-account, dus register_merchant_developer legt die koppeling één keer en zegt dat met zoveel woorden. Het is geen kapotte verbinding, en opnieuw verbinden lost het niet op. Productschrijfacties gaan alleen naar een API-databron: een bestandsfeed, een autofeed en de feed die de eigen interface van Merchant Center aanmaakt, geven allemaal normaal lijsten en weigeren schrijven, dus Hermoso zoekt voor je een schrijfbare feed, maakt er één aan als er geen is, en weigert bij naam als er meerdere zijn, in plaats van je product in een markt te zetten waar je campagnes misschien niet op targeten. En upsert_merchant_product is een schrijfactie op hele rij, terwijl update_merchant_product een patch is. Stuur bij de eerste elk veld mee dat je wilt behouden, en bij de tweede alleen de velden die je wijzigt.

Niets hiervan betekent dat je je catalogus moet verplaatsen. Als de feed al in Shopify of je platform staat, laat hem daar en laat de agent hem lezen; de schrijfacties zijn voor de gevallen waarin niets de feed beheert, of waarin één prijs of beschikbaarheid nu moet worden gecorrigeerd in plaats van bij de volgende synchronisatie.

Google Analytics 4, zodat je ziet wat de kliks deden

Google Ads-rapportage eindigt bij de klik. Wat daarna gebeurde (de sessie, de aanmelding, de bestelling) staat in Google Analytics, en dezelfde Google-login bereikt dat ook (het is een eigen verbinding, omdat die een eigen toestemming nodig heeft).

Je agent kan met list_analytics_properties bepalen welke GA4-property hij moet lezen. Dat is belangrijk, want elke Analytics-aanroep vraagt een numerieke property-id, en wat je in de praktijk hebt is de G-XXXXXXXXX-meetings-id uit je trackingsnippet. Daarna geeft analytics_report sessies, gebruikers, conversies en omzet, uitgesplitst naar kanaal, bron/medium, campagne, landingspagina, land, apparaat of datum, en laat analytics_realtime zien wie er nu op de site is. Dus “bouw de campagne” en “vertel me wat die heeft opgebracht” zijn hetzelfde gesprek.

Het schrijft ook, en dit is het deel dat rechtstreeks terugvloeit naar Google Ads: create_analytics_key_event markeert een gebeurtenis die GA4 al verzamelt als key event, en dat is precies wat Google Ads als conversie importeert. Zonder een conversieactie werkt geen enkele smart-bidding-strategie op deze pagina. create_analytics_custom_dimension registreert een gebeurtenisparameter zodat rapporten erop kunnen uitsplitsen, en list_analytics_definitions laat zien wat de property al meet voordat je een van beide toevoegt. Twee dingen blijven altijd waar: dit is alleen GA4, want de API heeft helemaal geen Universal Analytics-oppervlak, en een eigen dimensie kan worden gearchiveerd maar nooit verwijderd, met 50 gebeurtenisgebonden plekken per property, dus de agent controleert eerst de bestaande set.

De live-uitgavenblokkade gaat verder dan één tool

Pauzeren is niet de enige manier om uitgaven te vermijden, en dat zo behandelen is een echte valkuil: een ingeschakelde advertentiegroep, advertentie of zoekwoord maken onder een al ingeschakelde ouder wordt bij de volgende veiling getoond. Daarom bewaakt dezelfde bevestiging die set_google_ads_status beschermt ook create_google_ads_ad_group, create_google_ads_ad en add_google_ads_keywords wanneer de ouder live is, op basis van de rij die elk van die tools al ophaalt, zonder extra aanroep. Negatieve zoekwoorden beperken alleen uitgaven, dus die worden nooit bewaakt.

GAQL-rapportage, met één ding om te weten

google_ads_report accepteert willekeurige GAQL, zodat je agent elk gewenst deel kan opvragen in plaats van vast te zitten aan een vaste rapportvorm. Eén ding om in gedachten te houden als je queries met de hand schrijft of een model ze laat schrijven: GAQL is geen SQL. Het heeft geen subqueries, en IN neemt een letterlijke lijst. Een WHERE id IN (SELECT …) is ongeldig en mislukt, in plaats van stilzwijgend de verkeerde rijen terug te geven. Stuur het resultaat met create_sheet en append_to_sheet rechtstreeks naar een spreadsheet, of met create_doc naar een document.

Teruglezen, dan rapporteren

Na de mutatie wordt de boom bij Google teruggelezen, en de samenvatting die je krijgt is opgebouwd uit die terugcontrole, nooit uit wat er was aangevraagd. Het is een kleine discipline die het specifieke falen opvangt waarbij een agent met vertrouwen een campagne beschrijft die het platform in werkelijkheid heeft aangepast of afgewezen.

Wat het niet doet zonder te vragen

Een agent met een budget is alleen nuttig als de schade begrensd is, dus de uitgavenbevoegdheid wordt afgedwongen in de server en niet in een prompt. Meta-campagnes, advertentiesets en advertenties worden aangemaakt als PAUSED, zonder dat de aanroeper dat kan overschrijven. De schakelaars die echte advertentie-uitgaven kunnen starten (er is er één op elk advertentieplatform: 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 en set_openai_ads_status, onder andere) weigeren allemaal te draaien zonder een uitdrukkelijke bevestigingsvlag, en diezelfde blokkade geldt voor het aanmaken van een ingeschakelde Google Ads-advertentiegroep, advertentie of zoekwoord onder een al ingeschakelde ouder, omdat die bij de volgende veiling wordt getoond. Verwijderen vraagt ook altijd om bevestiging. Aan de generatiekant publiceert hermoso_capabilities de exacte creditkosten per model voordat er iets draait, en elke render reserveert een schatting en verrekent daarna de werkelijke kosten, dus een mislukte verzending wordt terugbetaald in plaats van dat je stilzwijgend wordt belast.

Je Google Ads-account koppelen

Je koppelt Google Ads aan Hermoso via de eigen OAuth-flow van Google onder Instellingen, Connectoren; er gaat geen wachtwoord via het model. Google Ads-koppelingen worden op merkniveau gedeeld, zodat een heel team op een merk met één koppeling werkt in plaats van dat iedereen opnieuw autoriseert.

Het creatieve deel

Campagnebeheer is alleen nuttig als er iets is om te draaien. Dezelfde server onderzoekt wat op jouw markt al wint in de advertentiebibliotheken van Meta, Google en LinkedIn, rendert afgewerkt beeld- en videocreatief dat gebaseerd is op je echte product via meer dan 100 modellen, en uploadt de assets. Zo zijn “wat moeten we draaien” en “bouw het” één gesprek in plaats van twee tools. Zie het overzicht van de marketing-MCP, de volledige toollijst, of de Meta Ads MCP als je beide draait.

Veelgestelde vragen

Is er een MCP-server voor Google Ads?

Ja. De MCP-server van Hermoso bouwt en beheert Google Ads vanuit elke MCP-client: create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad en add_google_ads_keywords om een zoek- of displayboom te bouwen; create_google_ads_performance_max_campaign voor Performance Max; set_google_ads_budget, set_google_ads_bidding en set_google_ads_targeting om in te stellen; google_ads_keyword_ideas voor Keyword Planner-onderzoek; list_google_ads_campaigns en google_ads_report voor rapportage; Merchant Center-leesacties voor de productfeed achter een Shoppingcampagne; en een met bevestiging beveiligde set_google_ads_status om te activeren.

Kan een AI-agent een Google Ads-campagne maken?

Ja, en de hele boom wordt in één atomaire bewerking aangemaakt met tijdelijke resource-id's: campagne, advertentiegroep, responsieve zoek- of displayadvertentie en zoekwoorden samen. Als de advertentie wordt afgewezen, is ook het budget nooit aangemaakt, dus je blijft niet achter met losse objecten om op te ruimen. Een dry-runmodus valideert de boom tegen de live API zonder iets aan te maken.

Kan het een Performance Max-campagne maken?

Ja. create_google_ads_performance_max_campaign bouwt het budget, de campagne, de targeting, de asset group en elke assetkoppeling in één atomaire bewerking, omdat Google die samen vereist. De campagne wordt gepauzeerd aangemaakt en teruggelezen voordat de agent erover rapporteert. Googles minimumeisen voor assets worden afgedwongen voordat er iets wordt verstuurd: 3–15 koppen, 1–5 lange koppen, 2–5 beschrijvingen, een bedrijfsnaam, en minstens één logo, één marketingbeeld en één vierkant marketingbeeld. PMax biedt alleen op conversies, dus hij weigert te bouwen op een account zonder ingeschakelde conversieactie, in plaats van een campagne te maken die niet kan optimaliseren. Shopping-feed (retail) PMax werkt op dezelfde manier: geef merchantCenterId door en de campagne adverteert je Merchant Center-catalogus, met feedLabel om die tot één feed te beperken. De terugcontrole meldt het Merchant Center-account en het feedlabel die Google daadwerkelijk heeft opgeslagen.

Werkt het met Google Merchant Center?

Ja, lezen en schrijven, via dezelfde Google-verbinding. De agent kan de Merchant Center-accounts tonen die je account kan bereiken, de producten in een feed lezen (de catalogus die een Shopping- of retail Performance Max-campagne werkelijk bedient), en de accountbrede problemen lezen die Google meldt. Dat is de enige plek om te ontdekken waarom een product niet wordt getoond, want een afgekeurd product heeft geen vertoningen die Google Ads-rapportage kan laten zien. Google vereist een eenmalige registratie van het Cloud-project van Hermoso bij je Merchant Center-account voordat de API antwoordt, en er is een tool die dat uitvoert. Het schrijft ook: create_merchant_data_source, upsert_merchant_product en update_merchant_product voor de prijs- en beschikbaarheidswijzigingen die dagelijks veranderen, en delete_merchant_product en delete_merchant_data_source, beide met bevestiging. Google accepteert productschrijfacties alleen in een API-databron, dus Hermoso zoekt een schrijfbare feed voor je en weigert bij naam als het account er meerdere heeft.

Kan het zoekwoordonderzoek doen?

Ja. google_ads_keyword_ideas roept de Keyword Planner van Google aan en geeft echte maandelijkse zoekvolumes, concurrentie en biedbereiken voor de bovenste positie, gebaseerd op zoekwoorden, een landingspagina-URL of een hele site. De agent kan die direct in add_google_ads_keywords zetten, of ze naar een Google Sheet schrijven.

Kan het mijn Google Ads-budget laten uitgeven?

Alleen met een uitdrukkelijke bevestiging. set_google_ads_status is de schakelaar die echt geld activeert. Omdat het maken van een ingeschakeld kind onder een al ingeschakelde ouder bij de volgende veiling wordt getoond, bewaakt dezelfde bevestiging ook create_google_ads_ad_group, create_google_ads_ad en add_google_ads_keywords wanneer de ouder live is. Negatieve zoekwoorden beperken alleen uitgaven en worden nooit bewaakt.

Kan het rapporten draaien?

Ja. google_ads_report accepteert willekeurige GAQL, dus de agent kan elk gewenst deel opvragen. Let op: GAQL is geen SQL. Het heeft geen subqueries, en IN neemt een letterlijke lijst, dus een WHERE id IN (SELECT …) is ongeldig. Resultaten kunnen direct naar een Google Sheet of Doc worden geschreven.

Welke bieding en targeting kan het instellen?

Zes biedstrategieën, campagneplanning, en geografische en taaltargeting, met find_google_ads_locations om locatietargets op naam op te zoeken. Budgetten worden ingesteld met set_google_ads_budget, en zoekwoorden ondersteunen negatieven en CPC per zoekwoord.

Krijgt de agent mijn Google-wachtwoord?

Nee. Je koppelt Google Ads via de eigen OAuth-flow van Google in Hermoso onder Instellingen, Connectoren, en Hermoso bewaart het resulterende token. De agent roept alleen de tools van Hermoso aan. Google Ads-koppelingen worden op merkniveau gedeeld, zodat een heel team met één koppeling werkt.

Kan het ook de advertentiecreatie maken?

Ja. Dezelfde server onderzoekt concurrentieadvertenties, plant het concept, rendert afgewerkt beeld- en videocreatief via meer dan 100 modellen met je echte product erin gecomponeerd, en uploadt assets met upload_google_ads_asset, zodat onderzoek, creatie en campagnebouw in één gesprek gebeuren.