MCP para Google Ads: conexão, eCommerce e leads B2B

Imagine que você tem um eCommerce. A semana começa e você quer entender por que o investimento em publicidade aumentou, mas as vendas não acompanharam. Sua primeira pergunta poderia ser: «Quais campanhas explicam a diferença e o que devemos revisar primeiro?». Com o MCP para Google Ads, você pode fazer essa pergunta a um assistente de IA conectado aos dados da sua conta.

O Google documenta um servidor MCP que conecta assistentes compatíveis à API do Google Ads. MCP significa Model Context Protocol: um protocolo que permite ao assistente consultar ferramentas e dados externos para elaborar sua resposta. A novidade prática é poder conversar sobre a conta com informações obtidas diretamente dela. Guia oficial do MCP para Google Ads.

Para uma empresa, isso abre uma forma diferente de trabalhar: começar pela pergunta de negócio, pedir as evidências e aprofundar a investigação onde surgir um problema. A conexão inicial exige configuração técnica; depois, as consultas podem ser muito mais simples.

Em síntese

Você pode usar um assistente conectado para explorar o desempenho do Google Ads e preparar análises que depois confere na conta.
No eCommerce, convém distinguir compras de outras conversões; no B2B, contatos recebidos de oportunidades qualificadas.
Para começar, propomos uma conexão limitada à leitura e uma verificação com uma conta e um período conhecidos.
A versão e as ferramentas habilitadas importam: o guia e o repositório apresentam diferenças que explicamos a seguir.

O que muda quando seu assistente pode consultar a conta

Pense em uma conversa que pode ser refinada aos poucos. Primeiro, você pergunta o que mudou. Depois, pede os detalhes por campanha. Por fim, escolhe o que revisar com sua equipe.

Por exemplo, diante de uma queda nas vendas, uma resposta útil deveria mostrar quanto o investimento mudou, o que aconteceu com as compras atribuídas e qual parte da diferença corresponde a cada campanha. Se propuser uma explicação, o assistente deveria distingui-la dos dados que realmente conseguiu consultar.

A qualidade da análise depende tanto da conexão quanto da pergunta. «Como está a conta?» deixa muitas decisões em aberto. Uma consulta que identifica o negócio, o período, a conversão relevante e o critério de comparação é mais fácil de verificar.

Os exemplos a seguir são cenários hipotéticos de uso, não casos de clientes nem resultados medidos pela CookingMetrics.

Imagine que você tem um eCommerce: agora pode investigar o que aconteceu com suas vendas

Você tem uma loja de artigos para o lar. Vende produtos de diferentes preços e trabalha com várias campanhas. Quer entender onde concentrar a revisão da semana.

Uma primeira consulta poderia ser:

Para a conta que eu indicar, compare os últimos 28 dias completos cujo encerramento tenha ocorrido há pelo menos 24 horas com os 28 dias anteriores. Use o fuso horário da conta. Mostre investimento, compras atribuídas, valor dessas compras e ROAS por campanha. Identifique quais campanhas explicam a maior parte da mudança. Esclareça quais ações de conversão foram consideradas compras e sinalize os dados que não conseguiu obter.

O ROAS relaciona o valor atribuído às conversões ao investimento publicitário. Para interpretá-lo neste exemplo, primeiro é preciso verificar se o valor corresponde a compras e se está sendo registrado corretamente. Um bom ROAS também não basta para conhecer o lucro: ainda faltam custos, margem e devoluções.

Com essa primeira resposta, você poderia continuar:

Nas campanhas que apresentaram as maiores quedas, compare o desempenho por dispositivo quando os dados permitirem. Separe as mudanças observadas das suas hipóteses. Proponha três verificações antes de recomendar uma alteração.

Assim, a conversa pode se transformar em uma agenda de trabalho: conferir a mensuração, revisar a experiência de compra no celular ou investigar uma promoção que terminou. São verificações propostas, não causas comprovadas pelo assistente.

Além disso, um período encerrado não necessariamente tem todas as conversões registradas. O Google explica que o intervalo entre a interação e a conversão pode fazer o CPA parecer mais alto ou o ROAS mais baixo. O critério de esperar 24 horas evita comparar dias recentes demais, mas não elimina esse intervalo. Intervalo de conversão no Google Ads.

Conteúdo exclusivo

Para leitores com conta

Da pergunta ao relatório de eCommerce

Aprenda a separar investimento e compras com consultas GAQL, calcular o ROAS sem duplicar custos e conferir os resultados no Google Ads. Inclui consultas de exemplo e um exercício numérico.

Entre na sua conta para acessar o guia avançado →

Trabalhamos para oferecer conteúdos da melhor qualidade; por isso algumas destas explicações não são públicas.

Se você vende serviços B2B, a pergunta é quais contatos se tornam oportunidades

Uma consultoria que implementa software de gestão

Imagine que sua empresa vende implementação de ERP para outras empresas. Uma campanha recebe muitos formulários, mas a equipe comercial relata que vários contatos são de estudantes ou de pessoas que procuram suporte gratuito.

Você poderia começar assim:

Analise separadamente as ações de conversão desta conta. Mostre quais correspondem a formulários enviados e quais, se existirem, a leads qualificados ou oportunidades comerciais. Compare o volume e o custo por resultado de cada campanha. Se a conta medir apenas formulários, indique que isso não é suficiente para avaliar a qualidade comercial.

A distinção é essencial: um formulário enviado demonstra interesse, mas ainda não comprova a existência de uma empresa com necessidade, orçamento e perfil adequado ao serviço.

O Google Ads contempla objetivos de leads qualificados e leads convertidos, vinculados a etapas do processo comercial e a dados de conversões off-line. Para analisá-los, essas informações precisam estar efetivamente registradas. Conectar o MCP não incorpora, por si só, os dados do CRM. Documentação do Google sobre leads qualificados e convertidos.

Se esses dados existirem, você poderá investigar quais campanhas geram oportunidades mais avançadas. Se faltarem, a primeira melhoria do processo seria definir com a equipe de vendas o que caracteriza um lead qualificado e como registrar esse sinal.

Uma empresa de manutenção industrial

Agora imagine uma empresa que oferece manutenção de equipamentos para fábricas. Ela quer alcançar responsáveis por compras e manutenção, mas também recebe pedidos de reparos domésticos e contatos de pessoas procurando emprego.

Uma pergunta útil seria:

Revise os termos de pesquisa disponíveis para as campanhas selecionadas. Agrupe-os por intenção provável: contratação empresarial, reparo doméstico, emprego ou informação geral. Mostre exemplos, investimento e conversões disponíveis. Sinalize os termos ambíguos e prepare candidatos para revisão humana, sem aplicar exclusões.

A classificação ajudaria a revisar a relevância, mas não comprovaria quem fez cada pesquisa. Uma palavra isolada pode ter vários sentidos. Além disso, o Google omite alguns termos com pouca atividade por motivos de privacidade: a ausência de um termo no relatório não demonstra que ninguém o pesquisou. Abrangência do relatório de termos de pesquisa.

O próximo passo poderia ser comparar os achados com os contatos recebidos por vendas. Isso ajudaria a decidir se é necessário ajustar as mensagens, esclarecer quais empresas o serviço atende ou revisar termos candidatos à exclusão.

Conteúdo exclusivo

Para leitores com conta

Do formulário à oportunidade B2B

Defina as etapas que seu CRM precisa registrar, diferencie custo por lead de custo por oportunidade e evite comparar contatos de períodos incompatíveis. Inclui um caso numérico e critérios para revisar a mensuração com vendas.

Entre na sua conta para acessar o guia avançado →

Trabalhamos para oferecer conteúdos da melhor qualidade; por isso algumas destas explicações não são públicas.

Como conectar o MCP para Google Ads, passo a passo

Para um primeiro teste, propomos o caminho local: o servidor é executado no seu computador e seu aplicativo de IA se comunica com ele. Se você não costuma trabalhar com o Google Cloud ou o terminal, esta é a parte que convém preparar com alguém da área técnica.

1. Prepare o acesso ao Google Cloud e ao Google Ads

Você precisa de uma identidade do Google autorizada na conta que vai consultar e de um projeto no Google Cloud. Nesse projeto, habilite a Google Ads API e verifique o nível de acesso: para contas reais, confirme que ele não está limitado a testes. O guia explica como solicitar acesso Explorer. Configuração do projeto para a Google Ads API.

O guia vigente do MCP informa que as versões recentes usam GOOGLE_PROJECT_ID e já não exigem o antigo developer token. Se você estiver seguindo um tutorial anterior, confira as instruções em relação à versão que vai instalar. Requisitos atuais do MCP.

2. Prepare as ferramentas e autorize seu usuário

Para este procedimento, você precisa de Python, Git, pipx, da CLI do Google Cloud (gcloud) e de um aplicativo de IA compatível com servidores MCP locais. O pipx permite executar aplicativos Python em ambientes isolados. Documentação do pipx.

Configure o consentimento OAuth do projeto e crie um cliente OAuth para um aplicativo de computador. Baixe o JSON dele em uma pasta privada; se o aplicativo estiver em modo de teste, adicione como usuário de teste a conta que vai usar. OAuth é o mecanismo que abre o login do Google e solicita autorização. Criação de clientes OAuth.

Com esse arquivo, gere as credenciais locais ADC —as credenciais que o programa utilizará— com o comando abaixo. Substitua o caminho de exemplo pela localização real do JSON do cliente OAuth:

gcloud auth application-default login \
  --client-id-file="/absolute/path/oauth-client.json" \
  --scopes="https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform"

Entre com o usuário autorizado no Google Ads e guarde o caminho do arquivo ADC informado pelo comando. Ele é diferente do JSON do cliente OAuth. O Google documenta o uso de um cliente próprio e de escopos explícitos para autorizar serviços fora do Google Cloud. O arquivo ADC contém um token de atualização: mantenha-o fora de repositórios e conversas. Configuração de ADC local.

3. Limite a primeira instalação a consultas

Ao consultar as fontes em 11 de novembro de 2026, encontramos uma diferença: o guia descreve um MCP somente de leitura, enquanto o repositório lista ferramentas para criar recursos publicitários e gerenciar rótulos. Por isso, não convém presumir que todas as instalações tenham as mesmas permissões.

O repositório permite desativar essas categorias. Crie um arquivo tools_config.yaml com este conteúdo e guarde seu caminho absoluto:

namespaces:
  customers: true
  search: true
  metadata: true
  labels: false
  assets: false

A variável GOOGLE_ADS_MCP_TOOLS_CONFIG indica qual arquivo carregar. Configuração de ferramentas do repositório oficial.

4. Adicione o servidor ao seu aplicativo de IA

Este exemplo combina a configuração local documentada pelo Google com a restrição anterior. A localização do arquivo e o formato aceito dependem do seu aplicativo; use-o em clientes que aceitem mcpServers e transporte local stdio:

{
  "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": "/absolute/path/adc.json",
        "GOOGLE_ADS_MCP_TOOLS_CONFIG": "/absolute/path/tools_config.yaml"
      }
    }
  }
}

Substitua o projeto e os dois caminhos. Se o acesso ocorrer por uma conta de administrador, configure também GOOGLE_ADS_LOGIN_CUSTOMER_ID com o identificador dela; diferencie essa conta da conta anunciante que quer analisar. Configuração local oficial.

O exemplo baixa código do repositório. Para um uso estável, recomendamos que a pessoa responsável pela conexão fixe uma revisão testada e controle suas atualizações.

5. Confira a conexão antes de pedir um diagnóstico

Reinicie ou recarregue os servidores MCP no seu aplicativo. Verifique se as ferramentas habilitadas correspondem à consulta de contas, pesquisas e metadados.

Depois, teste:

Liste as contas às quais tenho acesso direto. Antes de consultar métricas, peça que eu escolha uma conta. Confirme o identificador, a moeda e o fuso horário dela. Não combine informações de outros anunciantes.

Se aparecer uma conta de administrador, identifique a conta cliente autorizada antes de continuar. Em seguida, peça o investimento de uma campanha em um período conhecido e confira o resultado no Google Ads usando as mesmas datas, filtros e moeda.

Se o servidor não iniciar, verifique se o aplicativo encontra o pipx e se os caminhos configurados existem. Se o acesso falhar, confira a identidade autorizada, as permissões, os escopos e o nível de acesso do projeto antes de tentar analisar resultados.

Conteúdo exclusivo

Para leitores com conta

Uma conexão que você consiga manter

Prepare uma instalação reproduzível, confira o acesso a contas gerenciadas e organize um procedimento de atualização e recuperação. Inclui uma ficha técnica e testes de aceitação.

Entre na sua conta para acessar o guia avançado →

Trabalhamos para oferecer conteúdos da melhor qualidade; por isso algumas destas explicações não são públicas.

Como começar a usar sem perder o critério comercial

Escolha uma pergunta que possa verificar: quais campanhas explicam uma variação no investimento, como as compras atribuídas mudaram ou o que está sendo contado como lead.

Peça que cada resposta inclua conta, período, métricas utilizadas, dados ausentes e hipóteses. Se precisar de margem, estoque ou evolução de oportunidades, identifique primeiro onde estão esses dados e como vai incorporá-los com autorização. O assistente recebe os dados que consulta: revise também quais informações do negócio você compartilha com o fornecedor de IA. Considerações do repositório.

Na CookingMetrics, propomos começar por uma decisão concreta e pela qualidade da sua mensuração. Para seu eCommerce, pode ser entender o que explica uma queda nas compras. Para sua empresa B2B, distinguir quais campanhas geram oportunidades que a equipe de vendas realmente pode trabalhar.

Conteúdo exclusivo

Para leitores com conta

Um diagnóstico semanal que você possa auditar

Transforme as consultas ao assistente em um processo com controles de dados, hipóteses e decisões documentadas. Inclui um protocolo para investigar mudanças e um modelo reutilizável.

Entre na sua conta para acessar o guia avançado →

Trabalhamos para oferecer conteúdos da melhor qualidade; por isso algumas destas explicações não são públicas.

Leituras relacionadas

Veja também MCP do Google Analytics: o que faz e como conectá-lo ao GA4.

Para ver o que muda quando um agente de IA visita o seu próprio site, contamos o que aprendemos ao revisar nosso site para agentes de IA. Para aprofundar as informações do catálogo, consulte o guia de atributos conversacionais do Merchant Center. Se você precisa revisar URLs de um relatório do Google Analytics, o GA4 Page Links é uma ferramenta separada que ajuda a abri-las no domínio correto; ele não faz parte do MCP para Google Ads.

Perguntas frequentes

O MCP gerencia as campanhas automaticamente?

Este guia propõe habilitar apenas consultas. Não interprete uma recomendação do assistente como uma alteração executada. As capacidades dependem da versão e das ferramentas habilitadas; por isso, incluímos uma configuração explícita de leitura.

Ele pode dizer quais leads se tornaram vendas?

Somente se dispuser de dados que permitam responder a essa pergunta. Se o Google Ads registrar apenas formulários enviados, o assistente não poderá deduzir quais se tornaram clientes. É necessário incorporar as etapas comerciais por meio de uma integração adequada ou analisar outra fonte autorizada.

A instalação local é a única opção?

O Google também documenta uma implantação remota no Cloud Run. Ela exige configurar hospedagem, autenticação e um cliente compatível. Para compartilhá-la com uma equipe, siga a seção de implantação do guia oficial com apoio técnico.