Claude e IA

Google Ads MCP: o servidor oficial, como instalar e onde ele para

Google Ads MCP: o que o servidor oficial do Google faz, como instalar no Claude e no Claude Code, por que ele só lê e quando um conector hospedado resolve.

Por Victor dos SantosPublicado em 28 de outubro de 20268 min de leitura

Este artigo também está em: English · Español

Google Ads MCP é um servidor que dá ao Claude (ou a outro assistente) acesso à sua conta do Google Ads pela API, para você perguntar em vez de exportar. Existe um oficial: o google-ads-mcp, de código aberto, publicado pelo próprio Google. Ele tem três ferramentas, é estritamente de leitura e roda onde você instalar, com projeto no Google Cloud e credencial OAuth. Se você quer só colar um endereço no Claude, ou quer que a IA também pause campanha e mexa em palavra-chave, precisa de um conector hospedado com escrita. Abaixo, o que o oficial faz, como instalar e quando cada caminho compensa.

Já existe aqui no blog um mapa dos MCPs oficiais de todas as plataformas, em MCP de anúncios: os servidores oficiais. Este texto desce só no Google Ads: as ferramentas, a instalação e os limites, com o que conferi na documentação do Google em 28/10/2026.

O que o MCP oficial do Google Ads faz

O servidor oficial expõe três ferramentas e alguns recursos de consulta. É pouca coisa no nome, mas a ferramenta search é ampla, porque roda consultas em GAQL, a linguagem de consulta da Google Ads API.

Ferramenta ou recurso	O que faz
`list_accessible_customers`	Lista as contas que o usuário autenticado acessa diretamente
`search`	Roda uma consulta GAQL: métricas, orçamentos, status, o que a API permite ler
`get_resource_metadata`	Descreve os campos de um tipo de recurso, como "campaign", para a IA saber o que pode pedir
Recursos de apoio	Documento de descoberta da API, lista de métricas, lista de segmentos e notas da versão

Na prática, a IA lê a sua pergunta, escreve a consulta GAQL, roda e responde. Isso dá muito alcance de leitura: termos de pesquisa, palavras-chave, recursos de anúncio, qualquer coisa que a API exponha.

O que ele não faz está escrito na documentação: a implementação atual é estritamente de leitura e não altera lances, não pausa campanhas e não cria recursos. Para operações de escrita, o Google aponta outra ferramenta, o Google Ads API Developer Assistant, que gera código de biblioteca cliente. Ou seja: o caminho oficial para "mudar algo" passa por código, não pelo chat.

O que mudou em setembro de 2026: o developer token saiu

Quem pesquisou o assunto antes de setembro leu que precisava de um developer token aprovado. Não precisa mais. A documentação diz que os developer tokens foram descontinuados em 9 de setembro de 2026 e não são exigidos na versão mais recente do servidor. O nível de acesso à API agora segue o projeto do Google Cloud que gera a sua credencial OAuth.

Isso tira a etapa mais lenta da instalação, mas não a mais técnica: você ainda precisa de projeto no Google Cloud, API ativada e credencial.

Como instalar o oficial, passo a passo

O que você precisa ter antes: um projeto no Google Cloud, acesso ao terminal e uma conta do Google com acesso às contas de anúncio.

Instale o pipx. O servidor é em Python e roda com pipx run, sem instalação permanente.
Ative a Google Ads API no seu projeto do Google Cloud.
Crie a credencial. O caminho mais curto é o Application Default Credentials: crie um cliente OAuth no projeto, baixe o arquivo JSON e rode gcloud auth application-default login com o escopo https://www.googleapis.com/auth/adwords e o arquivo do cliente. O terminal mostra o caminho do arquivo de credencial gerado. Guarde.
Configure o cliente MCP com três dados: o comando do pipx apontando para o repositório, o caminho da credencial em GOOGLE_APPLICATION_CREDENTIALS e o ID do projeto em GOOGLE_PROJECT_ID. Se você acessa as contas por uma MCC, acrescente o ID dela em GOOGLE_ADS_LOGIN_CUSTOMER_ID.
Teste com uma pergunta de leitura, como "lista as contas que você enxerga".

No Claude Desktop, isso vai no arquivo de configuração de servidores MCP, em Configurações → Desenvolvedor. No Claude Code, é um comando só, no formato claude mcp add --transport stdio --env GOOGLE_PROJECT_ID=seu-projeto --env GOOGLE_APPLICATION_CREDENTIALS=caminho-do-json google-ads -- pipx run --spec git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp.

E no Claude pela web?

O Claude na web não roda servidor local. Para usar o oficial ali, você precisa publicar o servidor: o repositório traz o caminho para o Google Cloud Run, com autenticação por cliente OAuth, e a documentação diz para adicionar no Claude um conector personalizado apontando para o endereço do Cloud Run com /mcp no fim. É infraestrutura sua, para manter e pagar. Existe também um piloto de endereço hospedado pelo próprio Google, restrito a participantes convidados.

Os caminhos para ter um Google Ads MCP

	Oficial do Google	Conector hospedado (Vazante)	ETL com MCP ou servidor de terceiros
Quem roda	Você, no computador ou na sua nuvem	O Vazante	O fornecedor, ou você no caso de projeto aberto
Instalação	pipx, projeto Google Cloud, credencial OAuth	Colar `https://vazante.app/api/mcp` e autorizar	Varia
Lê	Tudo o que o GAQL alcança	Campanhas, contas e dias: gasto, cliques, CTR, CPC, conversões, valor e CPA; termos de pesquisa	Varia de fornecedor para fornecedor
Escreve	Não	Sim, com confirmação e teto por ação	Varia; confira na documentação de cada um
Outras plataformas na mesma conversa	Não	Meta Ads, TikTok Ads, GA4, Search Console	Depende do catálogo
Custo	Grátis, mais a sua infraestrutura se publicar na nuvem	Plano do Vazante	Plano de cada fornecedor

Sobre a terceira coluna: Windsor.ai, Supermetrics e outros ETLs têm MCP próprio, e há servidores de terceiros e projetos da comunidade no GitHub. Cada um tem regra própria de leitura e escrita; a do Windsor.ai está em Windsor.ai MCP.

Quando o oficial basta

O oficial é a escolha certa quando três coisas são verdade: você (ou alguém do time) está à vontade com terminal e Google Cloud, o trabalho é só leitura (auditoria, relatório, investigação de conta) e o Google Ads é a única plataforma da pergunta. Nesse cenário ele é imbatível: é do Google, acompanha a API, não tem intermediário e o GAQL alcança mais campos do que qualquer conector pronto.

Ele deixa de bastar em três situações:

Quando a resposta pede ação. "Pausa essa campanha" e "negativa esse termo" não passam pelo oficial.
Quando a decisão envolve Meta ou TikTok. "Onde o lead saiu mais barato esta semana, somando tudo" pede um conector que enxergue as três plataformas.
Quando o time não é técnico. Pedir para um gestor de tráfego criar cliente OAuth e configurar gcloud é pedir para ele não usar.

Como ligar o Vazante como Google Ads MCP

No Vazante, você autoriza o Google com o login normal, marca as contas (inclusive as de MCC) e adiciona o conector no Claude em Configurações → Conectores → Adicionar conector personalizado, com o endereço https://vazante.app/api/mcp. Sem chave de API, sem Google Cloud. No Claude Code: claude mcp add --transport http vazante https://vazante.app/api/mcp e depois /mcp para autorizar. O passo a passo com as perguntas prontas está em como conectar o Google Ads ao Claude.

O que o conector do Vazante faz no Google Ads

Leitura: gasto, impressões, cliques, CTR, CPC, conversões, valor de conversão e CPA por campanha, por conta ou por dia, os termos de pesquisa e o histórico de alterações. Com a escrita ligada (vem ligada, e o dono desliga em Conta e equipe): pausa e reativa campanha, ajusta o orçamento diário da campanha, adiciona, pausa e reativa palavra-chave, adiciona palavra-chave negativa no nível da campanha e cria campanhas de Busca, Display, Performance Max e Shopping, com extensões, horários e públicos. O que a IA cria nasce pausado.

Toda ação pede confirmação no chat e respeita o teto por ação que você define; pedido acima do teto é recusado antes de chegar no Google. Orçamento compartilhado é recusado. Cada alteração fica no histórico com autor, origem e estado antes e depois. O Vazante não mexe em lance e não substitui o Google Ads.

Limites que nenhum Google Ads MCP resolve

Conversão mal configurada continua errada. A IA lê o que a conta registra. Se a tag conta clique no WhatsApp como compra, a resposta vem errada com toda a confiança.
A consulta gerada pode errar o campo. No oficial, a IA escreve GAQL; às vezes pede uma métrica que não combina com o recurso. A ferramenta de metadados existe justamente para isso. Confira a primeira resposta contra a interface do Google Ads.
O dado vai para o modelo. O próprio repositório do Google avisa que o servidor expõe seus dados ao agente ou modelo conectado. Vale para qualquer MCP; as perguntas de segurança estão em segurança de dados com IA.
Google Ad Manager é outro produto. Quem busca "Ad Manager" pensando em Google Ads vai cair numa API diferente, de quem vende espaço publicitário. Nem o oficial nem o Vazante cobrem.

Próximo passo

Se você é técnico e só quer ler: instale o oficial hoje, com a lista acima, e rode uma semana de perguntas de auditoria. Se quer perguntar e agir, ou juntar Google com Meta e TikTok na mesma resposta, teste um conector hospedado, comece só lendo e compare com a interface do Google Ads por alguns dias. Se a sigla ainda é nova, comece por o que é MCP. Planos e o valor dos 7 dias de entrada estão em preços.

Perguntas frequentes

Existe MCP oficial do Google Ads?

Existe. É o projeto de código aberto googleads/google-ads-mcp, documentado no site de desenvolvedores do Google Ads. Você instala e roda no seu computador ou na sua nuvem; um endereço hospedado pelo Google está em piloto só para convidados.

O MCP do Google Ads pausa campanha ou muda orçamento?

O oficial, não. A documentação diz que a versão atual é estritamente de leitura e não altera lances, não pausa campanhas e não cria anúncios. Para escrever pelo chat, você precisa de um conector que tenha ações de escrita, como o Vazante.

Ainda preciso de developer token para usar o MCP do Google Ads?

Não na versão mais recente. Segundo o Google, os developer tokens foram descontinuados em 9 de setembro de 2026 e o nível de acesso passou a seguir o projeto do Google Cloud. Você ainda precisa do projeto com a Google Ads API ativada e de uma credencial OAuth.

Dá para usar o MCP do Google Ads no Claude Code?

Dá. O oficial entra como servidor local pelo comando claude mcp add, apontando para o pipx. Um conector hospedado entra com claude mcp add --transport http e a autorização acontece pelo comando /mcp.

Google Ads MCP serve para o Google Ad Manager?

Não. O Google Ad Manager é a plataforma de quem vende espaço publicitário, com API própria. O servidor oficial e o Vazante falam com a Google Ads API, a de quem compra anúncio.