4 formas de conectar o Google Ads ao Claude em 2026 (o jeito fácil)

boltTL;DR

Para conectar o Google Ads ao Claude via MCP: copie mcp.portermetrics.com/mcp, acesse o Claude.ai, abra Conectores → Gerenciar conectores → Adicionar conector personalizado, cole a URL e faça login. A partir daí, pergunte ao Claude qualquer coisa sobre suas campanhas do Google Ads em linguagem simples.

Depois de conectado, você pode automatizar a geração de relatórios e a análise do Google Ads — faça perguntas sobre seus dados, crie dashboards, acione alertas ou envie relatórios prontos para o cliente como o abaixo.

Pré-requisitos

• Uma conta da Porter Metrics com sua conta do Google Ads conectada (o plano gratuito é suficiente para testar de ponta a ponta)
• Uma conta do Claude — o plano gratuito funciona para o Claude Web; uma assinatura Pro é necessária para os recursos do Claude Code e MCP Desktop
• Acesso de administrador ou padrão às contas do Google Ads que você deseja conectar

Conectar o Google Ads ao Claude com MCP

Neste tutorial, vamos usar o método MCP. Aqui está uma explicação rápida do que é o MCP e por que é o melhor caminho para o Google Ads.

MCP (Model Context Protocol) é o padrão aberto que permite que ferramentas de IA como Claude, ChatGPT, Claude Code e outras acessem e usem APIs externas — os componentes que fazem ferramentas como o Google Ads funcionarem nos bastidores. Em vez de criar uma integração personalizada para cada ferramenta de IA que você usa, você instala um MCP e toda IA compatível obtém acesso aos mesmos dados.

content_paste

Configuração por copiar e colar

Sem tokens, sem scripts, sem ajuda de desenvolvedor — literalmente cole uma URL no Claude e pronto.

hub

Funciona com todas as ferramentas de IA

Claude, Claude Code, ChatGPT, Cursor, Antigravity, Lovable, Vercel v0, Zapier. Uma URL de MCP, toda ferramenta que fala o protocolo.

merge_type

Mais de 20 fontes em uma conexão

O MCP da Porter envia Google Ads mais Google Analytics 4, Shopify, HubSpot, Klaviyo, Google Sheets e mais de 20 outras. Consulte e combine todas em uma única conversa.

tune

Granularidade perfeita

Planilhas te prendem nas colunas que você exportou. O MCP acessa diretamente a API do Google Ads do Google — então você pode filtrar por campanha, detalhar por grupo de anúncios ou palavra-chave, e adicionar novas dimensões instantaneamente sem reconstruir tabelas.

A configuração completa leva menos de 5 minutos e se divide em três passos: conectar o Google Ads à Porter, apontar o Claude para o MCP da Porter e fazer sua primeira pergunta.

1. Conectar seus dados do Google Ads à Porter

A Porter fica entre a API do Google Ads do Google e o Claude. Ela gerencia o OAuth, limitação de taxa, paginação e toda a infraestrutura para que o Claude veja apenas dados limpos e estruturados.

Cadastre-se na Porter. Crie uma conta gratuita em portermetrics.com. O plano gratuito é suficiente para executar este fluxo completo de ponta a ponta.

Conecte sua conta do Google. Na Porter, clique em Criar → escolha Claude como destino → selecione Google Ads como fonte → faça login com o Google para conceder acesso às suas contas.

Selecione suas contas. Escolha as contas do Google Ads que você deseja que o Claude consulte. Quando você seleciona várias contas em uma única conexão, a Porter automaticamente combina os dados delas para que você possa consultá-las como uma só.

Opcional: habilite o armazenamento no BigQuery se você estiver conectando várias contas com grandes volumes de dados. Isso mantém as respostas do Claude rápidas mesmo em escala.

2. Conectar o MCP ao Claude

A URL do MCP da Porter é o que você cola no Claude. Depois de adicionada, o Claude pode consultar dados do Google Ads sob demanda em qualquer conversa.

Acesse claude.ai e clique no + ícone no campo de chat para abrir o menu de ferramentas.

No menu que abre, passe o mouse sobre Conectores e clique em Gerenciar conectores.

No painel de Conectores, clique no + botão no topo da lista para começar a adicionar um novo conector.

Escolha Adicionar conector personalizado no menu suspenso que aparece.

Uma caixa de diálogo abre com os campos de nome e URL. Digite Porter no primeiro campo para nomear o conector.

No segundo campo, cole https://mcp.portermetrics.com/mcp. Não altere as configurações avançadas.

Clique em Adicionar no canto inferior direito da caixa de diálogo. O Claude abre uma janela de login — use a mesma conta do Google vinculada ao seu workspace da Porter e aprove o acesso.

Assim que a autorização terminar, você verá as ferramentas de somente leitura da Porter aparecerem no painel de conectores. Você está pronto para começar a fazer perguntas.

Para um passo a passo mais completo com capturas de tela em cada etapa, consulte o tutorial do MCP da Porter.

3. Começar a criar perguntas e dashboards

Com a Porter conectada, abra um novo chat no Claude e pergunte qualquer coisa sobre seu Google Ads em linguagem simples. O Claude chama a Porter nos bastidores, puxa dados em tempo real do Google e responde com tabelas, gráficos ou resumos.

Experimente uma dessas para verificar se a configuração está funcionando:

chat_bubble“Quais foram minhas campanhas do Google Ads com melhor desempenho na semana passada, ordenadas por ROAS?”

chat_bubble“Quais grupos de anúncios têm o CPA mais alto este mês?”

chat_bubble“Mostre termos de pesquisa com mais de 10 cliques e zero conversões esta semana.”

Para um catálogo completo de prompts prontos para copiar e colar organizados por caso de uso (desempenho, fadiga, orçamento, agência, B2B, e-commerce, multicanal), vá para a seção de prompts abaixo.

Outras formas de conectar o Google Ads ao Claude

O MCP é o caminho que acabamos de percorrer — e o que recomendamos para a maioria dos profissionais de marketing. Mas não é a única forma de colocar dados do Google Ads na frente do Claude. As alternativas mais comuns são a API direta do Google Ads (ou o MCP oficial dele, se houver), uma ponte com o Google Sheets em tempo real, e o BigQuery para escala. Cada uma tem seus prós e contras — escolha a que se encaixa na forma como sua equipe já trabalha.

• 🔌 API direta do Google Ads (ou MCP oficial) — Converse diretamente com a API do Google Ads do Google, ou instale o MCP nativo do Google Ads, se existir. Controle máximo, mas você gerencia a autenticação, limites de taxa e paginação — e obtém apenas uma fonte.
• 📊 Google Sheets — Planilha em tempo real ou upload de CSV único. Auditável, familiar, mais rápido para grandes exportações — mas a agregação acontece na Planilha, não na API.
• 🗄️ Google BigQuery — Para contas grandes ou agências executando análise multiconta. O BigQuery agrega; o Claude consulta apenas resumos pré-construídos.

Via API direta do Google Ads (ou MCP oficial)

Se você está construindo um produto em torno do Google Ads — ou é um desenvolvedor que prefere controlar cada camada da integração — o caminho mais direto é conversar com a documentação da API do Google Ads você mesmo, ou instalando o servidor MCP oficial do Google Ads (se houver). O Google disponibiliza um servidor MCP oficial, mas ele exige Python 3.12, um Developer Token com acesso Explorer, ID/Secret do Cliente OAuth e configuração de ADC — tipicamente 2 a 4 horas de configuração. Você precisará seguir os limites de taxa e cotas do Google Ads e solicitar um Developer Token / acesso à API do Google Ads quando aplicável. De qualquer forma, você pula a Porter completamente e chama o Google a partir do seu próprio código ou do Claude Code com requisições HTTP brutas.

A contrapartida a saber. Ir direto lhe dá controle máximo e os dados mais atualizados possíveis — cada endpoint, cada parâmetro, sem camada de abstração no meio. Mas agora você é responsável pelos fluxos de OAuth, tokens de atualização, limites de taxa, paginação, mudanças de esquema e novas tentativas de erro. E, criticamente, você obtém apenas uma fonte. No momento em que você também quiser o Google Analytics 4, Shopify ou HubSpot na mesma conversa, você volta a construir (ou costurar) mais integrações.

Via Google Sheets (planilha em tempo real ou CSV manual)

Via Google BigQuery (para escala)

Leia o tutorial completo do BigQuery →

Conectar o Google Ads ao Claude Code

A maioria dos profissionais de marketing agrupa Claude e Claude Code e perde a maior vantagem de todo o ecossistema MCP. Eles não são a mesma ferramenta — e a diferença importa enormemente quando você começa a trabalhar com dados do Google Ads seriamente.

O Claude é uma interface de chat. Você faz uma pergunta, o Claude puxa dados em tempo real pelo MCP, responde, talvez construa um dashboard rápido dentro da conversa. Ótimo para análise pontual. O problema: tudo é efêmero. Quer atualizar o dashboard amanhã? Você o regenera do zero. Quer o mesmo relatório toda segunda-feira? Você refaz a pergunta toda segunda-feira.

O Claude Code é o Claude rodando dentro do terminal do seu computador. Porque ele tem acesso ao seu sistema de arquivos, runtime e outras ferramentas de desenvolvedor, ele não apenas responde perguntas — ele pode construir software real. Scripts persistentes, rotinas programadas, aplicativos HTML, dashboards internos, integrações que rodam 24/7 sem sua intervenção. Uma vez conectado ao MCP da Porter para o Google Ads, toda uma categoria de trabalho se torna possível.

O que o Claude Code desbloqueia que o Claude sozinho não pode

É aqui que o ecossistema MCP mais compensa. Porque o Claude Code pode combinar o MCP da Porter com outros MCPs — Firecrawl para web scraping, Airtable para dados estruturados, Notion para wikis, Vercel para deploy, Slack e Gmail para entrega — você não está mais consultando dados. Você está construindo ferramentas.

🛠️ Construa seu próprio aplicativo de gestão de orçamento

Stack: Porter MCP + Vercel MCP (ou Cloudflare Pages, Netlify)

Alimente o Claude Code com suas metas e objetivos do Google Ads — metas de CPA, orçamentos diários, limites de ROAS — e peça para ele gerar um dashboard de ROI personalizado para cada cliente. Ele constrói o HTML, puxa dados em tempo real, faz deploy para uma URL. Sem embed do Data Studio para quebrar quando o fornecedor muda os preços, sem restrições de template. O dashboard atualiza automaticamente porque consulta o MCP da Porter em cada carregamento de página.

Melhor para: agências que querem dashboards white-label para clientes sem depender do Looker ou Data Studio.

🔍 Monitoramento completo de concorrentes + desempenho

Stack: Porter MCP + Firecrawl MCP

Combine seu próprio desempenho do Google Ads da Porter com palavras-chave de concorrentes e anúncios em tempo real do Google Ads Auction Insights coletados via Firecrawl. O Claude Code une ambos em um relatório semanal de inteligência competitiva — seus números ao lado das estratégias de lance e ângulos de copy de anúncios deles, com um resumo de LLM sobre o que mudou semana a semana. Roda em cron, chega na sua caixa de entrada toda segunda-feira de manhã.

Melhor para: equipes internas que precisam de contexto de mercado, não apenas números internos.

📚 Wiki interna de marketing com métricas em tempo real

Stack: Porter MCP + Airtable MCP (ou Notion MCP)

Use o Airtable ou Notion como esquema, e a Porter como fonte de dados. O Claude Code mantém cada página preenchida com gasto atual, CPA e ROAS para cada conta — sem capturas de tela desatualizadas, sem copiar e colar do Excel. Novos funcionários leem uma entrada da wiki e têm contexto completo sobre a conta de um cliente.

Melhor para: agências e equipes de operações que fazem onboarding de analistas ou rotacionam gerentes de conta com frequência.

🔔 Alertas 24/7 sobre gasto, CTR e quedas de qualidade

Stack: Porter MCP + Slack MCP (ou Gmail MCP)

Uma rotina do Claude Code em cron puxa dados do Google Ads via Porter, avalia limites — CTR cai abaixo de 1%, gasto diário dispara 2× acima da média móvel — e envia alertas no Slack ou Gmail no momento em que algo cruza a linha. Você para de verificar dashboards reativamente; o dashboard se verifica e diz quando olhar.

Melhor para: qualquer equipe que já descobriu um problema 48 horas tarde demais porque ninguém abriu o relatório.

Conclusão: O Claude é para perguntas rápidas e dashboards ad hoc. O Claude Code é para construir aplicativos, dashboards em tempo real, alertas e ferramentas reais — qualquer coisa que você queira executar por conta própria sem refazer perguntas. A mesma URL do MCP da Porter funciona em ambos, então você não escolhe uma vez e fica preso.

Casos de uso — o que você pode realmente fazer depois que o Google Ads está conectado ao Claude

Acertar a conexão é metade da batalha. O valor real aparece no que você faz em seguida. Aqui estão os casos de uso que os usuários da Porter constroem em torno dos dados do Google Ads — de perguntas e respostas simples a fluxos de trabalho completos voltados para o cliente.

1. Conversar e fazer perguntas diretamente

O caso de uso mais simples — e ainda o que 80% dos profissionais de marketing começam. Abra o Claude, faça uma pergunta, obtenha uma resposta baseada em dados em tempo real.

É a forma mais rápida de substituir uma verificação diária na interface do Google Ads. Mas o chat é o básico — os casos de uso interessantes vêm a seguir.

2. Combinar o Google Ads com seus dados de receita (Stripe, HubSpot, Shopify)

É aqui que uma visão 360° fica real. Quando você conecta o Google Ads e sua fonte de receita (Stripe para SaaS, HubSpot CRM para B2B, Shopify para e-commerce), o Claude pode mapear campanhas de anúncios para negócios fechados ou compras reais — usando UTM e nome da campanha — e lhe dar atribuição que nenhum número de plataforma pode.

O Claude lida com o mapeamento de UTM e nome de campanha e as junções. Você obtém um relatório de atribuição pronto para o cliente que nenhuma plataforma individual pode gerar sozinha.

3. Alertas e notificações automatizados no Slack ou Gmail

Com o Claude Code, você pode transformar o monitoramento do Google Ads em uma rotina que roda sozinha. Conecte o MCP da Porter (para os dados) junto com um MCP do Slack ou Gmail (para entrega), depois escreva uma tarefa programada do Claude Code que puxa o desempenho toda manhã e o notifica apenas quando algo realmente precisa de atenção.

Sem dashboards, sem verificações diárias. O relatório vem até você — e apenas quando importa.

4. Apresentações prontas para o cliente com dados em tempo real (Gamma, HTML, PDF)

Uma dor comum de agências: você envia aos clientes um link do Data Studio, o Looker quebra, o cliente entra em pânico — e você gasta uma hora explicando um dashboard quebrado. Com o Claude, você pode construir a própria apresentação — como um deck Gamma, uma página HTML personalizada ou um PDF — preenchida com números em tempo real a cada vez.

A apresentação se torna um artefato de entrega que você envia ao cliente, não um dashboard que depende de outra ferramenta permanecer no ar. Sem iframe quebrado, sem solicitações de login, apenas o conteúdo.

Campos e métricas do Google Ads que você pode consultar com o Claude

Antes de começar a escrever prompts, ajuda saber quais dados estão realmente disponíveis. O MCP da Porter dá ao Claude acesso a 1.042 campos e métricas do Google Ads em todos os níveis de relatório, mais detalhamentos por audiência, dispositivo, geografia e termo de pesquisa. E a mesma URL do MCP também desbloqueia mais de 25 outras fontes — então o Claude pode combinar o Google Ads com Google Analytics 4, Shopify, HubSpot e mais em um único prompt.

Tempo

DataDia da SemanaSemanaMêsAnoMês do AnoTrimestreDia

Visibilidade

Active View CPMActive View CTRActive View ImpressionsActive View MeasurabilityActive View Measurable CostActive View Measurable ImpressionsActive View ViewabilityAvg. Impression Frequency per User

Conta

Auto-tagging EnabledAccepted Customer Data TermsCurrency CodeAccount name / descriptionCustomer Edit LinkFinal URL Suffix (Customer)Has Partners BadgeCustomer ID

Assets

Ad Group Asset IDBook on Google AssetCall Asset Ad Schedule TargetsCall Asset Conversion ActionCall Asset Conversion Reporting StateCountry Code (Call Asset)Phone Number (Call Asset)Call to Action Asset

Ads

Ad Action ItemsAdded by Google AdsApp Ad DescriptionsApp Ad HeadlinesApp Ad HTML5 Media BundlesApp Ad ImagesApp Ad Mandatory TextApp Ad YouTube Videos

Campaigns

Campaign Accessible Bidding StrategyAd Serving Optimization StatusAdvertising channel subty…Advertising channel typeApp Campaign App IDApp Campaign App StoreApp Campaign Bidding GoalUse Audience Grouped

Conversions

All conv.All Conv. (by Conv. Date)All conversions from click-to-callAll conversions from directionsAll conv. rate from InteractionsAll conv. from location asset click-to-callAll conv. from location asset directionsAll conv. from location asset menu

Bidding

Accessible Bidding Strategy IDAccessible Max Conv. Value Target ROASAccessible Max Conv. Target CPAAccessible Bidding Strategy NameAccessible Bidding Strategy Owner IDAccessible Bidding Strategy Owner NameAccessible Bidding Strategy Resource NameAccessible Target CPA

Products & Shopping

Activity RatingAffiliate Location Chain IDsAffiliate Location Relationship TypeFeed AttributesFeed IDFeed Item Attribute ValuesFeed Item End Date/TimeFeed Item Geo-Targeting Restriction

System & Admin

Ad Group Ad Label IDAd Group Label IDCampaign Label IDChange DateChange Date/TimeChange Resource NameChange Resource TypeChanged Fields

Audiences

Ad Group Audience View IDSearch keyword statusAgeAudience DescriptionAudience DimensionsAudience Exclusion DimensionAudience IDAudience

Geo

Activity CityActivity CountryActivity StateGeo Target AirportAirport IDGeo Target CantonCanton IDCity

Ad Groups

Ad groupAd Rotation ModeAd Group Audience GroupedBase Ad GroupCampaign (Ad Group)CPC BidCPM BidCPV Bid

Performance

Avg. CostAvg. CPCAvg. CPEAvg. CPMAvg. CPVAverage Target CPAAverage Target ROASClicks

Auction metrics

Impression (Absolute Top) %Search Abs. Top IS (Auction)Search Impr. share (Auction)Search Outranking Share (Auction)Search Overlap Rate (Auction)Search Position Above Rate (Auction)Search Top IS (Auction)Display Lost IS (budget)

Conversion Setup

Conversion categoryConversion Category NameConversion SourceConversion NameConversion Action OriginConversion Action Primary for GoalConversion Action Resource NameConversion Action Status

Revenue

All New Customer Lifetime ValueAverage Cart SizeAverage Order ValueCost of Goods SoldCross-Sell Cost of Goods SoldCross-Sell Gross ProfitCross-Sell RevenueCross-Sell Units Sold

Calls

Call duration secondsCall statusCall Tracking Display LocationCaller Area CodeCaller Country CodeEnd Call Date/TimeCall View Resource NameStart Call Date

Video

Gmail ForwardsGmail SavesGmail Secondary ClicksVideo played to 100%Video Played to 100% ViewsVideo played to 25%Video Played to 25% ViewsVideo played to 50%

Site

Pages / sessionAvg. session duration (se…)Bounce rateMobile Friendly Clicks Percentage% new sessionsSpeed ScoreUnique UsersValid AMP Clicks Percentage

App

Biddable App Install ConversionsBiddable App Post-Install ConversionsSKAdNetwork InstallsSKAdNetwork Total Conversions

Prompts que você pode copiar e colar hoje

1. Agências

Use estes quando precisar de respostas rápidas antes de chamadas com clientes ou quiser automatizar relatórios semanais em várias contas.

2. Profissionais de marketing B2B

Use estes quando a qualidade do lead e ciclos de vendas longos importam mais do que compras no mesmo dia.

3. Equipes de e-commerce

Use estes quando precisar de lucratividade a nível de produto, higiene de termos de pesquisa e pacing de orçamento com consciência de estoque.

4. Análise multicanal

Use estes quando quiser combinar o Google Ads com Shopify, HubSpot, GA4 ou Search Console em uma única conversa.

Limites, segurança e boas práticas para o Google Ads via Claude

Esta é a experiência representativa, não um conto de advertência. O profissional de marketing acima teve um positivo resultado porque usou a API dentro de seu escopo pretendido. A vulnerabilidade real para usuários do Google Ads não é “ser banido” — é perder horas em uma configuração auto-hospedada apenas para descobrir que seu developer token está bloqueado para contas de teste, ou esgotar sua cota diária de operações em consultas GAQL ineficientes e ter sua sessão de análise interrompida no meio da tarde. Para uma equipe de marketing gerenciando US$ 8 mil a US$ 50 mil por mês em gastos com anúncios, o custo não é a perda da conta; é perda de produtividade, relatórios atrasados e decisões tomadas com dados desatualizados porque o caminho da API que você escolheu era muito lento ou muito limitado.

A limitação de taxa do Google é baseada em cotas e medida dinamicamente, não baseada em ferramenta. O Google não bane ou suspende contas porque você usou o Claude ou um servidor MCP. Ele limita ou retorna erros por causa de como a API foi usada: excedendo a capacidade do Token Bucket para seu nível de acesso, enviando requisições de mutação acima do limite de 10.000 operações por requisição, ou atingindo o Planning Service a mais de 1 QPS. Consultas de somente leitura dentro do seu orçamento diário de operações são seguras. Rajadas paralelas que disparam QPS, fluxos de trabalho de mutação em escala que agrupam de forma muito agressiva, ou requisições que excedem o tamanho de mensagem gRPC de 64 MB não são. Violações aparecem como RESOURCE_TEMPORARILY_EXHAUSTED ou RESOURCE_EXHAUSTED erros — não banimentos de conta.

As três formas de esgotar sua cota do Google Ads

Depois de revisar documentos oficiais e tópicos da comunidade, três padrões aparecem repetidamente.

1. Rajadas paralelas de API que disparam QPS além do Token Bucket. Enviar altos volumes de requisições concorrentes para a API do Google Ads aciona limitação dinâmica. O sistema do Google mede consultas por segundo por ID de cliente e developer token usando um algoritmo de Token Bucket; não há um número fixo de QPS publicado, mas rajadas paralelas podem esgotar o bucket e retornar RESOURCE_TEMPORARILY_EXHAUSTED erros que interrompem sua sessão de análise. A abordagem mais segura é requisições sequenciais ou levemente paralelizadas com backoff exponencial. Fonte: documentação da API do Google Ads

2. Requisições de mutação que agrupam muitas operações em uma única chamada. A API do Google Ads permite até 10.000 operações por requisição de mutação, mas se aproximar desse limite com operações complexas (por exemplo, criação de campanha com vários grupos de anúncios, anúncios e palavras-chave) aumenta o risco de falhas parciais, tempos de execução longos e tamanho de mensagem gRPC se aproximando do limite máximo de 64 MB. Uma mutação massiva que falha pode deixar sua conta em um estado inconsistente e queimar cota sem entregar resultados. Divida grandes mudanças em lotes menores e validados. Fonte: limites de taxa e cotas do Google Ads

3. Executar consultas do Planning Service (KeywordPlanIdeaService, AudienceInsightsService) em velocidade de produção. Esses serviços têm limites rígidos e baixos: KeywordPlanIdeaService é limitado a 1 requisição por segundo por CID, e AudienceInsightsService é limitado a 2 requisições por segundo por developer token. Profissionais de marketing acostumados a puxar grandes conjuntos de dados de pesquisa de palavras-chave rapidamente atingirão esses limites imediatamente. O resultado não é um banimento — é um fluxo de trabalho paralisado e listas de palavras-chave incompletas que levam a decisões de campanha subótimas. Fonte: limites de taxa e cotas do Google Ads

Os três comportamentos acionam RESOURCE_EXHAUSTED ou RESOURCE_TEMPORARILY_EXHAUSTED erros. Se você quiser usar o Claude para o Google Ads com segurança, fique dentro do orçamento diário do seu nível, agrupe mutações de forma conservadora e limite explicitamente as chamadas do Planning Service.

O protocolo de escalabilidade de 5 regras

Baseado nas cotas documentadas do Google e nos comportamentos que realmente causaram esgotamento de cota — não em suposições:

• Fique dentro do orçamento diário de operações do seu nível de acesso. O acesso Explorer permite 2.880 operações por dia em contas de produção e 15.000 operações por dia em contas de teste. O acesso Basic permite 15.000 operações por dia em produção. Exceder esses limites rígidos retorna RESOURCE_EXHAUSTED e interrompe todas as consultas até que a janela diária seja reiniciada. Se você estiver executando grandes extrações históricas ou análise multiconta, faça upgrade para o acesso Basic antes de começar. Fonte: limites de taxa e cotas do Google Ads

• Limite lotes de mutação em 1.000 a 2.000 operações por requisição, não no máximo de 10.000. Embora a API tecnicamente aceite até 10.000 operações por requisição de mutação, ficar bem abaixo desse limite reduz o risco de falha parcial, mantém o tamanho da mensagem gRPC longe do limite de 64 MB, e torna a depuração de erros tratável. Se um grupo de anúncios em um lote de 10.000 operações falhar na validação, toda a lógica de nova tentativa se torna complexa. Lotes menores falham de forma elegante e preservam cota. Fonte: limites de taxa e cotas do Google Ads

• Respeite os limites de taxa do Planning Service: 1 QPS para KeywordPlanIdeaService, 2 QPS para AudienceInsightsService. Esses são limites rígidos e documentados — não dinâmicos. Se seu fluxo de trabalho do Claude incluir pesquisa de palavras-chave ou dimensionamento de audiência, limite essas chamadas explicitamente. Atingir o limite não aciona um banimento, mas retorna erros que quebram cadeias de prompts e produzem saídas incompletas. Fonte: limites de taxa e cotas do Google Ads

• Limite seu OAuth às permissões mínimas necessárias e rotacione as credenciais a cada 90 dias. A API do Google Ads exige o escopo https://www.googleapis.com/auth/adwords scope. Do not request broader Google Cloud or Gmail scopes alongside it. The MCP server documentation explicitly warns: “The MCP Server will expose your data to the Agent or LLM that you connect to it.” Minimizing scope limits blast radius if a token is compromised. Source: servidor MCP oficial do Google Ads

• Use contas de teste para desenvolvimento e valide consultas GAQL antes de executar em produção. As contas de teste da API do Google Ads não veiculam anúncios reais e têm limites de cota relaxados (15.000 operações/dia com acesso Explorer vs. 2.880 em produção). Executar uma consulta GAQL ampla e não testada em uma conta de produção com 50.000 palavras-chave pode queimar toda sua cota diária em uma única chamada. Teste primeiro, limite suas WHERE cláusulas de forma restrita, e pagine com LIMIT e OFFSET. Fonte: limites de taxa e cotas do Google Ads

O que o MCP da Porter faz de diferente: ele impõe esses limites e salvaguardas no nível da plataforma. A Porter lida com a minimização de escopo OAuth automaticamente, solicitando apenas o adwords escopo necessário para análise de somente leitura. A limitação de taxa com backoff inteligente está incorporada ao conector — a Porter agrupa requisições para ficar bem dentro do Token Bucket e exibe mensagens de erro claras se uma consulta for muito ampla, em vez de retornar erros RESOURCE_EXHAUSTED gRPC brutos. O agrupamento de consultas por conta significa que você pode analisar várias contas do Google Ads na mesma conversa do Claude sem acidentalmente agregar requisições sob um único developer token e atingir limites de cota compartilhados. Esse é o comportamento que os sistemas automatizados do Google tratam com elegância — e o comportamento que mantém suas sessões de análise rodando sem interrupção.

Perguntas frequentes