Para conectar a Apple Ads ao Claude via MCP: copie mcp.portermetrics.com/mcp, vá para 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 da Apple Ads em linguagem simples.
Depois de conectado, você pode automatizar seus relatórios e análises da Apple Ads — faça perguntas sobre seus dados, construa dashboards, configure alertas ou envie relatórios prontos para o cliente como o abaixo.
Pré-requisitos
- Uma conta da Porter Metrics com sua conta da Apple Ads conectada (o plano gratuito é suficiente para experimentar de ponta a ponta)
- Uma conta do Claude — o plano gratuito funciona para o Claude Web; uma assinatura Pro é necessária para os recursos MCP do Claude Code e Desktop
- Acesso de administrador ou padrão às contas da Apple Ads que você deseja conectar
Conectar a Apple Ads ao Claude com MCP
Para este 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 a Apple 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 — as coisas que fazem ferramentas como a Apple Ads funcionarem nos bastidores. Em vez de construir uma integração personalizada para cada ferramenta de IA que você usa, você instala um MCP e toda ferramenta de IA compatível obtém acesso aos mesmos dados.
Quatro razões pelas quais o MCP vence para a Apple Ads:
A configuração completa leva menos de 5 minutos e se divide em três passos: conectar a Apple Ads à Porter, apontar o Claude para o MCP da Porter, e fazer sua primeira pergunta.
1. Conecte seus dados da Apple Ads à Porter
A Porter fica entre a API de Gerenciamento de Campanhas da Apple e o Claude. Ela lida com OAuth, limitação de taxa, paginação e toda a infraestrutura para que o Claude apenas veja 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 da Apple Ads. Na Porter, clique em Criar → escolha Claude como destino → selecione Apple Ads como fonte → faça login com a Apple para conceder acesso às suas contas.
NEEDS_PRODUCE: auth screenshot Connect-and-authorize-your-Apple-Ads-profile.jpgSelecione suas contas. Escolha as contas da Apple Ads que você deseja que o Claude consulte. Quando você seleciona várias contas sob uma única conexão, a Porter automaticamente combina seus dados para que você possa consultá-las como uma só.
NEEDS_PRODUCE: account select screenshot Select-Apple-Ads-account.jpgOpcional: habilite o armazenamento automático 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. Conecte o MCP ao Claude
A URL do MCP da Porter é o que você cola no Claude. Uma vez adicionada, o Claude pode consultar dados da Apple Ads sob demanda em qualquer conversa.
Vá para claude.ai e clique no + ícone no campo de entrada do chat para abrir o menu de ferramentas.
No menu que se 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 se 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.
Quando 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. Comece a construir perguntas e dashboards
Com a Porter conectada, abra um novo chat do Claude e pergunte qualquer coisa sobre sua Apple Ads em linguagem simples. O Claude chama a Porter nos bastidores, puxa dados ao vivo da Apple e responde com tabelas, gráficos ou resumos.
Experimente uma destas para verificar se a configuração está funcionando:
Para um catálogo completo de prompts copiar-colar organizados por caso de uso (desempenho, fadiga, orçamento, agência, B2B, e-commerce, cross-channel), vá para a seção de prompts abaixo.
Outras formas de conectar a Apple 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 da Apple Ads na frente do Claude. As alternativas mais comuns são a API direta da Apple Ads (ou seu MCP oficial, se houver), uma ponte com Google Sheets ao vivo, 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 da Apple Ads (ou MCP oficial) — Converse diretamente com a API de Gerenciamento de Campanhas da Apple, ou instale o MCP nativo da Apple Ads se houver. Controle máximo, mas você lida com autenticação, limites de taxa e paginação — e só obtém uma fonte.
- 📊 Google Sheets — Planilha ao vivo ou upload manual 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 grandes ou agências executando análise multi-conta. O BigQuery agrega; o Claude apenas consulta resumos pré-construídos.
Via API direta da Apple Ads (ou MCP oficial)
Se você está construindo um produto em torno da Apple Ads — ou é um desenvolvedor que prefere controlar cada camada da integração — o caminho mais direto é conversar com a Campaign Management API da Apple você mesmo, ou instalando um MCP oficial da Apple Ads (se houver). A Apple não publica um servidor MCP oficial, então isso significa escrever chamadas de API diretamente no Claude Code ou em seus próprios scripts. Você precisará seguir os rate limits & quotas da Apple e solicitar um Developer Token / API access quando aplicável. De qualquer forma, você pula a Porter inteiramente e chama a Apple a partir do seu próprio código ou do Claude Code com requisições HTTP brutas.
Via Google Sheets (planilha ao vivo ou CSV manual)
Se sua equipe já vive no Google Sheets — ou você quer um rastro de auditoria antes que o Claude toque em qualquer coisa — alimente a Apple Ads em uma Planilha, depois deixe o Claude ler a Planilha. Você pode automatizar o pipeline Apple Ads → Sheets com a Porter para que ele se atualize diariamente, ou fazer exportações pontuais de CSV da interface nativa da Apple Ads para análise estática.
Via Google BigQuery (para escala)
Este é o caminho que a maioria das pessoas ignora — e é o que salva você quando sua conta da Apple Ads fica séria. Um único anunciante grande ou uma agência gerenciando 10+ contas 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 dados da Apple Ads em tabelas do BigQuery em um cronograma, depois conecta o BigQuery ao Claude — seja através de um MCP do BigQuery ou via Claude Code com consultas SQL. Em vez de pedir ao Claude para puxar dados brutos da Apple Ads, você deixa o BigQuery agregar em tabelas pequenas e otimizadas, e o Claude apenas consulta a saída resumida. Problema de escala resolvido.
Conectando a Apple 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 da Apple Ads seriamente.
Claude é uma interface de chat. Você faz uma pergunta, o Claude puxa dados ao vivo através do 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.
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 — ele 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 a Apple Ads, uma categoria inteira 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. 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 implantação, Slack e Gmail para entrega — você não está mais consultando dados. Você está construindo ferramentas.
Alimente o Claude Code com suas metas e objetivos da Apple 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 ao vivo, implanta em uma URL. Sem embed do Data Studio para quebrar quando o fornecedor muda os preços, sem restrições de modelo. O dashboard se 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.
Combine seu próprio desempenho da Apple Ads da Porter com páginas de destino de concorrentes e anúncios ao vivo da Biblioteca de Anúncios do Meta coletados via Firecrawl. O Claude Code costura ambos em um relatório semanal de inteligência competitiva — seus números ao lado dos ângulos criativos e preços 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.
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 — sem capturas de tela desatualizadas, sem copiar-colar do Excel. Novos funcionários leem uma entrada do wiki e têm contexto completo sobre a conta de um cliente.
Melhor para: agências e equipes de operações que integram analistas ou rotacionam gerentes de conta com frequência.
Uma rotina do Claude Code em cron puxa a Apple 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: Claude é para perguntas rápidas e dashboards pontuais. Claude Code é para construir aplicativos, dashboards ao vivo, alertas e ferramentas reais — qualquer coisa que você queira rodar 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 a Apple Ads estiver conectada 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 de seus dados da Apple Ads — desde perguntas e respostas simples até 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 ao vivo.
É a forma mais rápida de substituir uma verificação diária de dashboard da Apple Ads. Mas o chat é o básico — os casos de uso interessantes vêm a seguir.
2. Combine a Apple Ads com seus dados de vendas (Stripe, HubSpot, Shopify)
É aqui que uma visão 360° fica real. Quando você conecta a Apple 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 reais ou compras — usando UTMs, nomes de campanhas e timestamps — e dar a você uma atribuição que nenhum número de plataforma pode.
O Claude lida com o mapeamento de UTMs, nomes de campanhas e timestamps e 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 da Apple Ads em uma rotina que roda por conta própria. Conecte o MCP da Porter (para os dados) junto com um MCP do Slack ou Gmail (para entrega), depois escreva uma tarefa agendada do Claude Code que puxa o desempenho toda manhã e notifica você 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 ao vivo (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 ao vivo 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 prompts de login, apenas o conteúdo.
Campos e métricas da Apple 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 120 campos e métricas da Apple Ads em todos os níveis de relatório, mais 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 a Apple Ads com Google Ads, GA4, Shopify, HubSpot e mais em um único prompt.
Veja Todos os campos e métricas da Apple Ads para a referência completa.
Prompts que você pode copiar e colar hoje
Prompts para agências
Foco do caso de uso: supervisão multi-conta, relatórios de clientes e auditorias de eficiência em várias contas da Apple Ads.
Prompts para profissionais de marketing B2B
Foco do caso de uso: profissionais de marketing de aplicativos B2B (produtividade, SaaS mobile, ferramentas de negócios) otimizando para installs de qualidade e sinais de funil inferior.
Prompts para equipes de e-commerce
Foco do caso de uso: aplicativos de e-commerce e DTC impulsionando installs, redownloads e compras no aplicativo através da Apple Search Ads.
Prompts cross-channel
Foco do caso de uso: combinar a Apple Ads com outras plataformas de marketing na mesma conexão do Porter MCP para análise unificada.
Limites, autenticação e melhores práticas para a Apple Ads via Claude
“A Apple impõe limites de taxa não documentados em chamadas de API… exceder os limites interrompe a recuperação de dados e pode corromper pipelines de relatórios durante análise de campanhas de alto volume.” — análise da comunidade sobre comportamento de throttling da API da Apple Ads, developer.apple.com/documentation/apple_ads, 2024–2026
Ao contrário do Meta Ads ou Google Ads, a Apple Search Ads opera através de uma API totalmente pública e documentada, sem histórico de bans punitivos de contas para uso legítimo da API. A coisa mais próxima de um “conto de advertência” no ecossistema da Apple Ads não é uma história de ban — é a falha silenciosa do pipeline. Profissionais de marketing executando relatórios de alto volume via scripts personalizados ou integrações MCP atingiram os tetos de taxa não documentados da Apple durante reconciliação de fim de mês, causando extrações de dados incompletas que passaram despercebidas até que os dashboards mostrassem curvas de gasto suspeitamente planas. O custo não é uma conta suspensa; é uma semana de decisões tomadas com dados desatualizados. Isso faz da Apple Ads a plataforma de anúncios principal mais segura para conectar via Claude, mas também a que pode fazer você ignorar verificações de integridade de dados por se sentir “seguro”.
A limitação de taxa da Apple é quota-based and communicated dynamically, não baseada em ferramenta. A Apple não bane ou limita contas porque você usou o Claude, um servidor MCP ou um conector de terceiros. Ela limita por causa de how a API foi usada: requisições paralelas em rajada, polling de alta frequência sustentado, ou loops de repetição não autenticados. A API de Gerenciamento de Campanhas da Apple Ads confirma que limites de taxa existem e estão detalhados na documentação, mas a Apple não publica limites numéricos exatos como requisições por minuto, hora ou dia. Em vez disso, a API retorna respostas HTTP 429 padrão com Retry-After headers when limits are exceeded, and developers must implement exponential backoff to recover gracefully. Read-only reporting calls are safe. Aggressive write bursts (e.g., bulk bid changes across thousands of keywords) or parallel polling from multiple services without coordination are not.
As duas formas de esgotar sua cota da Apple Ads
Após revisar documentos oficiais e threads da comunidade, dois padrões aparecem repetidamente.
1. Rajadas de API paralelas sem backoff. Enviar requisições concorrentes de múltiplos scripts, dashboards ou instâncias MCP para o mesmo ID de Organização da Apple Ads pode acionar throttling mesmo se cada chamador individual permanecer dentro de um volume razoável. Os limites de taxa da Apple são aplicados no nível da chave de API ou conta, e os limites não são documentados publicamente. Quando excedidos, a API retorna erros HTTP 429 com Retry-After headers, but tools that don’t implement backoff will retry immediately, amplifying the problem and potentially causing extended lockouts. NEEDS_REVIEW: exact concurrent request threshold before throttling triggers — developer.apple.com/documentation/apple_ads/calling-the-apple-search-ads-api
2. Escritas programáticas em escala sem disciplina de estrutura de campanha. Usar o Claude Code ou scripts para modificar lances, orçamentos ou keywords em massa entre campanhas sem a estrutura semântica recomendada pela Apple leva a padrões de gasto instáveis e confusão algorítmica. A documentação da Apple recomenda limitar ajustes de lance a incrementos de 20% por keyword e estruturar campanhas em torno de no more than 5 tipos de campanha principais (Brand, Category, Competitor, Discovery e Exact Match). Violar esses guardrails estruturais não aciona um ban, mas degrada o desempenho da campanha de formas difíceis de reverter — efetivamente “quebrando” a fase de aprendizado da conta. — developer.apple.com/documentation/apple_ads
3. Expor PII ou dados de atribuição a processamento de terceiros não autorizado. Os dados da Apple Ads incluem identificadores em nível de dispositivo e usuário que se enquadram no framework de privacidade da Apple e regulamentações regionais como o GDPR. Uma análise de 2024–2025 encontrou que 47% dos aplicativos iOS usando SDKs de terceiros arriscados enfrentaram ações de fiscalização relacionadas à exposição de dados. Embora essa estatística se refira a SDKs de aplicativos em vez de uso de API diretamente, o princípio se aplica: canalizar dados de search term ou conversão da Apple Ads através de middleware não auditado, workspaces compartilhados do Claude, ou infraestrutura não SOC-2 cria exposição de conformidade. O risco não é um ban da API da Apple Ads — é uma multa por violação de privacidade ou falha na revisão da App Store. — technologylaw.fkks.com/post/102lxsp/countdown-to-jan-1-2026-mobile-developers-must-adopt-apple-google-apis-to-com
Ambos os comportamentos acionam throttling ou exposição de conformidade, não bans de conta. Se você quer usar o Claude para a Apple Ads com segurança, mantenha-se em consultas de relatórios somente leitura através de um MCP gerenciado como o da Porter, agrupe suas chamadas, e nunca canalize dados brutos de search term através de infraestrutura não auditada.
O protocolo de escalabilidade de 5 regras
Baseado nos limites de taxa e cotas documentados da Apple Ads e nos comportamentos que realmente causaram acesso limitado — não suposições:
- Agrupe suas chamadas de API e respeite o teto de ajuste de lance de 20%. O algoritmo da Apple é sensível a grandes oscilações de lance. Ajuste o lance de uma keyword em no máximo 20% por mudança, depois monitore o desempenho antes de modificações adicionais. Esse número está documentado nas melhores práticas de gerenciamento de campanhas da Apple como o limiar que mantém padrões de gasto estáveis sem reiniciar o algoritmo de aprendizado. — developer.apple.com/documentation/apple_ads
- Estruture campanhas em no more than 5 tipos de campanha principais. A estrutura semântica recomendada pela Apple limita a taxonomia de campanha de nível superior em cinco: Brand, Category, Competitor, Discovery e Exact Match. Exceder isso cria sobreposição, competição interna e tendências de CPA degradadas. Ao consultar via Claude, sempre inclua
campaign_namefilters that map to these five buckets to keep analysis aligned with Apple’s intended architecture. — developer.apple.com/documentation/apple_ads - Limite páginas de produto personalizadas a 35 por aplicativo. A Apple Ads permite associar páginas de produto personalizadas com Creative Sets para personalização em nível de grupo de anúncios. A plataforma suporta até 35 páginas de produto personalizadas por aplicativo. Exceder isso não aciona fiscalização, mas páginas além de 35 são ignoradas pelo sistema de veiculação de anúncios, levando a rotações criativas “quebradas” onde variantes recomendadas pelo Claude nunca são veiculadas. — developer.apple.com/documentation/apple_ads
- Adicione keywords negativas de correspondência exata de suas 3 campanhas principais na Discovery. O tipo de campanha Discovery da Apple é projetado para revelar novos termos de pesquisa, mas pode canibalizar campanhas Brand, Category e Competitor se negativas não forem aplicadas. A regra dos três: extraia suas principais keywords de correspondência exata das campanhas Brand, Category e Competitor e adicione-as como negativas na Discovery. Isso impede pagar por tráfego que você já captura em outro lugar e é a regra única mais eficaz de proteção de orçamento na Apple Ads. — developer.apple.com/documentation/apple_ads
- Verifique as recomendações da Apple Ads diariamente — elas se atualizam uma vez por dia. A API de Recomendações e as sugestões no dashboard se atualizam em um ciclo de 24 horas. Verificar com mais frequência desperdiça chamadas de API e cria falsa urgência. Agende suas consultas de auditoria do Claude para rodarem após a atualização diária da Apple (tipicamente no início da manhã no horário do Pacífico) para garantir que recomendações e dados de desempenho estejam sincronizados. NEEDS_REVIEW: exact UTC/Pacific refresh time for Apple Ads reporting data — developer.apple.com/documentation/apple_ads
O que o MCP da Porter faz de diferente: ele impõe acesso à API somente leitura por padrão, eliminando o risco de tempestades de escrita programáticas. Todas as consultas da Porter à Apple Ads usam os endpoints da API de Relatórios, não os endpoints de escrita da API de Gerenciamento de Campanhas, o que significa que mudanças de lance, ajustes de orçamento e criação de campanhas não podem ser acionados acidentalmente através de prompts do Claude. A Porter também implementa agrupamento de requisições e pooling de conexões por conta, garantindo que consultas paralelas de múltiplos membros da equipe ou relatórios automatizados sejam coalescidas em um único fluxo limitado em vez de rajadas independentes. Esse é o comportamento que os sistemas automatizados da Apple lidam graciosamente — tráfego estável, previsível, somente leitura com backoff adequado — e é por isso que usuários do MCP da Porter não relataram incidentes de throttling mesmo durante fluxos de trabalho de reconciliação de fim de mês de alto volume. Retry-After Perguntas frequentes
O que é um MCP da Apple Ads?
Qual é a diferença entre Claude e Claude Code?
Quão recentes são os dados? É em tempo real?
Existem limites de taxa para dados da Apple Ads?
Por que os números do Claude às vezes diferem do dashboard da Apple Ads?
Usar o Claude afetará meu acesso ou limites da Apple Ads?
Pronto para conversar com sua Apple Ads?
Pronto para conversar com o seu Apple Ads?
Abra o Claude, adicione o conector Porter e faça a sua primeira pergunta. Se ainda não tem a Porter, comece um teste grátis e conecte a sua conta Apple Ads — poderá conversar com as suas campanhas em menos de cinco minutos.
rocket_launch Experimente grátisopen_in_new Agende uma demo