Servidor MCP do Google Ads: conecte o Google Ads ao Claude (oficial)

Faça uma pergunta sobre sua conta de anúncios em linguagem simples e receba a resposta em segundos. Essa é a promessa do servidor MCP do Google Ads, uma ponte de código aberto do Google que permite a um assistente de IA como o Claude ler os dados ao vivo das suas campanhas, em vez de você esperar para exportar mais um CSV. É a rota oficial: o Google a publica na sua própria organização no GitHub, googleads, sob a licença Apache 2.0, e hoje ela é estritamente somente leitura. Ela pode analisar tudo e não altera nada.

Este artigo mostra como conectar o Google Ads ao Claude, quais perguntas vale fazer primeiro e quais armadilhas produzem números errados sem fazer barulho. Uma mudança recente é importante: o Google descontinuou os tokens de desenvolvedor em 9 de setembro de 2026, então muitos tutoriais antigos descrevem uma etapa de configuração que você não precisa mais. Tudo o que vem a seguir segue a documentação atual do Google e o README do projeto.

O que o servidor oficial faz

O Model Context Protocol (MCP) é um padrão que permite a um cliente de IA chamar ferramentas expostas por um programa separado. O servidor do Google envolve a API do Google Ads em três dessas ferramentas, para que o Claude possa encontrar suas contas, executar consultas e consultar definições de campos sem que você escreva uma linha de código de integração. O servidor roda na sua máquina via stdio, e o Claude conversa com ele da mesma forma que conversa com qualquer outro servidor MCP.

Veja o que muda em relação à rotina semanal de exportação que a maioria dos anunciantes ainda segue:

Três ferramentas, somente leitura

Na prática, você nunca escreve a consulta. Você diz "quais campanhas gastaram mais na semana passada", o Claude verifica quais campos existem, monta a GAQL, executa-a por meio de search e resume as linhas. Você ainda pode ler a consulta que ele executou, e é assim que pega os erros.

O que ele não pode fazer

A documentação do Google é direta: a implementação "não pode modificar lances, pausar campanhas nem criar novos ativos". Isso exclui:

• Alterar orçamentos ou lances
• Pausar ou ativar campanhas
• Criar ou editar anúncios
• Enviar novos criativos

💡 Ser somente leitura é um recurso. Uma resposta errada do modelo custa a você uma tarde ruim, não um orçamento esvaziado, porque ele não tem como enviar nenhuma mudança para a conta.

Antes de conectar qualquer coisa

Três coisas precisam estar prontas antes que o arquivo de configuração faça diferença: um projeto no Google Cloud com o nível de acesso certo, credenciais funcionando e as ferramentas locais para executar o servidor. Pular qualquer uma delas gera erros que parecem não ter relação com a causa real.

Projeto no Cloud e nível de acesso

O ID do seu projeto no Google Cloud vai na configuração como GOOGLE_PROJECT_ID. Abra a página de visão geral da API do Google Ads no console do Cloud e confirme que o projeto está em um dos três níveis de acesso listados ali: o nível de entrada, Básico ou Padrão. Se ele não tiver nenhum deles, solicite um. Os níveis de acesso agora estão vinculados ao projeto do Cloud, e é exatamente por isso que os tokens de desenvolvedor deixaram de ser necessários.

Os tokens de desenvolvedor acabaram

A documentação do Google afirma que os tokens de desenvolvedor (GOOGLE_ADS_DEVELOPER_TOKEN) foram descontinuados em 9 de setembro de 2026 e não são mais exigidos na versão mais recente do servidor. O README no GitHub ainda lista essa variável como opcional, então, se você fixar uma versão mais antiga, talvez ainda precise defini-la. Na versão atual, deixe-a de fora.

💡 Verifique a data de qualquer tutorial. Se ele mandar você solicitar um token de desenvolvedor e esperar a aprovação, ele descreve o fluxo antigo.

Credenciais OAuth ou ADC

Você precisa de uma destas duas opções: um par de ID de cliente e segredo OAuth 2.0 criado no mesmo projeto, ou um conjunto de Application Default Credentials (ADC). O escopo exigido é https://www.googleapis.com/auth/adwords. O ADC pela CLI gcloud é o caminho mais curto para um único usuário, e é o que os comandos abaixo usam.

Tenha estes itens prontos antes de continuar:

• pipx instalado, a ferramenta em Python que executa o servidor diretamente do GitHub
• A CLI gcloud instalada e autenticada
• Um usuário do Google com acesso à conta do Google Ads
• O ID do seu projeto no Cloud

Conectando o Claude passo a passo

Faça login com o gcloud

Execute o comando de login com os dois escopos que o servidor precisa, apontando para o arquivo de cliente OAuth que você baixou:

gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=YOUR_CLIENT_JSON_FILE

Copiar prompt

Uma janela do navegador se abre, você aprova os escopos, e gcloud grava um arquivo JSON de credenciais. Anote onde ele foi salvo, porque esse caminho vira GOOGLE_APPLICATION_CREDENTIALS. Equipes que preferem contas de serviço podem trocar por --impersonate-service-account=SERVICE_ACCOUNT_EMAIL com os mesmos escopos.

Adicione ao Claude Desktop

Abra o arquivo de configuração do Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json no macOS ou %APPDATA%\Claude\claude_desktop_config.json no Windows. Adicione o servidor:

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}

Copiar prompt

Feche totalmente o Claude Desktop e abra-o de novo. A primeira inicialização baixa o servidor por meio de pipx, então espere uma pequena pausa. Para configurações repetíveis, o README sugere fixar uma versão publicada com pipx run --spec "google-ads-mcp==X.Y.Z" google-ads-mcp, em vez de seguir o estado mais recente do repositório.

Claude Code em um comando

O Claude Code pode registrar o mesmo servidor pelo terminal:

claude mcp add google-ads-mcp \
  --env GOOGLE_PROJECT_ID=your-project-id \
  --env GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json \
  -- pipx run --spec git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp

Copiar prompt

Depois, execute /mcp dentro do Claude Code e confirme que google-ads-mcp aparece como conectado.

Teste com uma pergunta

Use o prompt de exemplo da documentação do Google: "A quais clientes eu tenho acesso?" O Claude deve chamar list_accessible_customers e retornar os IDs e nomes das contas. Se algo der errado, esta tabela lista os suspeitos habituais:

Essas são as causas mais prováveis, não um catálogo oficial de erros, então leia a mensagem real que o Claude mostra antes de mudar qualquer coisa.

Perguntas que vale fazer primeiro

Comece encontrando suas contas. "A quais clientes eu tenho acesso?" entrega os IDs de cliente de 10 dígitos, escritos sem traços, que todas as consultas seguintes exigem. Diga ao Claude em qual ID você está trabalhando uma vez, e ele vai reutilizá-lo pelo resto do chat. Depois, passe para perguntas que economizam tempo de verdade. As consultas abaixo mostram o que o Claude tende a montar por trás dos panos, para que você possa conferir.

Puxadas semanais de desempenho

A segunda pergunta de exemplo do Google é "Como está o desempenho das minhas campanhas esta semana?" Uma consulta razoável por trás dela tem esta aparência:

SELECT
  campaign.name,
  metrics.cost_micros,
  metrics.clicks,
  metrics.conversions
FROM campaign
WHERE segments.date DURING LAST_7_DAYS
ORDER BY metrics.cost_micros DESC
LIMIT 10

Copiar prompt

Observe cost_micros. O Google Ads armazena dinheiro em micros, então 12.500.000 significa 12,50 na moeda da conta. Um modelo que esquece de dividir vai informar um gasto um milhão de vezes maior, então peça para ele converter e nomear a moeda.

Caça ao gasto desperdiçado

O primeiro projeto mais útil é uma revisão dos termos de pesquisa. Esta consulta encontra termos que gastaram mais de 5 unidades monetárias em 30 dias e nunca converteram:

SELECT
  search_term_view.search_term,
  campaign.name,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions
FROM search_term_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.conversions = 0
  AND metrics.cost_micros > 5000000
ORDER BY metrics.cost_micros DESC
LIMIT 25

Copiar prompt

Devolva as linhas ao Claude e peça para agrupá-las por temas: quem busca emprego, quem busca coisas gratuitas, produto errado, localização errada. Esses temas viram sua lista de termos negativos, que você então adiciona na interface do Google Ads por conta própria, porque o servidor não consegue escrever.

Mais alguns prompts que vale guardar em uma anotação:

💡 Informe sempre o período e a moeda. Prompts vagos são onde começam os erros silenciosos. "Últimos 30 dias, em euros" é melhor do que "recentemente". Depois, confira um número contra a interface do Google Ads antes de confiar no resto.

Segurança, dados e limites

Seus dados chegam ao modelo

O README avisa que o servidor "vai expor seus dados ao Agente ou LLM que você conectar a ele". Ele também observa que um cabeçalho extra é adicionado às suas chamadas de API, que o Google usa para melhorar o produto. Antes de conectar uma conta de agência que contém dados de clientes, verifique seu contrato e a política do seu cliente. Trate a conexão como enviar um relatório por e-mail: tudo o que uma consulta retorna vai para o modelo.

Uma proteção simples: entre com um usuário do Google cujo acesso à conta se limite ao que o trabalho exige. O servidor age com as credenciais do usuário que se autenticou, então as permissões desse usuário se aplicam por cima do design somente leitura do próprio servidor.

Contas de gerente e hospedagem

Se você acessa uma conta de cliente por meio de uma conta de gerente (MCC), defina GOOGLE_ADS_LOGIN_CUSTOMER_ID como o ID de cliente do gerente no bloco env. O Google marca isso como obrigatório para essa situação.

A configuração local acima usa stdio e serve para uma pessoa. O Google também documenta uma implantação no Cloud Run para equipes. Ali, o servidor precisa de GOOGLE_ADS_MCP_OAUTH_CLIENT_ID, GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET e FASTMCP_HOST=0.0.0.0, e a configuração do cliente aponta um httpUrl para o caminho /mcp do seu serviço.

Servidores oficiais ou da comunidade

Existem muitos servidores MCP do Google Ads criados pela comunidade, e alguns podem oferecer acesso de escrita. Verifique escopos e capacidades antes de apontar qualquer um deles para uma conta ativa.

Transforme os insights em criativos de anúncio

O servidor MCP mostra o que corrigir. Ele não faz as imagens. Depois que o Claude mostrar quais temas de pesquisa convertem, você ainda precisa de visuais e textos novos para eles, e é aí que entra o PicassoIA. Nada aqui conecta o PicassoIA à sua conta de anúncios, então você leva os achados para lá por conta própria.

Suponha que os dados mostrem "botas de caminhada impermeáveis" convertendo a uma fração do custo de "botas baratas". Peça ao Claude três ângulos visuais para o tema vencedor: um close de trilha lamacenta, uma foto de estilo de vida em dia de chuva e uma bota em uma soleira de porta. Depois, gere cada um. Ajuste a proporção ao posicionamento: 1:1 para feeds, 16:9 para banners largos, 9:16 para vídeo vertical.

Um prompt que funciona bem para esse tipo de conceito de anúncio nomeia o assunto, o cenário, a luz e a lente, e diz com clareza o que evitar:

Close de botas de caminhada impermeáveis enlameadas em uma trilha molhada de floresta ao amanhecer, luz lateral suave, profundidade de campo rasa, lente de 50mm, fotorrealista, sem texto, sem logotipos.

Gere duas ou três versões, mantenha a que combina com o ângulo que seus dados favorecem e descarte as demais. Mantenha o estilo natural: uma foto crível de um momento real combina melhor com um anúncio de bota de caminhada do que uma renderização brilhante.

Como usar o Claude Sonnet 5

Claude Sonnet 5 no PicassoIA é a bancada de redação deste fluxo de trabalho. Ele não executa o servidor MCP do Google Ads. Você cola o que a sua sessão MCP retornou, e ele redige o texto do anúncio. As etapas:

1. Abra a página do Claude Sonnet 5 no PicassoIA.
2. Preencha o System Prompt uma vez: "Você escreve anúncios responsivos de pesquisa do Google. Os títulos ficam abaixo de 30 caracteres, as descrições abaixo de 90. Linguagem simples, sem exagero, sem alegações que não podemos comprovar."
3. Cole seus dados em Prompt: os termos de pesquisa que mais convertem, seus títulos atuais e a oferta.
4. Escolha o nível de Effort. O padrão, low, desliga o raciocínio e responde mais rápido, o que serve para variantes de texto. Use high ou max quando quiser um plano de reestruturação para uma conta bagunçada.
5. Mantenha Max Tokens em 8.192, a menos que você queira uma saída mais curta.
6. Opcionalmente, anexe uma Image, como uma captura de tela de um gráfico de desempenho. O modelo a lê como contexto.
7. Revise o rascunho, edite-o e cole o texto no Google Ads você mesmo.

Anúncios responsivos de pesquisa aceitam até 15 títulos e 4 descrições, então uma execução preenche um anúncio completo. Quer uma segunda opinião? Execute o mesmo prompt no Gemini 3.5 Flash ou no Claude Opus 4.7 e compare os rascunhos lado a lado.

Crie seus próprios visuais de anúncio hoje

Os dados dizem o que testar. Os visuais decidem se alguém para de rolar a tela. Abra o PicassoIA Image, cole um prompt para o seu melhor tema que converte, escolha 1:1 ou 16:9 e gere quantas variações quiser, já que o modelo não tem limite por imagem. Fixe um seed quando uma composição funcionar e altere apenas o texto para testar pequenas diferenças.

O PicassoIA também mantém uma conexão MCP própria, então o mesmo Claude que lê seus dados do Google Ads pode pedir imagens e vídeos em uma única conversa. Veja a página da API do PicassoIA para detalhes e confira qual plano inclui o acesso.

Experimente hoje à noite: conecte o servidor MCP do Google Ads, execute a consulta de gasto desperdiçado, escolha o único melhor tema que converte e gere cinco variações visuais no Picasso IA antes de escrever qualquer outra coisa. Na próxima semana, rode de novo a consulta de desempenho semanal e veja qual versão ganhou os cliques.