Google Ads MCP: como conectar o servidor do Google ao Claude

O servidor Google Ads MCP é somente leitura?

Por padrão, não, apesar da frase na página do Google.

Google Ads MCP server

Read-only. This implementation is strictly read-only. It cannot modify bids, pause campaigns, or create new assets.

O README lista sete ferramentas, e três delas leem: search, get_resource_metadata e list_accessible_customers.

As outras quatro escrevem: create_asset, upload_video_asset, manage_labels e manage_label_associations. Todas usam uma etapa que o Google chama de Propose and Confirm. A ferramenta primeiro devolve a descrição da alteração e um checksum, um código ligado exatamente àquela solicitação. Ela só executa quando esse código volta depois da sua aprovação.

Nenhuma das sete pode mudar um lance, pausar uma campanha ou editar um orçamento. Para travar o servidor só na leitura, defina labels: false e assets: false em tools_config.yaml.

Que acesso o servidor exige?

Você precisa de um projeto no Google Cloud com acesso à API do Google Ads, de um login OAuth e de um login Google que enxergue a conta. OAuth é aquela janela de “fazer login com o Google”. A página de tokens do Google diz “We sunset developer tokens on September 9, 2026” e que os níveis de acesso agora são “granted to your Google Cloud Console project”.

O Explorer permite 2.880 operações de produção por dia, o que cobre os relatórios de uma única conta. A página do servidor do Google pede Explorer, Basic ou Standard, então um projeto no nível Test não consegue ler uma conta real.

Atenção a uma falha listada pelo Google: alguns projetos atualizados depois de 9 de setembro recebem AUTHORIZATION_ERROR em chamadas de produção. O Google chama de solução temporária criar um novo projeto no Cloud com uma nova solicitação do Explorer, enquanto a correção é liberada.

Como conectar o Google Ads ao Claude

Estes passos seguem o README do Google, para o Claude Code. O servidor roda na sua própria máquina.

1. Instale o pipx, a ferramenta que executa o servidor, e a ferramenta de linha de comando gcloud do Google, que cuida do login.
2. Em um projeto do Google Cloud, ative a API do Google Ads e depois solicite o Explorer na página API Overview.
3. Crie um cliente OAuth. Adicione o escopo https://www.googleapis.com/auth/adwords à tela de consentimento e inclua você mesmo como usuário de teste se ela mostrar Testing. No modo Testing, as regras de público do Google deixam entrar apenas os usuários de teste listados, e cada login expira em sete dias.
4. Faça login e copie o caminho das credenciais que ele exibe:

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

5. Adicione o servidor em mcpServers no arquivo ~/.claude.json, ou no .mcp.json de um projeto. O README do Google cita ~/.claude/settings.json, enquanto a documentação de MCP do Claude Code cita estes dois:

{
  "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"
      }
    }
  }
}

6. Trabalha com uma conta de gerente (MCC)? Adicione GOOGLE_ADS_LOGIN_CUSTOMER_ID ao mesmo bloco env.
7. Reinicie e peça ao Claude que liste os clientes acessíveis.

O Claude na web exige um caminho mais longo. Um conector personalizado precisa de um endereço de servidor na internet, então você hospeda este no Cloud Run com um cliente OAuth. O Google alerta contra a implantação com --allow-unauthenticated sem esse cliente, já que qualquer pessoa poderia usar a conta do contêiner.

Há uma medida de segurança que não custa nada. O escopo adwords cobre leituras e alterações, então o limite de somente leitura fica na lista de ferramentas. Entre com um login Google cujo papel no Ads seja Somente leitura, e as regras de acesso do Google impedem edições de campanha na própria conta.

O que o servidor consegue ler?

Ele lê tudo o que a GAQL alcança. GAQL (Google Ads Query Language) é a linguagem de relatórios do Google, e o Claude a escreve para você. Campanhas, termos de pesquisa, orçamentos, status e histórico de alterações estão ao alcance da ferramenta search.

Use the Google Ads server. For the last 30 days, list search terms with spend and no conversions.
Sort by spend, show the top 50, and give spend in my account currency. Change nothing.

Confira os valores em dinheiro na resposta. A API devolve os montantes em micros, e a referência do Google define um milhão de micros como uma unidade da sua moeda. Peça ao Claude para mostrar uma conversão antes de confiar em uma tabela.

Os dados da sua conta também vão para o modelo. O README diz que o servidor “will expose your data to the Agent or LLM that you connect to it”, o que pesa no caso de contas de clientes.

Três tarefas para delegar, três para manter com você

A leitura é onde este servidor compensa o trabalho de configuração. Tudo o que mexe com dinheiro fica com você, e as ferramentas do servidor não fazem isso de qualquer forma.

Smart Bidding é o lance automático do Google. Uma palavra-chave negativa diz ao Google para não mostrar seu anúncio em determinada pesquisa.

O Google Ads Agent da Creatify redige as alterações para você

O Google Ads Agent da Creatify é um caminho para quem quer a segunda metade daquela tabela resolvida com um sim. A página de preços lista o Ad Agent para Meta, TikTok e AppLovin, sem citar o Google, então confirme seu plano com a Creatify antes de pagar.

Você entra com o Google, e donos ou administradores do seu workspace na Creatify escolhem as contas, inclusive as de gerente. Ele funciona pela API oficial do Google Ads.

Ele lê termos de pesquisa, parcela de impressões, Quality Score, informações de leilão e 30 dias de histórico de alterações. Cada pausa, orçamento, palavra-chave ou negativa aparece então em um card com os valores antes e depois, e só é executada depois da sua aprovação. Cards ignorados expiram em 72 horas. Ele nunca exclui.

Há três limites na própria página da Creatify. Ela cria campanhas de Pesquisa e adiciona novos anúncios a grupos de anúncios existentes, mas não cria campanhas Performance Max. Não redige lances de palavras-chave em “Maximize conversions”, CPA desejado ou ROAS desejado. E as rotinas agendadas “ask before acting unless you choose otherwise”, então deixe isso como está.

A Creatify não informa preço por ação: o agente “runs on credits”. Usuários relatam que os créditos acabam mais rápido do que os preços sugerem e citam as execuções do agente entre as causas (15 de 61 fontes: Trustpilot, Reddit).

A Creatify é a escolha errada para uma conta só de Pesquisa, sem planos de vídeo. A própria Creatify diz que as Recomendações e o Ads Advisor do Google se sobrepõem ao agente dela e são “free inside Google Ads”.

Segundo a própria empresa, o agente acrescenta três coisas. Ele lê o Google ao lado das suas outras contas de anúncios, explica mudanças a partir do seu histórico e cria novos anúncios no mesmo chat. Gestores de tráfego com IA compara o restante do mercado.

Onde o vídeo entra: Performance Max, Demand Gen e YouTube

O vídeo é onde o agente da Creatify vai além do servidor do Google. Ele pode criar um vídeo e adicioná-lo a um grupo de recursos existente do Performance Max depois da sua aprovação. Performance Max é a campanha multicanal do Google, e o grupo de recursos é o conjunto de anúncios dela.

A página não menciona campanhas de Demand Gen nem de YouTube. Para essas, gere o arquivo na Creatify e leve você mesmo até lá. Demand Gen é a campanha do Google para anúncios visuais no YouTube, Discover e Gmail, e as regras de vídeo dela são rígidas:

• Os vídeos já precisam estar no YouTube. “You can’t upload an offline video”, embora um vídeo não listado funcione.
• O mínimo é de 5 segundos, e “Videos shorter than 10 seconds won’t serve on YouTube In-stream.”
• Cada anúncio aceita de 1 a 5 vídeos, e o Google recomenda 1080 por 1920 para o YouTube Shorts.

O servidor do Google agora ajuda na etapa do meio. No modo local, upload_video_asset envia um arquivo de vídeo ao YouTube e create_asset o registra como recurso, cada um atrás da etapa de confirmação. A lista de ferramentas não tem como anexar esse recurso a uma campanha, então você conclui no Google Ads.

Como fazer um anúncio em vídeo no Claude ou no ChatGPT leva o arquivo de um chat até você. Anúncios no YouTube Shorts explica o formato.

Perguntas frequentes sobre o servidor Google Ads MCP

Ainda preciso de um token de desenvolvedor para o Google Ads MCP?

Não. O Google encerrou os tokens de desenvolvedor em 9 de setembro de 2026. O acesso agora segue o projeto do Google Cloud por trás do seu login OAuth.

O servidor Google Ads MCP é grátis?

Nenhuma das duas páginas do Google informa preço. Você executa o código por conta própria, e a hospedagem no Cloud Run é cobrada na sua conta do Google Cloud.

O Google Ads MCP consegue pausar uma campanha ou mudar um orçamento?

Não. As sete ferramentas do README executam consultas e cuidam de recursos, rótulos e uploads de vídeo. Nenhuma altera um lance, o status de uma campanha ou um orçamento.

Funciona com o app do Claude e também com o Claude Code?

Sim, com mais trabalho. O Claude Code o executa localmente a partir de um arquivo de configuração. O app web do Claude exige o servidor hospedado na internet com um cliente OAuth.

Uma única configuração alcança várias contas de clientes?

Sim. Defina GOOGLE_ADS_LOGIN_CUSTOMER_ID como a sua conta de gerente, e o servidor alcança as contas abaixo dela que o seu login consegue ver.

Mais páginas para usuários do Creatify, organizadas por tarefa, na central do Creatify →