Conecte o Google Ads a Claude Code com um comando
Claude Code
Para conectar o Google Ads ao Claude Code, adicione o PaidSync.ai: rode claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, digite /mcp e entre com seu login do PaidSync.
O Claude Code acessa suas contas do Google Ads por 158 ferramentas: auditorias, termos de pesquisa, palavras-chave, orçamentos, lances e campanhas. Ele pergunta antes de cada ferramenta, e a maioria das gravações mostra uma simulação antes.
Um comando. Login OAuth, sem chave. Grátis, 100 tarefas por mês, vale $50, sem cartão.
O comando
Claude Code conversa com servidores MCP remotos via Streamable HTTP. O PaidSync é um deles. Adicione uma vez e o mesmo terminal que edita seu código poderá ler e alterar suas contas do Google Ads.
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpPor padrão, isso registra o servidor só para o projeto atual. Adicione --scope user para disponibilizá-lo em todos os projetos da sua máquina.
Execute claude mcp list para confirmar que ele está lá, depois inicie uma sessão e digite /mcp para entrar.
Configuração em 5 passos
1Cadastre-se em paidsync.ai/signup
Leva 10 segundos. Login com Google ou e-mail. O plano gratuito é de 100 tarefas por mês a $0, sem cartão.
2Conecte o Google Ads no painel do PaidSync
Clique em Conectar no Google Ads e entre com a conta Google que alcança suas contas de anúncios. O Google Ads autoriza via Google OAuth. O PaidSync guarda os tokens criptografados em repouso com AES-256-GCM e nunca vê sua senha do Google.
Já está dentro de Claude Code? Peça para executar connect_google_ads. A ferramenta retorna um link OAuth para abrir no navegador.
3Escolha as contas que Claude Code deve ver
Depois do login, o PaidSync lista as contas do Google Ads que esse login alcança. Marque as que pertencem a este workspace. Dentro de uma sessão, list_accounts as mostra e set_active_account escolhe aquela em que Claude Code trabalha.
4Adicione o PaidSync ao Claude Code
No seu terminal, rode:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpInicie uma sessão, digite /mcp, escolha paidsync e entre com o seu login do PaidSync na janela do navegador que abrir. O Claude Code guarda o token OAuth para você. Nenhuma chave é colada em lugar nenhum.
Configurando para uma equipe? Faça commit de um .mcp.json na raiz do repositório para que todo engenheiro receba o mesmo conector:
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}Prefere uma chave de API, por exemplo para execuções sem interface? Envie-a em um cabeçalho, nunca na URL, onde ela iria parar nos logs:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"Em um .mcp.json commitado, adicione "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } para que a chave fique no ambiente de cada engenheiro e nunca entre no git. Aplicar uma alteração no Google Ads ainda exige o login OAuth. Em outras plataformas, uma chave também pode aplicar alterações, então trate-a como uma senha e prefira OAuth.
5Teste a conexão
Em uma sessão de Claude Code, peça: “Show me last 7 days Google Ads performance by campaign”
O Claude Code devolve impressões, cliques, custo e conversões de cada campanha na conta ativa. A conexão está ativa.
O plano gratuito inclui 100 tarefas por mês. Pro a partir de $99 por mês, Team a partir de $249.
Prompts do Google Ads no Claude Code
Cada prompt abaixo corresponde a ferramentas do grupo Google Ads do PaidSync. Claude Code escolhe a ferramenta. A última coluna diz se a chamada pode alterar algo na conta.
| Pedido | Ferramentas que chama | Altera sua conta? |
|---|---|---|
| “Audit the account and list the five fixes with the most spend behind them” | run_account_audit | Não |
| “Show last 30 days campaign performance sorted by cost, with conversions” | get_campaign_performance | Não |
| “Que termos de pesquisa gastaram dinheiro este mês com zero conversões?” | get_search_terms_report, get_wasted_spend_report | Não |
| “Break the last 30 days of search terms into n-grams and suggest negatives” | analyze_search_term_ngrams | Não |
| “Add those five terms as phrase match negatives on the Brand campaign” | add_negative_keywords | Sim, depois que você confirma |
| “Cut the daily budget on the Generic campaign by 20 percent” | update_campaign_budget | Sim, depois que você confirma |
| “Pause every campaign that spent money last week with no conversions” | get_campaign_performance, pause_campaign | Sim, depois que você confirma |
| “Build a paused Search campaign for the new product line” | create_search_campaign | Sim, depois que você confirma |
Execute em modo headless com claude -p
A flag -p executa o Claude Code sem a sessão interativa. Entre uma vez por /mcp e o token OAuth guardado continua valendo. Um relatório que cai em um arquivo fica assim:
claude -p "Pull last 7 days Google Ads performance by campaign and flag any campaign that spent money with zero conversions." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/google-ads-$(date +%F).jsonAs leituras rodam direto, e as escritas também. --allowedTools "mcp__paidsync" permite todas as ferramentas do PaidSync, escritas incluídas, sem prompt.
Em uma tarefa sem supervisão, permita só as ferramentas de leitura de que ela precisa, cada uma pelo nome como mcp__paidsync__tool_name.
O que lê e o que grava
Das 158 ferramentas do Google Ads, 64 só leem e 94 podem gravar.
Ler mais
As leituras cobrem desempenho, palavras-chave, termos de pesquisa, Índice de Qualidade, informações de leilão, ritmo de orçamento e histórico de alterações, por ferramentas como get_keyword_performance, get_quality_score_report, get_auction_insights, get_budget_pacing e get_change_history.
As gravações cobrem orçamentos, lances, palavras-chave, negativas, anúncios, extensões, públicos e criação de campanhas. As ferramentas de criação do Google Ads e a maioria das outras gravações mostram prévia por padrão com dry_run, então a primeira chamada mostra a alteração e uma segunda chamada a aplica.
Via MCP, a etapa de aprovação é o próprio prompt do Claude Code. Ele pergunta antes de executar uma ferramenta, a menos que você a tenha permitido com --allowedTools ou nas suas configurações. O PaidSync acrescenta verificações do seu lado. Exclusões, pausas e alterações de orçamento exigem confirm_destructive, e uma verificação de regras antes da gravação bloqueia argumentos inseguros. O cartão de aprovação, e o Undo em um cartão aplicado cuja alteração tem inverso seguro, valem apenas no workspace do PaidSync.
Adicionar ao ChatGPT: abra o PaidSync.ai no diretório de plugins do ChatGPT, instale e faça login.
Adicionar ao Claude: abra o PaidSync.ai no diretório de conectores do Claude, clique em Conectar e faça login.
Limites que vale conhecer
create_search_campaigncria uma campanha somente de Pesquisa em estado pausado. Parceiros de pesquisa e a Rede de Display começam desativados, a segmentação geográfica é apenas por presença, e o lance é CPC manual, a menos que você indique outra estratégia.- Uma mudança de orçamento acima de 50 por cento exige
confirm_large_changealém deconfirm_destructive. Essa proteção evita um orçamento multiplicado por 10x por engano ou um orçamento definido como zero. remove_campaigné permanente no Google Ads. Uma campanha removida não pode ser ativada de novo. Usepause_campaignquando só quiser interromper a veiculação.A auditoria da conta cobre os últimos 30 dias e analisa a faixa principal de cada dimensão por custo, então as notas refletem para onde vai o dinheiro, e não cada palavra-chave.
O relatório de palavras-chave retorna as 100 principais e o relatório de Índice de Qualidade as 200 principais.
Perguntas frequentes
Como conectar o Google Ads a Claude Code?
Crie sua conta em paidsync.ai, conecte o Google Ads via Google OAuth no painel, depois execute claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp no seu terminal. Digite /mcp dentro de uma sessão, escolha paidsync e entre com seu login do PaidSync.
Claude Code pode alterar minhas campanhas do Google Ads?
Sim. Claude Code pode adicionar negativas, alterar orçamentos, pausar e ativar campanhas e criar campanhas de Pesquisa pausadas. Claude Code pergunta antes de executar cada ferramenta, a menos que você tenha permitido. A maioria das gravações mostra primeiro uma simulação, e exclusões, pausas e mudanças de orçamento exigem uma confirmação explícita.
Funciona em modo headless com claude -p?
Sim. Depois de entrar por /mcp, o claude -p reutiliza o token OAuth guardado. As leituras rodam direto. As escritas exigem cuidado. Ninguém está lá para responder ao prompt do Claude Code, então qualquer ferramenta de escrita que você permitiu com --allowedTools roda direto. Em uma tarefa sem supervisão, permita só as ferramentas de leitura de que ela precisa.
Preciso de um token de desenvolvedor do Google Ads?
Não. O PaidSync é um servidor hospedado em https://mcp.paidsync.ai/mcp. Você entra no Google Ads pelo Google OAuth no painel do PaidSync e no PaidSync por /mcp em Claude Code.
É grátis?
Sim. O plano grátis custa $0 para 100 tarefas por mês, sem cartão. O Pro começa em $99 por mês e o Team em $249 por mês. O próprio Claude Code exige um plano da Anthropic que o inclua.
158 ferramentas Google Ads. Um comando.