Para conectar o Microsoft 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 do Microsoft Ads em linguagem simples.
Uma vez conectado, você pode automatizar a geração de relatórios e a análise do Microsoft Ads — faça perguntas sobre seus dados, crie dashboards, configure alertas ou envie relatórios prontos para o cliente como o abaixo.
Pré-requisitos
- Uma conta da Porter Metrics com sua conta do Microsoft 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 o Claude Code e os recursos MCP do Desktop
- Acesso de administrador ou padrão às contas do Microsoft Ads que você deseja conectar
Conectar o Microsoft 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 Microsoft 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 mecanismos que fazem ferramentas como o Microsoft 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.Quatro motivos pelos quais o MCP vence para o Microsoft Ads:
A configuração completa leva menos de 5 minutos e se divide em três passos: conectar o Microsoft Ads à Porter, apontar o Claude para o MCP da Porter e fazer sua primeira pergunta.
1. Conectar seus dados do Microsoft Ads à Porter
A Porter fica entre a API de Publicidade da Microsoft e o Claude. Ela gerencia 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 da Microsoft. Na Porter, clique em Criar → escolha Claude como destino → selecione Microsoft Ads como fonte → faça login com a Microsoft para conceder acesso às suas contas. Selecione suas contas. Escolha as contas do Microsoft Ads que você deseja que o Claude consulte. Quando você seleciona várias contas em uma única conexão, a Porter mescla automaticamente os dados 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. Uma vez adicionada, o Claude pode consultar dados do Microsoft Ads sob demanda em qualquer conversa.
Vá para claude.ai e clique no + ícone na entrada de chat para abrir o menu de ferramentas.
No menu que abrir, 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 aparecer.
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.
Quando 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 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 Microsoft Ads em linguagem simples. O Claude chama a Porter nos bastidores, puxa dados em tempo real da Microsoft 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 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 Microsoft 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 Microsoft Ads na frente do Claude. As alternativas mais comuns são a API direta do Microsoft Ads (ou seu MCP oficial, 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 Microsoft Ads (ou MCP oficial) — Converse diretamente com a API de Publicidade da Microsoft, ou instale o MCP nativo do Microsoft Ads, se existir. Controle máximo, mas você gerencia auth, 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 grandes ou agências executando análise multiconta. O BigQuery agrega; o Claude consulta apenas resumos pré-construídos.
Via API direta do Microsoft Ads (ou MCP oficial)
Se você está construindo um produto em torno do Microsoft Ads — ou é um desenvolvedor que prefere controlar cada camada da integração — o caminho mais direto é conversar com a Advertising API você mesmo, ou instalando um MCP oficial do Microsoft Ads (se houver). A Microsoft ainda não disponibiliza um MCP oficial para Publicidade, 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 quando aplicável. De qualquer forma, você pula a Porter completamente e chama a Microsoft 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 schema e novas tentativas de erro. E, criticamente, você obtém apenas uma fonte. No momento em que você também quiser Google Ads, GA4 ou Shopify na mesma conversa, você volta a construir (ou costurar) mais integrações. Quando isso faz sentido: equipes de engenharia que precisam de uma única fonte com controle total, produtos que entregam dados do Microsoft Ads como um recurso (onde você já possui a integração de qualquer forma), ou scripts pontuais onde você não se importa de escrever o código de auth e paginação você mesmo. Para profissionais de marketing que querem fazer perguntas em linguagem simples e mesclar o Microsoft Ads com o restante de sua stack em uma única conversa, o caminho do MCP da Porter é drasticamente menos trabalho.Via Google Sheets (planilha ativa 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 o Microsoft Ads em uma planilha e depois deixe o Claude ler a planilha. Você pode automatizar o pipeline Microsoft Ads → Sheets com a Porter para que ele atualize diariamente, ou fazer exportações pontuais de CSV do painel do Microsoft Advertising para análise estática.
A contrapartida a saber. No caminho do MCP, o Claude chama a API da Microsoft diretamente e a Microsoft faz a filtragem e agregação do lado dela — limpo e determinístico. No caminho do Sheets, o Claude agrega dentro da própria planilha, o que pode introduzir alucinações em totais, médias e junções quando você tem milhares de linhas. A vantagem é a velocidade: para intervalos de datas muito grandes ou análise histórica, uma planilha pré-montada é drasticamente mais rápida que chamadas de API ao vivo. Quando isso faz sentido: equipes de finanças que querem revisar os números antes que o Claude atue sobre eles, agências que já entregam relatórios de clientes em Sheets, análise histórica ao longo de anos de dados, ou qualquer caso onde você se importa mais com velocidade do que com atualização em tempo real. Leia o tutorial completo do Sheets →Via Google BigQuery (para escala)
Este é o caminho que a maioria das pessoas ignora — e é o que salva você quando sua conta do Microsoft 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 do Microsoft 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 Microsoft Ads, você deixa o BigQuery agregar em tabelas pequenas e otimizadas, e o Claude consulta apenas a saída resumida. Problema de escala resolvido.
Quando isso faz sentido: contas enterprise com milhões de impressões, agências executando análise multiconta em mais de 10 clientes, ou qualquer equipe que já use o BigQuery como data warehouse. A Porter carrega o Microsoft Ads (e mais de 25 outras fontes) diretamente no BigQuery para que você não precise construir seu próprio ETL. Leia o tutorial completo do BigQuery →Conectar o Microsoft Ads ao Claude Code
A maioria dos profissionais de marketing agrupa Claude e Claude Code juntos 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 seriamente com dados do Microsoft Ads.
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 agendadas, aplicativos HTML, dashboards internos, integrações que rodam 24/7 sem sua intervenção. Uma vez conectado ao MCP da Porter para o Microsoft 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 Microsoft 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 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 MCPCombine seu próprio desempenho do Microsoft Ads da Porter com páginas de destino de concorrentes e anúncios ativos 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 preços deles, com um resumo de LLM sobre o que mudou semana a semana. Roda no 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 interna de marketing com métricas em tempo real
Stack: Porter MCP + Airtable MCP (ou Notion MCP)Use o Airtable ou Notion como schema, a Porter como fonte de dados. O Claude Code mantém cada página preenchida com Spend, Conversions e Ctr atuais 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.
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 spend, Ctr e quedas de qualidade
Stack: Porter MCP + Slack MCP (ou Gmail MCP)Uma rotina do Claude Code no cron puxa dados do Microsoft Ads via Porter, avalia limites — Ctr cai abaixo de 1%, spend diário dispara 2× acima da 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 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 a pergunta. 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 quando o Microsoft 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 Microsoft Ads — de Q&A 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 com 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 a verificação diária do painel do Microsoft Advertising. Mas o chat é o básico — os casos de uso interessantes vêm a seguir.
2. Mesclar o Microsoft Ads com seus dados de receita (Stripe, HubSpot, Shopify)
É aqui que uma visão 360° fica real. Quando você conecta o Microsoft 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 lhe dar atribuição que nenhum número de plataforma pode.
O Claude lida com o mapeamento e as junções de UTMs, nomes de campanhas e timestamps. Você obtém um relatório de atribuição pronto para o cliente que nenhuma plataforma isolada pode gerar sozinha.
3. Alertas e notificações automatizados no Slack ou Gmail
Com o Claude Code, você pode transformar o monitoramento do Microsoft 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 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 prompts de login, apenas o conteúdo.
Campos e métricas do Microsoft Ads que você pode consultar com o Claude
Prompts que você pode copiar e colar hoje
1. Para agências
Use estes quando estiver gerenciando várias contas de clientes e precisar de respostas rápidas e prontas para o cliente.
2. Para profissionais de marketing B2B
Use estes quando estiver executando campanhas de geração de leads e se importar com qualidade, não apenas volume.
3. Para equipes de e-commerce
Use estes quando estiver rastreando Revenue, ROAS e desempenho de campanhas de shopping.
4. Multicanal
Use estes quando quiser comparar o Microsoft Ads contra outros canais pagos em uma única conversa.
Limites, segurança e boas práticas para o Microsoft Ads via Claude
Embora o Microsoft Ads não banir contas por uso legítimo da API, a fiscalização é real e agressiva para violações de política. O risco para profissionais de marketing que usam integrações MCP não é suspensão de conta — é throttling e interrupção de dados. Uma agência de marketing executando relatórios multilocatário por meio de um único registro de aplicativo pode atingir limites de taxa em minutos, fazendo o Claude retornar dados de campanha desatualizados ou incompletos. O custo real não é uma conta banida; é janelas de otimização perdidas e decisões tomadas com dados parciais.
A fiscalização de limites de taxa da Microsoft é baseada em quota e abrangente para a conta, não baseada em ferramenta. A Microsoft não limita contas porque você usou o Claude ou um MCP. Ela limita por causa de como a API foi usada: excedendo 40 consultas por segundo, 60.000 chamadas de método por minuto ou 20.000.000 de chamadas de método por dia. Análise somente leitura dentro desses limites é segura. Tráfego em rajadas, requisições paralelas não agrupadas, ou compartilhar um único registro de aplicativo entre vários locatários não é. Violações persistentes disparam o Error Code 117 (CallRateExceeded), e abuso continuado pode levar a limites de taxa reduzidos ou suspensão temporária do acesso à API em até dois dias úteis.
As duas formas de esgotar sua quota do Microsoft Ads
Após revisar documentos oficiais e tópicos da comunidade, dois padrões aparecem repetidamente.
1. Chamadas de API em rajada excedendo 40 QPS ou 60.000 chamadas de método por minuto. Enviar requisições paralelas não agrupadas para puxar grandes intervalos de datas ou várias contas simultaneamente esgota rapidamente a quota por minuto. A Microsoft retorna o Error Code 117 e impõe uma pausa de 60 segundos. Microsoft Advertising API — Request Method Limits. Use requisições em lote (até 300 itens por lote) e implemente backoff exponencial. 2. Compartilhar um único registro de aplicativo entre várias contas ou locatários do Microsoft Ads. Cada registro de aplicativo é limitado a 25 requisições a cada 20 segundos. Um único aplicativo OAuth atendendo 5+ contas de clientes atingirá esse limite durante as execuções de relatórios matinais, causando falhas em cascata em todas as contas conectadas. Microsoft Advertising API — Request Method Limits. Registre aplicativos separados por locatário ou use o agrupamento multiconta integrado do Microsoft Advertising. 3. Exceder limites de entrada de entidades no direcionamento ou estruturas de campanha. A Microsoft impõe limites rígidos: 250 placements por profile, 100 profiles direcionados por member, e 4.000 postal codes por profile. Tentar fazer upload de listas maiores via API dispara throttling de entrada, trunca dados silenciosamente, ou retorna erros de sucesso parcial que o Claude pode não evidenciar claramente. Microsoft Advertising API — Request Method Limits. Valide contagens de entidades no lado do cliente antes do envio à API e pagine grandes atualizações de direcionamento.Ambos os comportamentos disparam throttling baseado em quota. Se você quiser usar o Claude para Microsoft Ads com segurança, fique dentro dos limites documentados da Microsoft, agrupe suas requisições e isole registros de aplicativo por locatário.
O protocolo de escala de 5 regras
Baseado nos limites de taxa documentados da Microsoft e nos comportamentos que realmente causaram throttling — não em suposições:
- Agrupe suas requisições. A Microsoft conta cada item em um lote como uma chamada de método separada, mas a própria requisição HTTP conta como uma contra seu limite de 40 QPS. Agrupe até 300 operações por requisição para maximizar a vazão. Microsoft Advertising API — Request Method Limits. Ignorar isso esgota sua quota de 60.000 chamadas/minuto 300x mais rápido que o necessário.
- Respeite a pausa de 60 segundos após o Error Code 117. Quando você excede o limite de chamadas por minuto, a Microsoft retorna o Numeric Error Code 117 com instrução explícita para reduzir chamadas por minuto e aguardar 60 segundos antes de tentar novamente. Microsoft Advertising API — Request Method Limits. Tempestades de novas tentativas sem backoff vão escalar o throttling para redução de taxa em nível de conta.
- Não exceda 25 requisições a cada 20 segundos por registro de aplicativo. Este é o limite rígido por aplicativo. Microsoft Advertising API — Request Method Limits. Se você gerencia várias contas do Microsoft Ads pelo Claude, registre aplicativos separados do Azure AD ou use o agrupamento multiconta nativo da Porter para ficar abaixo desse limite.
- Limite entradas de entidades aos limites documentados: 250 placements por profile, 100 profiles por member, 4.000 postal codes por profile. Microsoft Advertising API — Request Method Limits. Exceder isso não dispara um banimento, mas causa truncamento silencioso ou falhas parciais de escrita que deixam campanhas mal configuradas.
- Fique abaixo do limite de 20.000.000 de chamadas de método por dia da conta. Microsoft Advertising API — Request Method Limits. Para contas de alto volume com relatórios por hora, isso se traduz em aproximadamente 833 mil chamadas por hora em média — facilmente excedido com extrações históricas multianuais não otimizadas. O MCP da Porter impõe rastreamento de orçamento diário e avisa antes de consultas com grandes intervalos de datas.
Perguntas frequentes
Um MCP do Microsoft Ads (Model Context Protocol) é um padrão aberto que permite que ferramentas de IA — Claude, Claude Code, ChatGPT, Cursor — se conectem aos seus dados do Microsoft Ads sem integrações personalizadas. O servidor MCP da Porter torna suas campanhas, grupos de anúncios, anúncios, keywords, audiências, orçamentos e metas de conversão disponíveis por meio de uma URL: sem tokens, sem scripts, sem configuração de desenvolvedor.
O Claude é o produto conversacional (web, app, mobile). O Claude Code é uma ferramenta de desenvolvedor baseada em terminal que pode escrever scripts, salvar arquivos e automatizar fluxos de trabalho. Ambos podem se conectar ao Microsoft Ads via MCP.
A Microsoft não publica um intervalo oficial de atualização para dados de relatórios. A maioria das métricas de desempenho atualiza em minutos até algumas horas, embora o timing exato varie por tipo de relatório. O MCP da Porter puxa dados ao vivo, então seus dados estão sempre dentro da janela atual da API.
Sim. A Microsoft impõe 40 consultas por segundo, 60.000 chamadas de método por minuto, 20.000.000 por dia e 25 requisições a cada 20 segundos por registro de aplicativo. O MCP da Porter agrupa requisições automaticamente (até 300 operações por lote) e implementa backoff exponencial, então você raramente os atinge.
Três motivos comuns: (1) Timing de sincronização de dados — a interface e a API podem não atualizar simultaneamente, causando discrepâncias temporárias. (2) Métodos de agregação de dados — o painel pode aplicar técnicas ou filtros de agregação diferentes dos que a API retorna. (3) Limitações da API — a API pode não expor todos os dados que a interface mostra, como certas métricas estimadas ou modeladas. A solução: compare o mesmo intervalo de datas, fuso horário e janela de atribuição em ambos os lugares.
Não. A Microsoft não bane ou restringe contas por uso legítimo da API, e o MCP da Porter é somente leitura por padrão — ele permanece bem dentro dos limites normais de taxa da Microsoft. O que observar é throttling por tráfego em rajada ou compartilhar um único registro de aplicativo entre vários locatários — veja a seção de limites acima.
Pronto para conversar com o seu Microsoft Ads?
Abra o Claude, adicione o conector da Porter e faça a sua primeira pergunta. Se você ainda não tem a Porter, comece um teste gratuito e conecte a sua conta Microsoft Ads — você estará a conversar com as suas campanhas em menos de cinco minutos.
rocket_launch Experimente grátisopen_in_new Abra o Claude