MCP do Google Ads: monte a campanha inteira pelo seu agente, de forma atômica

Existe um servidor MCP do Google Ads? Existe. A Hermoso é um servidor MCP do Google Ads hospedado. Adicione https://app.hermoso.ai/mcp ao Claude, ao ChatGPT ou ao Cursor e conecte sua conta do Google Ads uma única vez. Depois disso, seu assistente pode criar campanhas de pesquisa, de display e Performance Max, encontrar ideias de palavras-chave, definir orçamentos, lances e segmentação, e gerar relatórios. Para ligar uma campanha, você sempre precisa confirmar explicitamente.

O Google Ads é uma árvore, e é em árvores que a criação automatizada de campanhas costuma dar errado. Você cria um orçamento, depois uma campanha, depois um grupo de anúncios e, por fim, um anúncio. Se o anúncio for rejeitado na quarta etapa, sobram três objetos órfãos e um orçamento que você não queria. Limpar isso na mão é o motivo pelo qual a maioria das pessoas desiste de automatizar o Google Ads.

O servidor MCP da Hermoso monta a árvore inteira em uma única operação atômica, usando ids temporários de recurso para que os itens filhos possam referenciar pais que ainda não existem. Ou a campanha, o grupo de anúncios, o anúncio e as palavras-chave passam a existir juntos, ou nenhum deles existe. Um anúncio recusado significa que o orçamento também nunca foi criado.

Instale uma vez: no Claude.ai ou no Claude Desktop, cole https://app.hermoso.ai/mcp em Configurações → Conectores e aprove com sua conta Hermoso. Em um agente de programação, é um único comando: /plugin marketplace add hermoso-ai/hermoso e depois /plugin install hermoso@hermoso no Claude Code, codex plugin marketplace add hermoso-ai/hermoso e depois codex plugin add hermoso@hermoso no Codex, ou npx skills add hermoso-ai/hermoso -a cursor no Cursor (troque o nome do agente depois de -a). Depois entre uma vez com npx -y hermoso auth login. A configuração completa está na página de MCP e CLI.

As ferramentas do Google Ads

Criar. 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 para sitelinks, destaques e trechos estruturados.

Configurar. set_google_ads_budget, set_google_ads_bidding (seis estratégias), set_google_ads_targeting (localização e idioma), find_google_ads_locations, set_google_ads_networks (Parceiros de Pesquisa e Display ligados ou desligados), create_google_ads_conversion_action e list_google_ads_conversion_actions.

Pesquisar. google_ads_keyword_ideas coloca o Planejador de Palavras-chave na conversa: volumes mensais reais de busca, concorrência e faixas de lance no topo da página, a partir de um conjunto de palavras-chave, de uma página de destino ou de um site inteiro.

Ler e alterar. list_google_ads_campaigns, google_ads_report para GAQL livre, google_ads_change_history para ver o que mudou na conta e quando, delete_google_ads_object para remover um objeto, e set_google_ads_status, a única chave com confirmação obrigatória que inicia gasto real.

create_google_ads_campaign também aceita um modo de simulação, para que um agente valide a árvore inteira contra a API ao vivo sem criar nada. Isso é um bom padrão quando ele está propondo um plano para você aprovar.

O que o seu agente pode fazer com o MCP do Google Ads

Cada linha é uma ferramenta real no servidor. Peça em linguagem comum e o agente escolhe quais executar.

Exemplos de pedidos

Cole qualquer um destes no Claude, no ChatGPT ou no Cursor depois de conectar a Hermoso.

• “Encontre 30 palavras-chave para nosso app de gestão de projetos com mais de 1.000 buscas por mês nos EUA e agrupe por intenção.”
  google_ads_keyword_ideas retorna os volumes do Planejador de Palavras-chave, a concorrência e as faixas de lance, e o agente agrupa tudo.
• “Monte uma campanha de Pesquisa pausada para essas palavras-chave: $50 por dia, EUA e Canadá, inglês, maximizar conversões.”
  create_google_ads_campaign monta orçamento, campanha, grupo de anúncios, anúncio e palavras-chave em uma única operação atômica, pausada, e depois lê tudo de volta.
• “Monte um Performance Max para o catálogo da nossa Shopify usando o feed do Merchant Center.”
  list_merchant_accounts escolhe a loja, e create_google_ads_performance_max_campaign monta a campanha pausada com o feed anexado.
• “Quais termos de pesquisa gastaram dinheiro no mês passado sem converter? Adicione os dez piores como palavras-chave negativas.”
  google_ads_report puxa o relatório de termos de pesquisa, e add_google_ads_keywords adiciona os negativos.
• “Adicione quatro sitelinks à nossa campanha de marca: preços, demo, casos de sucesso e contato.”
  add_google_ads_assets cria os sitelinks e os vincula à campanha.
• “Desligue os Parceiros de Pesquisa em todas as campanhas e mostre como estava antes e depois.”
  set_google_ads_networks lê a configuração atual primeiro e depois altera campanha por campanha.
• “Alguém mexeu nos nossos lances na sexta. O que mudou?”
  google_ads_change_history lista as mudanças com horários.
• “Vincule nossa propriedade do GA4 para que os cadastros contem como conversões no Google Ads.”
  link_google_ads_to_analytics faz o vínculo, e create_analytics_key_event marca o evento de cadastro como evento-chave.

Performance Max, montado do mesmo jeito

create_google_ads_performance_max_campaign monta o tipo de campanha entre superfícies do Google (Pesquisa, YouTube, Display, Discover, Gmail e Maps, tudo a partir de uma campanha), e monta em uma única operação atômica porque o Google exige exatamente isso: orçamento, campanha, segmentação de localização e idioma, grupo de recursos e todos os vínculos de recursos são enviados juntos. Assim, um recurso recusado não deixa para trás uma campanha montada pela metade. Ela é criada pausada, e a árvore inteira é lida de volta do Google antes de o seu agente dizer que ela existe.

Os mínimos de recursos do Google são verificados aqui antes de qualquer envio, então uma imagem quadrada faltando vira uma mensagem clara, e não uma recusa opaca da API: de 3 a 15 títulos de até 30 caracteres, de 1 a 5 títulos longos de até 90, de 2 a 5 descrições de até 90, um nome de empresa de até 25, e pelo menos um logotipo, uma imagem de marketing e uma imagem de marketing quadrada. Envie as imagens com upload_google_ads_asset antes e passe os nomes de recurso. Um vídeo do YouTube é opcional. O Google gera um a partir do grupo de recursos se você não informar um.

O Performance Max não tem palavras-chave nem lance manual: ele otimiza apenas para conversões. Por isso a criação recusa uma conta sem ação de conversão ativa, em vez de criar uma campanha que não consegue otimizar, e indica as duas saídas: criar uma com create_google_ads_conversion_action, ou usar uma estratégia que não precise disso. As diretrizes de marca estão ativadas por padrão em novas campanhas PMax desde a versão 21 da API do Google Ads, o que muda onde o nome da empresa e o logotipo são vinculados. A Hermoso os vincula à campanha para você.

O Performance Max de feed de Shopping (varejo) funciona do mesmo jeito: informe merchantCenterId e a campanha anuncia o catálogo do seu Merchant Center, com feedLabel para restringi-la a um feed. Ela é criada e lida de volta exatamente como a campanha acima. A leitura de volta informa a conta do Merchant Center e o rótulo de feed que o Google de fato guardou, para que você veja que é mesmo uma campanha de varejo e não precise confiar na nossa palavra. Ela anuncia o feed inteiro sob um único grupo de listagem raiz. Particionar um feed por marca, categoria ou rótulo personalizado não está montado, e é recusado pelo nome em vez de ser ignorado em silêncio, para que você nunca acredite que restringiu um feed quando não restringiu.

Merchant Center, para o agente saber o que está vendendo

“Por que este produto não aparece?” é uma pergunta que os relatórios do Google Ads não conseguem responder por natureza, porque um produto reprovado não tem impressões para mostrar. Essa resposta está no Merchant Center, e a mesma conexão com o Google chega até ele, sem um segundo login.

Seu agente pode listar as contas do Merchant Center que a sua conta Google conectada alcança com list_merchant_accounts (uma agência costuma ter várias, então ele pergunta qual loja usar em vez de adivinhar), ler os produtos de um feed com list_merchant_products (o catálogo real que uma campanha de Shopping ou de Performance Max de varejo entrega) e ler os problemas no nível da conta que o Google aponta para a conta, com list_merchant_issues. Isso basta para escrever anúncios sobre produtos que de fato existem, com preços que estão de fato ativos, e para explicar uma campanha que não entrega nada.

Ele também escreve. create_merchant_data_source cria um feed de produtos por API, upsert_merchant_product coloca um produto nele, update_merchant_product altera os campos que mudam todo dia (preço e disponibilidade), e delete_merchant_product e delete_merchant_data_source removem itens mediante confirmação. list_merchant_data_sources mostra quais feeds podem de fato receber uma escrita.

Três coisas úteis de saber logo de início. O Google bloqueia todas as chamadas da API do Merchant enquanto o projeto do Cloud da Hermoso não estiver registrado na sua conta do Merchant Center, então register_merchant_developer faz esse vínculo uma única vez e diz isso pelo nome. Não é uma conexão quebrada, e reconectar não resolve. As escritas de produto só entram em um feed de API: um feed de arquivo, um feed automático e o feed que a própria interface do Merchant Center cria aparecem normalmente na listagem, mas recusam escritas. Por isso a Hermoso resolve um feed gravável para você, cria um se não houver nenhum, e recusa pelo nome se houver vários, em vez de colocar seu produto em um mercado que suas campanhas talvez não segmentem. E upsert_merchant_product é uma escrita de linha inteira, enquanto update_merchant_product é um patch. Envie todos os campos que quer manter no primeiro, e apenas os campos que está alterando no segundo.

Nada disso significa que você precisa mover seu catálogo. Se o feed já está na Shopify ou na sua plataforma, mantenha-o lá e deixe o agente ler. As escritas servem para os casos em que nada ainda é dono do feed, ou em que um preço ou uma disponibilidade precisa de correção agora, e não na próxima sincronização.

Google Analytics 4, para você ver o que os cliques fizeram

Os relatórios do Google Ads terminam no clique. O que aconteceu depois (a sessão, o cadastro, o pedido) fica no Google Analytics, e o mesmo login do Google o acessa (é uma conexão própria, porque precisa de permissão própria).

Seu agente pode descobrir qual propriedade do GA4 ler com list_analytics_properties. Isso importa porque toda chamada do Analytics pede um id numérico de propriedade, e o que você de fato tem é o ID de medição G-XXXXXXXXX do seu trecho de rastreamento. Depois, analytics_report devolve sessões, usuários, conversões e receita por canal, origem/meio, campanha, página de destino, país, dispositivo ou data, e analytics_realtime mostra quem está no site agora. Assim, “monte a campanha” e “me diga quanto ela rendeu” são a mesma conversa.

Ele também escreve, e esta parte alimenta diretamente o Google Ads: create_analytics_key_event marca um evento que o GA4 já coleta como evento-chave, que é exatamente o que o Google Ads importa como conversão, e uma ação de conversão é o que toda estratégia de lance inteligente desta página exige para funcionar. create_analytics_custom_dimension registra um parâmetro de evento para que os relatórios possam ser detalhados por ele, e list_analytics_definitions mostra o que a propriedade já mede antes de você adicionar qualquer um dos dois. Duas coisas que valem para sempre: isto é só GA4, já que a API não tem nenhuma superfície do Universal Analytics, e uma dimensão personalizada pode ser arquivada mas nunca excluída, com 50 espaços por evento em cada propriedade, então o agente verifica o conjunto existente primeiro.

A trava de gasto ao vivo vai além de uma ferramenta

Pausar uma campanha não é a única forma de evitar gasto, e tratar isso assim é uma armadilha real: criar um grupo de anúncios, anúncio ou palavra-chave ativo dentro de um pai já ativo começa a veicular no próximo leilão. Por isso, a mesma confirmação que protege set_google_ads_status também protege create_google_ads_ad_group, create_google_ads_ad e add_google_ads_keywords sempre que o pai estiver ativo, lendo isso da linha que cada uma delas já busca, sem nenhuma ida e volta extra. Palavras-chave negativas só restringem gasto, então nunca são bloqueadas.

Relatórios em GAQL, com uma ressalva que vale conhecer

google_ads_report aceita GAQL livre, então seu agente pode pedir a fatia que precisar, em vez de ficar preso a um formato fixo de relatório. Um detalhe a ter em mente se você estiver escrevendo consultas à mão ou deixando um modelo escrevê-las: GAQL não é SQL. Não tem subconsultas, e IN aceita apenas uma lista literal. Um WHERE id IN (SELECT …) é inválido e vai falhar em vez de devolver em silêncio as linhas erradas. Mande o resultado direto para uma planilha com create_sheet e append_to_sheet, ou para um documento com create_doc.

Leia de volta, depois informe

Depois da escrita, a árvore é lida de volta do Google, e o resumo que você recebe é montado a partir dessa leitura, nunca a partir do que foi pedido. É uma disciplina pequena, mas evita a falha específica em que um agente narra com confiança uma campanha que a plataforma, na verdade, alterou ou recusou.

O que ele não faz sem perguntar

Um agente com orçamento só é útil se o alcance do estrago for limitado, então a autoridade de gasto é controlada no servidor, e não em um prompt. Campanhas, grupos de anúncios e anúncios da Meta são criados PAUSED, sem nenhuma substituição pelo chamador. As chaves de status que podem ligar gasto real de anúncios (uma em cada plataforma de anúncios: 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, entre outras) recusam rodar sem uma flag de confirmação explícita, e essa mesma trava cobre a criação de um grupo de anúncios, anúncio ou palavra-chave ativo do Google Ads dentro de um pai já ativo, porque isso veicula no próximo leilão. Exclusões também exigem confirmação. Do lado da geração, hermoso_capabilities publica o custo exato em créditos de cada modelo antes de qualquer execução, e cada renderização reserva uma estimativa e depois acerta o custo real, então um envio que falha é estornado em vez de cobrar você em silêncio.

Conectando sua conta do Google Ads

Você conecta o Google Ads à Hermoso pelo próprio fluxo OAuth do Google, em Configurações, Conectores; nenhuma senha passa pelo modelo. As conexões do Google Ads são compartilhadas no nível da marca, então uma equipe inteira que trabalha em uma marca usa uma única conexão, sem que cada pessoa precise autorizar de novo.

A parte criativa

Gerenciar campanhas só é útil se houver algo para veicular. O mesmo servidor pesquisa o que já está funcionando no seu mercado nas bibliotecas de anúncios da Meta, do Google e do LinkedIn, renderiza criativos finais de imagem e vídeo baseados no seu produto real em mais de 100 modelos, e envia os recursos. Assim, “o que devemos veicular” e “monte isso” são uma única conversa, e não duas ferramentas. Veja a visão geral do MCP de marketing, a lista completa de ferramentas ou o MCP do Meta Ads, se você usa os dois.

Perguntas frequentes

Existe um servidor MCP para o Google Ads?

Existe. O servidor MCP da Hermoso cria e gerencia o Google Ads a partir de qualquer cliente MCP: create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad e add_google_ads_keywords para montar uma árvore de Pesquisa ou Display; create_google_ads_performance_max_campaign para Performance Max; set_google_ads_budget, set_google_ads_bidding e set_google_ads_targeting para configurar; google_ads_keyword_ideas para pesquisa no Planejador de Palavras-chave; list_google_ads_campaigns e google_ads_report para relatórios; leituras do Merchant Center para o feed de produtos por trás de uma campanha de Shopping; e um set_google_ads_status com confirmação obrigatória para ativar.

Um agente de IA pode criar uma campanha do Google Ads?

Pode, e a árvore inteira é criada em uma única operação atômica com ids temporários de recurso: campanha, grupo de anúncios, anúncio responsivo de pesquisa ou de display e palavras-chave juntos. Se o anúncio for recusado, o orçamento também nunca foi criado, então você não fica com objetos órfãos para limpar. Um modo de simulação valida a árvore contra a API ao vivo sem criar nada.

Ele consegue criar um Performance Max?

Consegue. create_google_ads_performance_max_campaign monta o orçamento, a campanha, a segmentação, o grupo de recursos e todos os vínculos de recursos em uma única operação atômica, porque o Google exige todos juntos. A campanha é criada pausada e lida de volta antes de o agente informar algo sobre ela. Os mínimos de recursos do Google são verificados antes de qualquer envio: de 3 a 15 títulos, de 1 a 5 títulos longos, de 2 a 5 descrições, um nome de empresa, e pelo menos um logotipo, uma imagem de marketing e uma imagem de marketing quadrada. O PMax otimiza apenas para conversões, então ele recusa a criação em uma conta sem ação de conversão ativa, em vez de criar uma campanha que não consegue otimizar. O Performance Max de feed de Shopping (varejo) funciona do mesmo jeito: informe merchantCenterId e a campanha anuncia o catálogo do seu Merchant Center, com feedLabel para restringi-la a um feed, e a leitura de volta informa a conta do Merchant Center e o rótulo de feed que o Google de fato guardou.

Funciona com o Google Merchant Center?

Funciona, com leitura e escrita, pela mesma conexão com o Google. O agente pode listar as contas do Merchant Center que a sua conta alcança, ler os produtos de um feed (o catálogo que uma campanha de Shopping ou de Performance Max de varejo de fato entrega) e ler os problemas no nível da conta que o Google aponta, que é o único lugar onde se descobre por que um produto não aparece, já que um produto reprovado não tem impressões para os relatórios do Google Ads mostrarem. O Google exige um registro único do projeto do Cloud da Hermoso na sua conta do Merchant Center antes que a API responda, e existe uma ferramenta que faz isso. Ele também escreve: create_merchant_data_source, upsert_merchant_product, update_merchant_product para as mudanças diárias de preço e disponibilidade, e delete_merchant_product e delete_merchant_data_source, com confirmação obrigatória. O Google só aceita escritas de produto em um feed de API, então a Hermoso resolve um feed gravável para você e recusa pelo nome se a conta tiver vários.

Ele faz pesquisa de palavras-chave?

Faz. google_ads_keyword_ideas chama o Planejador de Palavras-chave do Google e devolve volumes mensais reais de busca, concorrência e faixas de lance no topo da página, a partir de palavras-chave, de uma URL de página de destino ou de um site inteiro. O agente pode levar esses resultados direto para add_google_ads_keywords, ou gravá-los em uma planilha do Google.

Ele pode começar a gastar meu orçamento do Google Ads?

Só com uma confirmação explícita. set_google_ads_status é a chave que libera dinheiro real, e como criar um item filho ativo dentro de um pai já ativo começa a veicular no próximo leilão, a mesma confirmação também protege create_google_ads_ad_group, create_google_ads_ad e add_google_ads_keywords quando o pai está ativo. Palavras-chave negativas só restringem gasto e nunca são bloqueadas.

Ele consegue rodar relatórios?

Consegue. google_ads_report aceita GAQL livre, então o agente pede a fatia que precisar. Note que GAQL não é SQL: não tem subconsultas, e IN aceita apenas uma lista literal, então um WHERE id IN (SELECT …) é inválido. Os resultados podem ser gravados direto em uma planilha ou documento do Google.

Quais lances e segmentações ele consegue definir?

Seis estratégias de lance, cronograma da campanha, e segmentação por geografia e idioma, com find_google_ads_locations para localizar alvos pelo nome. Os orçamentos são definidos com set_google_ads_budget, e as palavras-chave aceitam negativos e CPC por palavra-chave.

O agente recebe a minha senha do Google?

Não. Você conecta o Google Ads pelo fluxo OAuth do próprio Google, em Configurações, Conectores da Hermoso, e a Hermoso guarda o token resultante. O agente só chama as ferramentas da Hermoso. As conexões do Google Ads são compartilhadas no nível da marca, então uma equipe inteira trabalha com uma única conexão.

Ele também faz o criativo do anúncio?

Faz. O mesmo servidor pesquisa anúncios de concorrentes, planeja o conceito, renderiza criativos finais de imagem e vídeo em mais de 100 modelos com o seu produto real incluído, e envia os recursos com upload_google_ads_asset, então pesquisa, criativo e montagem da campanha acontecem em uma única conversa.