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

Para conectar o X 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 X Ads em linguagem natural.

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

Pré-requisitos

Conectar o X 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 X 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 elementos que fazem ferramentas como o X 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 cada IA compatível obtém acesso aos mesmos dados.

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

1. Conecte seus dados do X Ads à Porter

A Porter fica entre a API de Anúncios do X e o Claude. Ela gerencia o OAuth, limites 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 todo esse fluxo de ponta a ponta.

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

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

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

2. Conecte o MCP ao Claude

A URL do MCP da Porter é o que você cola no Claude. Depois de adicionada, o Claude pode consultar os dados do X 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 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. Comece a criar perguntas e dashboards

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

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

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 X 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 os dados do X Ads diante do Claude. As alternativas mais comuns são a API direta do X Ads (ou o MCP oficial dele, se houver), uma ponte ativa com o Google Sheets e o BigQuery para escala. Cada uma tem seus prós e contras — escolha a que se adapta à forma como sua equipe já trabalha.

• 🔌 API direta do X Ads (ou MCP oficial) — Converse diretamente com a Ads API do X você mesmo, ou instale o MCP nativo do X 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 ativa ou upload pontual de CSV. 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 de anúncios grandes ou agências que executam análise multiconta. O BigQuery agrega; o Claude consulta apenas resumos pré-construídos.

Via API direta do X Ads (ou MCP oficial)

Se você está construindo um produto em torno do X Ads — ou é um desenvolvedor que prefere controlar cada camada da integração — o caminho mais direto é conversar com a Ads API do X você mesmo, ou instalar o MCP oficial do X Ads (se existir). O X ainda não disponibiliza um MCP oficial, então isso significa escrever chamadas de API diretamente no Claude Code ou em seus próprios scripts. Você precisará seguir os limites de taxa e cotas e solicitar acesso à API quando aplicável. De qualquer forma, você pula a Porter completamente e chama o X a partir do seu próprio código ou do Claude Code com requisições HTTP brutas.

Via Google Sheets (planilha ativa ou CSV manual)

Se sua equipe já trabalha no Google Sheets — ou você quer um rastro de auditoria antes que o Claude toque em qualquer coisa — alimente o X Ads em uma planilha e depois deixe o Claude ler a planilha. Você pode automatizar o pipeline X Ads → Sheets com a Porter para que ele se atualize diariamente, ou fazer exportações pontuais de CSV da interface nativa do X Ads para análise estática.

Leia o tutorial completo do Sheets →

Via Google BigQuery (para escala)

Este é o caminho que a maioria das pessoas ignora — e é o que te salva quando sua conta de anúncios do X Ads fica séria. Um único anunciante grande ou uma agência gerenciando mais de 10 contas de anúncios atingirá limites de taxa da API e problemas de latência ao consultar o Claude diretamente. O Claude literalmente dirá que está demorando demais ou expirando em grandes extrações.

O BigQuery resolve isso. Você carrega os dados do X Ads em tabelas do BigQuery em uma programação, depois conecta o BigQuery ao Claude — seja por um MCP do BigQuery ou via Claude Code com consultas SQL. Em vez de pedir ao Claude para puxar dados brutos do X Ads, você deixa o BigQuery agregar em tabelas pequenas e otimizadas, e o Claude consulta apenas a saída resumida. Problema de escala resolvido.

Leia o tutorial completo do BigQuery →

Conectar o X 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 X 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. Como ele tem acesso ao seu sistema de arquivos, runtime e outras ferramentas de desenvolvedor, ele não apenas responde perguntas — pode construir software real. Scripts persistentes, rotinas agendadas, aplicativos HTML, dashboards internos, integrações que rodam 24/7 sem sua intervenção. Uma vez conectado ao MCP da Porter para o X Ads, toda uma categoria de trabalho se torna possível.

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

É aqui que o ecossistema MCP mais compensa. Como 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 X 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 em uma URL. Sem embed do Data Studio para quebrar quando o fornecedor muda os preços, sem restrições de template. O dashboard se atualiza automaticamente porque consulta o MCP da Porter a cada carregamento de página. Ideal 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 X Ads da Porter com páginas de destino de concorrentes e anúncios ativos da plataforma X Ads coletados via Firecrawl. O Claude Code une ambos em um relatório semanal de inteligência competitiva — seus números ao lado dos ângulos criativos e segmentação deles, com um resumo de LLM sobre o que mudou semana após semana. Roda em cron, chega na sua caixa de entrada toda segunda-feira de manhã. Ideal para: equipes internas que precisam de contexto de mercado, não apenas números internos.

📚 Wiki interno de marketing com métricas em tempo real Stack: Porter MCP + Airtable MCP (ou Notion MCP) Use o Airtable ou Notion como esquema, a Porter como fonte de dados. O Claude Code mantém cada página preenchida com gasto atual, CPA e ROAS para cada conta de anúncios — sem capturas de tela desatualizadas, sem copiar e colar do Excel. Novos funcionários leem uma entrada do wiki e têm contexto completo sobre a conta de um cliente. Ideal 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 X Ads via Porter, avalia limites — CTR cai abaixo de 1%, gasto diário sobe 2× a média móvel — e envia alertas no Slack ou Gmail no momento em que algo ultrapassa o limite. Você para de verificar dashboards reativamente; o dashboard se verifica e te diz quando olhar. Ideal 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 ao vivo, 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 X Ads estiver 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 X Ads — de perguntas e respostas simples a fluxos de trabalho completos voltados para o cliente.

1. Converse e faça 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 no Ads Manager. Mas o chat é o básico — os casos de uso interessantes vêm a seguir.

2. Combine o X Ads com seus dados de vendas (Stripe, HubSpot, Shopify)

É aqui que uma visão 360° fica real. Quando você conecta o X 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 UTMs, nomes de campanhas e timestamps — e te dar atribuição que nenhum número da plataforma consegue.

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

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

Com o Claude Code, você pode transformar o monitoramento do X 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 agendada no Claude Code que puxa o desempenho toda manhã e te 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 X 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 899 campos e métricas do X Ads em todos os níveis de relatório, além de detalhamentos por audiência, posicionamento, dispositivo e geografia. E a mesma URL do MCP também desbloqueia mais de 25 outras fontes — então o Claude pode combinar o X Ads com Google Ads, GA4, Shopify, HubSpot e mais em um único prompt.

Prompts que você pode copiar e colar hoje

1. Para agências

Use-os ao gerenciar várias contas de clientes no X Ads ou ao enviar relatórios semanais de clientes.

2. Para profissionais de marketing B2B

Use-os para otimização de geração de leads, refinamento de segmentação por palavra-chave e rastreamento de visita de perfil para conversão.

3. Para equipes de e-commerce

Use-os para monitoramento de compras no site, detecção de fadiga criativa e realocação de orçamento.

4. Multicanal

Use-os ao combinar o X Ads com outras plataformas para relatórios unificados e atribuição.

Limites, autenticação e boas práticas para o X Ads via Claude

Este é o modo de falha mais comum para profissionais de marketing que usam o X Ads via API ou MCP: esgotamento de cota durante extrações em massa de dados, não banimentos de conta. O profissional de marketing normalmente é um dono de agência ou líder de performance interno executando auditorias multiconta nas segundas-feiras de manhã — o perfil exato que a Porter atende. O custo real não é uma conta suspensa; é perda de produtividade (4–6 horas de exportações manuais) e atraso nos relatórios de clientes que prejudica a confiança. O atraso de 48 horas na geração de relatórios documentado na API do X Ads agrava o problema: mesmo quando a cota é redefinida, os dados de ontem muitas vezes ainda não estão disponíveis, tornando as promessas de “tempo real” de ferramentas de terceiros ativamente enganosas.

A fiscalização da API do X é baseada em cotas e padrões, não baseada em ferramentas. O X não bane contas de anunciantes porque você usou o Claude ou um servidor MCP. Ele limita ou suspende temporariamente o acesso à API por causa de como a API foi usada: enviando rajadas paralelas que excedem os limites de requisição por janela, redistribuindo IDs de conteúdo em escala sem autorização, ou fazendo scraping agressivo com automação de navegador. Acesso somente leitura dentro das janelas de taxa documentadas é seguro. Rajadas de escrita paralelas, leituras em massa não agrupadas em dezenas de contas de anúncios e redistribuição de dados não autorizada não são. A plataforma retorna 429 Too Many Requests erros primeiro, depois limitação progressiva; a suspensão é reservada para abuso repetido ou violações de política como redistribuição de dados não autorizada.

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

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

1. Rajadas de API paralelas em várias contas de anúncios. Enviar requisições simultâneas para puxar dados de campanha de muitas contas ao mesmo tempo viola as janelas de taxa por conta e por aplicativo. A API do X impõe limites por categoria como 450 escritas por janela de 1 minuto e 10.000 leituras de entidades principais por janela de 15 minutos no nível da conta de anúncios — exceder esses limites aciona imediatamente 429 limitação de taxa que pode escalar em suspensão temporária de acesso se o padrão se repetir em um curto período. Fonte: docs.x.com/x-ads-api/fundamentals/rate-limiting. Em vez disso: agrupe as requisições sequencialmente e respeite os x-rate-limit-remaining headers.

2. Escritas programáticas em escala sem verificação de tier. A API do X Ads exige acesso de tier Premium para operações de escrita (criação de campanhas, alterações de orçamento, ajustes de lance). O tier Basic é somente leitura. Tentar operações de escrita com um token de tier Basic falhará silenciosamente ou retornará erros de autorização — e tentar repetidamente escritas falhas pode esgotar sua cota de requisições sem realizar nada. Fonte: docs.x.com/x-ads-api/fundamentals/rate-limiting + análise de corpus de concorrentes sobre restrições de tier de API. Em vez disso: verifique seu tier de API antes de habilitar escopos de escrita, e use configurações de MCP somente leitura para fluxos de auditoria e relatórios.

3. Redistribuição não autorizada de Post IDs e conteúdo em cache. As diretrizes de desenvolvedor do X impõem um limite rígido de não mais que 1,5 milhão de redistribuições de Post ID por período de 30 dias e exigem a exclusão de conteúdo do X em cache dentro de 24 horas de uma solicitação de exclusão. Usar scripts gerados pelo Claude para puxar conteúdo criativo de anúncios (tweets, imagens, vídeos) e redistribuí-los para ferramentas de relatórios externas ou dashboards de clientes sem autorização adequada viola esses termos. Fonte: docs.x.com/developer-guidelines. Em vez disso: use apenas métricas de desempenho agregadas (impressions, clicks, spend) e vincule de volta aos ativos nativos do X em vez de armazená-los em cache ou espelhá-los.

Os três comportamentos acionam limitação de taxa baseada em cotas e 429 respostas progressivas. Se você quer usar o Claude para o X Ads com segurança, agrupe suas leituras, verifique seu tier antes de escritas, e nunca redistribua conteúdo criativo sem autorização.

O protocolo de escalabilidade de 5 regras

Com base nos limites de taxa e cotas documentados do X e nos comportamentos que realmente causaram limitação — não em suposições:

• Agrupe suas leituras; nunca faça rajadas. Mantenha-se dentro dos 10.000 leituras de entidades principais por janela de 15 minutos por conta de anúncios e 450 escritas por janela de 1 minuto. Exceder esses limites aciona 429 limitação de taxa que pode bloqueá-lo pelo restante da janela. Fonte: docs.x.com/x-ads-api/fundamentals/rate-limiting. O MCP da Porter impõe isso automaticamente enfileirando requisições e respeitando os x-rate-limit-remaining headers.

• Verifique seu tier de API antes de habilitar escritas. Tokens de tier Basic são somente leitura; operações de escrita exigem aprovação de tier Premium do X. Tentar escritas com tier Basic desperdiça cota e produz falhas de autorização. O MCP da Porter usa escopos somente leitura por padrão e exibe um aviso se operações de escrita forem solicitadas sem acesso Premium verificado.

• Respeite o atraso de 48 horas nos relatórios. Os dados da API do X Ads são não são em tempo real — dados de desempenho de campanha normalmente têm um atraso de 48 horas antes de estarem totalmente disponíveis e confiáveis. Tomar decisões de orçamento ou segmentação com base em extrações da API do mesmo dia ou de ontem produz conclusões imprecisas. Fonte: corpus de concorrentes (mcpplaygroundonline.com, 2025) + documentação da comunidade da API do X Ads. O MCP da Porter exibe timestamps de atualização dos dados em cada consulta para que os usuários saibam exatamente quão desatualizada está cada métrica.

• Limite a redistribuição de Post ID a ≤1,5 milhão por 30 dias. Se seu fluxo de trabalho envolve puxar conteúdo de tweets, IDs criativos ou dados de engajamento para redistribuição (por exemplo, dashboards de clientes, relatórios externos), mantenha-se abaixo do limite de 1,5 milhão de redistribuições de Post ID por período de 30 dias e exclua conteúdo em cache dentro de 24 horas de qualquer solicitação de exclusão. Fonte: docs.x.com/developer-guidelines. O MCP da Porter não armazena em cache ou redistribui conteúdo criativo — consulta apenas métricas agregadas, mantendo você bem dentro deste limite.

• Use escopos OAuth mínimos e audite anualmente. Solicite apenas os escopos que sua conexão MCP realmente precisa (normalmente ads:read para relatórios; ads:write somente se o tier Premium for confirmado). O X exige auditorias de segurança anuais para aplicativos com acesso elevado. O MCP da Porter solicita os escopos mais restritos possíveis no momento da conexão e registra cada chamada de API para trilhas de auditoria.

O que o MCP da Porter faz de diferente: ele impõe esses limites de taxa e salvaguardas no nível da plataforma. A Porter agrupa requisições de API entre contas para permanecer dentro das janelas de 10.000 leituras por 15 minutos e 450 escritas por minuto, recuando automaticamente quando x-rate-limit-remaining aproxima-se de zero. Ele usa por padrão escopos somente leitura para que usuários de tier Basic nunca desperdicem cota em tentativas de escrita não autorizadas. Ele exibe timestamps de atualização dos dados em cada resposta, tornando o atraso de 48 horas nos relatórios transparente em vez de oculto. Ele nunca armazena em cache ou redistribui Post IDs, mantendo você bem abaixo do limite de 1,5M de redistribuições. E ele solicita escopos OAuth mínimos no momento da conexão, reduzindo tanto a superfície de ataque de segurança quanto a carga de auditoria. Esse é o comportamento que os sistemas automatizados do X tratam com elegância — e é por isso que os usuários da Porter não são limitados.

Perguntas frequentes