Google Ads no Claude Code em 3 Passos

O Claude sempre soube pensar campanha. O que faltava era a mão. A MCP do Windsor.ai dá essa mão: sua conta do Google Ads fica acessível dentro do Claude Code, e ele passa a ler número e a executar mudança de verdade. Abaixo, o passo a passo real, do cadastro à primeira campanha.

Pré-requisitos

• •Claude Code instalado. Confira com `claude --version`
• •Uma conta de Google Ads com acesso de administrador
• •Um e-mail para criar a conta no Windsor.ai
• •Cinco minutos. A configuração é rápida mesmo

O que é a MCP do Windsor

MCP é o protocolo que dá ferramentas ao Claude. O Windsor.ai publica um servidor MCP que fala com as suas contas de anúncio, então o Claude ganha acesso a 31 ações de Google Ads e para de depender de você copiar e colar no painel.

O detalhe que importa: o servidor do Windsor não é só leitura. A documentação deles diz que o conector lê e escreve nas contas conectadas. É por isso que dá para criar campanha, e não apenas perguntar quanto gastou.

Os 3 passos da configuração

https://onboard.windsor.ai/

claude mcp add --transport http windsor https://mcp.windsor.ai/ -s user

Confirmar que conectou

Fora do Claude, rode o comando de listagem. A linha que você quer ver é a do windsor com o status Connected.

claude mcp list

# saída esperada:
# windsor: https://mcp.windsor.ai/ - Connected

Se aparecer Needs authentication, a instalação funcionou e falta só o login. Volte ao Claude Code, rode a barra mcp e autentique. Confirmado o status, faça o teste de ponta a ponta com um pedido que só funciona se a conexão estiver de pé.

Quais fontes de dados estão conectadas na minha conta do Windsor?

Se ele listar o google_ads e as suas contas de anúncio, está tudo certo.

Como o Claude enxerga as ações

Vale entender isso agora, porque muda a forma de pedir e afeta a segurança. O servidor do Windsor expõe 16 ferramentas, e é por elas que as 31 ações passam. Ferramenta e ação não são a mesma coisa aqui. As de leitura são separadas: uma traz as métricas, outra diz quais campos existem, outra lista as contas conectadas. Mas toda a escrita passa por uma única ferramenta, a execute_action, que recebe o nome da ação como argumento.

Na prática você não chama nada disso na mão. Você fala em português e o Claude escolhe. Mas guarde essa informação, porque ela volta na seção de autorização.

O que dá para fazer no Google Ads

São 31 ações disponíveis hoje, agrupadas por uso:

Criar uma campanha do zero

Este é o prompt de campanha inteira. Copie, troque o que for seu e mande.

Cria uma campanha de Pesquisa no Google Ads na conta 123-456-7890.

Contexto: vendo consultoria de tráfego pago para donos de e-commerce.
Página de destino: https://meusite.com.br/consultoria

Quero que você:
1. Crie a campanha com orçamento de R$ 50 por dia, lance manual de CPC.
2. Crie um grupo de anúncio chamado "Consultoria - Geral".
3. Suba 15 palavras-chave, misturando correspondência de frase e exata.
4. Suba as negativas óbvias: grátis, curso, vaga, emprego, salário, pdf.
5. Escreva um anúncio responsivo com 10 títulos e 4 descrições.
   Respeita os limites: título com no máximo 30 caracteres, descrição com no máximo 90.

Antes de executar, me mostra o plano inteiro e espera minha aprovação.

O anúncio responsivo tem limite rígido do próprio Google: de 3 a 15 títulos com no máximo 30 caracteres cada, e de 2 a 4 descrições com no máximo 90 caracteres cada. Se estourar, o Google recusa. Quando estiver revisado e você quiser subir, autorize.

Revisei e aprovei. Ativa a campanha e o grupo de anúncio.

Subir palavras-chave e negativas

Palavra-chave positiva vive no grupo de anúncio, não na campanha. Negativa você escolhe: pode ser no nível da campanha, para bloquear no geral, ou no grupo.

Sobe estas negativas no nível da campanha 987654321:
grátis, gratuito, curso, apostila, download, torrent, reclame aqui, salário.
Usa correspondência de frase.

Ler desempenho

Essa é a parte que vira rotina. Em vez de abrir o painel para responder cliente, você pergunta.

Sobre a profundidade da leitura: o conector de Google Ads do Windsor expõe mais de 2.500 campos consultáveis, então dá para ir bem além de gasto e clique. Uma ressalva honesta, porque ela evita frustração: campo disponível não é campo preenchido. Quantos voltam com dado depende do que a sua conta usa. Uma conta que só roda Pesquisa não vai ter nada nos campos de Performance Max.

Como foi a campanha "Consultoria - Geral" nos últimos 7 dias?
Me traz gasto, cliques, CTR, conversões e CPA.
Compara com os 7 dias anteriores e me diz o que mudou.
Me avisa até que data o dado está disponível.

Puxa o desempenho de todas as campanhas ativas da conta 123-456-7890 nos
últimos 30 dias. Monta um resumo executivo em português, com os 3 números
que importam, o que melhorou, o que piorou e uma recomendação por campanha.
Salva em relatorios/google-ads-agosto.md

Esse último pedaço é o pulo do gato. Como você está no Claude Code, e não no chat do navegador, o relatório é salvo como arquivo na sua máquina. Aí você tem histórico, versionado, sem depender de rolar conversa antiga.

Pedir sugestão de otimização

Separe o diagnóstico da execução. Primeiro peça a análise, sem deixar ele mexer em nada.

Analisa a conta 123-456-7890 nos últimos 14 dias e me diz onde estou
perdendo dinheiro. Olha termo de busca sem conversão, palavra com gasto
alto e CPA acima da média, e anúncio com CTR abaixo do grupo.

Me devolve uma lista priorizada de ajustes. Só a lista. Não executa nada.

Leia. Discorde do que achar errado. Depois autorize só o que fizer sentido.

Concordo com os itens 1, 2 e 4. O item 3 não, essa palavra converte no
offline e eu quero manter. Executa só os três aprovados.

Como funciona a autorização

Nada é aplicado sem você aprovar. A proteção acontece em duas camadas: o Claude Code mostra o prompt de permissão toda vez que vai chamar uma ferramenta da MCP, e você ainda tem o hábito de pedir o plano antes, como nos exemplos acima.

• •Leia o argumento, não só o nome da ferramenta. É ali que está o que vai acontecer de verdade
• •Pense duas vezes antes de marcar sempre permitir para essa ferramenta em conta que gasta dinheiro. Você estaria aprovando de uma vez as 31 ações, inclusive as de criação
• •Em conta de teste, tudo bem liberar. Em conta de cliente, aprove uma por uma

Não existe modo de simulação. Nenhuma das 31 ações tem um parâmetro de teste que finge executar. Quando a ação roda, ela mexe na conta de verdade. Por isso o hábito de pedir o plano antes vale tanto: é ele que faz o papel do ensaio.

Vale saber também o que dá para desfazer. Pausar e ativar são reversíveis, é só rodar o inverso. Mudança de orçamento e de lance também. Criação não é: se o Claude criou uma campanha que você não queria, não existe uma ação de apagar. Você pausa e depois remove no painel.

O que continua manual

Aqui está a parte que um vídeo de 55 segundos não tem tempo de dizer. A integração é boa, mas não é tudo. Nada disso abaixo passa pela MCP hoje.

• •Tipos de campanha: a criação cobre Pesquisa e Display, só. Performance Max, Shopping, Vídeo no YouTube, Demand Gen e App continuam sendo criados no painel. Detalhe útil: as que já existem você consegue ler e pausar normalmente, só não consegue criar nem editar a estrutura delas. Ou seja, dá para o Claude te avisar que a Pmax está comendo o orçamento e pausar, mas o ajuste fino é no painel
• •Editar palavra-chave: dá para mudar o status e o lance de uma palavra que já existe, mas não dá para trocar o texto dela nem o tipo de correspondência. Para isso você remove e sobe de novo, o que o Claude faz numa tacada só se você pedir
• •Segmentação de local e idioma: não existe ação para isso. Você cria a campanha pelo Claude e vai no painel definir onde ela roda. Não pule esse passo, porque campanha sem geo definida roda em lugar que você não quer
• •Tag de conversão: configurar acompanhamento de conversão continua sendo trabalho de painel e de site. E isso tem efeito direto, porque a estratégia de lance maximize_conversions só funciona se a conta já tiver conversão configurada
• •Criativo visual: não tem upload de imagem nem de vídeo. As extensões que dá para criar são de texto: sitelink, frase de destaque, snippet estruturado e telefone
• •Faturamento e verificação: cadastrar cartão, verificar o anunciante e verificar o domínio não passam pela integração
• •Aprovação de política: o Google continua revisando seus anúncios do jeito de sempre. Anúncio criado pelo Claude entra na mesma fila e pode ser reprovado igual

Isso não diminui o ganho. O trabalho repetitivo, que é montar estrutura, escrever variação de título e subir lista de negativa, sai do seu dia. O que sobra é decisão e configuração de conta, que é onde você deveria estar mesmo.

Pegadinhas e erros comuns

• •Tudo nasce pausado. Não é bug. Se você criou tudo e não aparece nada rodando, falta ativar
• •Conta errada: se você conectou mais de uma conta de Google Ads, sempre diga o ID da conta no prompt. Não confie no Claude adivinhar
• •A doc do Windsor se contradiz. A página de conexão genérica ainda diz que a MCP é somente leitura. Está desatualizada: a página de write actions e a lista real de ações confirmam a escrita
• •Needs authentication no claude mcp list não é erro de instalação. É só o OAuth pendente. Rode a barra mcp dentro do Claude Code e autentique
• •Resposta vazia sem mensagem de erro: se a conta não teve veiculação no período, a consulta volta com uma lista vazia e nenhum aviso. Parece defeito e não é. Confira se a campanha estava mesmo rodando naquelas datas antes de sair caçando problema
• •Nenhum dado voltando numa conta recém-conectada: confira no painel do Windsor se o conector do Google Ads terminou a primeira sincronização. Leva um tempo até o dado ficar disponível
• •Histórico curto: no período de teste o Windsor guarda 30 dias para trás. Se você pedir uma comparação com o ano passado, o dado simplesmente não vem, e sem aviso claro
• •Requested data exceeds size limit: você pediu coisa demais de uma vez. Quebre em pedaços, um período menor ou menos campanhas por consulta
• •Ambiente corporativo: se o seu Claude é de organização, a conexão de conectores pode estar bloqueada e você precisa pedir liberação ao administrador

Checklist final

A mudança real não é o Claude criar campanha. É parar de abrir o painel para tudo. Cliente pergunta como foi a semana, você pergunta ao Claude e responde na hora. Percebe uma palavra-chave queimando orçamento, manda pausar e ela pausa. A parte de decidir continua sua. E é bom que continue.