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

Pré-requisitos

• Uma conta do Porter Metrics com sua conta do Pinterest 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 Desktop MCP
• Acesso de administrador ou padrão às contas de anúncios do Pinterest Ads que você deseja conectar

Conectar o Pinterest 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 o Pinterest 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 o Pinterest 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 compatível obtém acesso aos mesmos dados.

A configuração completa leva menos de 5 minutos e se divide em três passos: conecte o Pinterest Ads ao Porter, aponte o Claude para o MCP da Porter, e faça sua primeira pergunta.

1. Conecte seus dados do Pinterest Ads ao Porter

O Porter fica entre a Ads API v5 do Pinterest e o Claude. Ele lida com OAuth, limites de taxa, paginação e toda a infraestrutura para que o Claude só veja dados limpos e estruturados.

Cadastre-se no 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 Pinterest Ads. No Porter, clique em Criar → escolha Claude como destino → selecione Pinterest Ads como fonte → entre com o Pinterest para conceder acesso às suas contas de anúncios.

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

Opcional: habilite o BigQuery storage 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. Uma vez adicionado, o Claude pode consultar dados do Pinterest 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 do Porter e aprove o acesso.

Quando a autorização terminar, você verá as ferramentas somente leitura do 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, veja o tutorial do Porter MCP.

3. Comece a criar perguntas e dashboards

Com o Porter conectado, abra um novo chat no Claude e pergunte qualquer coisa sobre seu Pinterest Ads em inglês simples. O Claude chama o Porter nos bastidores, puxa dados ao vivo do Pinterest, 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 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 Pinterest 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 Pinterest Ads na frente do Claude. As alternativas mais comuns são a API direta do Pinterest Ads (ou seu MCP oficial, se houver), uma ponte ao vivo do Google Sheets, e o BigQuery para escala. Cada uma tem suas contrapartidas — escolha a que se encaixa em como sua equipe já trabalha.

• 🔌 API direta do Pinterest Ads (ou MCP oficial) — Converse diretamente com a Ads API v5 do Pinterest você mesmo, ou instale o MCP nativo do Pinterest Ads se existir. Controle máximo, mas você lida com autenticação, limites de taxa e paginação — e você só obtém uma fonte.
• 📊 Google Sheets — Planilha ao vivo ou upload único 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 grandes contas de anúncios ou agências executando análise de múltiplas contas. O BigQuery agrega; o Claude apenas consulta resumos pré-construídos.

Via API direta do Pinterest Ads (ou MCP oficial)

Se você está construindo um produto em torno do Pinterest Ads — ou é um desenvolvedor que prefere controlar cada camada da integração — o caminho mais direto é conversar com a Ads API v5 do Pinterest você mesmo, ou instalando o MCP oficial do Pinterest Ads (se houver). O Pinterest ainda não oferece 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 do Pinterest e solicitar um Token de Desenvolvedor / acesso à API quando aplicável. De qualquer forma, você pula o Porter inteiramente e chama o Pinterest 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 o Pinterest Ads em uma Planilha, depois deixe o Claude ler a Planilha. Você pode automatizar o pipeline Pinterest Ads → Sheets com o Porter para que ele atualize diariamente, ou fazer exportações pontuais de CSV do Pinterest Ads Manager 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 salva você quando sua conta de anúncios do Pinterest Ads fica séria. Um único anunciante grande ou uma agência gerenciando 10+ contas de anúncios atingirá limites de taxa da API e problemas de latência consultando 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 Pinterest Ads em tabelas do BigQuery em um cronograma, 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 Pinterest Ads, você deixa o BigQuery agregar em tabelas pequenas e otimizadas, e o Claude apenas consulta a saída resumida. Problema de escala resolvido.

Leia o tutorial completo do BigQuery →

Conectando o Pinterest 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 Pinterest Ads seriamente.

O 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.

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 — ele pode construir software real. Scripts persistentes, rotinas agendadas, apps HTML, dashboards internos, integrações que rodam 24/7 sem sua intervenção. Uma vez conectado ao MCP da Porter para o Pinterest 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 deploy, Slack e Gmail para entrega — você não está mais consultando dados. Você está construindo ferramentas.

🛠️ Construa seu próprio app de gestão de orçamento Stack: MCP da Porter + MCP da Vercel (ou Cloudflare Pages, Netlify) Alimente o Claude Code com suas metas e objetivos do Pinterest 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, faz deploy em uma URL. Sem embed do Data Studio para quebrar quando o fornecedor muda o preço, sem restrições de template. O dashboard atualiza automaticamente porque consulta o MCP da Porter em 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: MCP da Porter + MCP do Firecrawl Combine seu próprio desempenho do Pinterest Ads da Porter com páginas de destino de concorrentes e anúncios ao vivo da Meta Ad Library raspados 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ã. Ideal para: equipes internas que precisam de contexto de mercado, não apenas números internos.

📚 Wiki interno de marketing com métricas ao vivo Stack: MCP da Porter + MCP do Airtable (ou MCP do Notion) Use o Airtable ou Notion como esquema, a Porter como fonte de dados. O Claude Code mantém cada página populada com gastos atuais, CPA e ROAS para cada conta de anúncios — sem capturas de tela desatualizadas, sem copiar-colar do Excel. Novos funcionários leem uma entrada de 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 gastos, CTR e quedas de qualidade Stack: MCP da Porter + MCP do Slack (ou MCP do Gmail) Uma rotina do Claude Code em cron puxa o Pinterest Ads via Porter, avalia limites — CTR cai abaixo de 1%, gasto diário dispara 2× a 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 verifica a si mesmo 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 apps, dashboards ao vivo, alertas e ferramentas reais — qualquer coisa que você queira rodar sozinha 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 quando o Pinterest 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 de seus dados do Pinterest Ads — desde perguntas e respostas simples até fluxos de trabalho completos voltados para clientes.

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 do Pinterest Ads Manager. Mas o chat é o básico — os casos de uso interessantes vêm em seguida.

2. Mescle o Pinterest Ads com seus dados de vendas (Stripe, HubSpot, Shopify)

É aqui que uma visão 360° se torna real. Quando você conecta o Pinterest 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 dar a você uma atribuição que nenhum número de plataforma pode.

O Claude lida com o mapeamento e 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 individual pode gerar sozinha.

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

Com o Claude Code você pode transformar o monitoramento do Pinterest 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 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 clientes 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 — populada 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 do Pinterest Ads que você pode consultar com o Claude

Time

Date

Geography

Account CountryCatalog Location

Visibility

Ad Groups Tracking Urls ImpressionCampaigns Tracking Urls ImpressionConfigs Md FrequencyImpressionsImpression 1 GrossImpressions 2Ad User Lifetime FrequencyImpression

Engagement

Ad Click Tracking URLClickthrough 1Clickthrough 1 GrossClickthrough 2Click-through rateEngagement RateEngagement Rate 1Engagement Rate 2

Conversion

ROASConversion Learning Mode TypeConversion TagConversion Tags NameConversion Tags StatusCost Per In-app checkuotAd Form IdOptimization Attribution Window Days

Cost & Bidding

keyword Matching BidAd Group Bid AmountAd Group Bid StrategyAd Group BudgetAd Group Budget TypeCPCCPMCpm In Micro Dollar

Campaign

Camping Daily BudgetCampaing StatusCampaign IdCampaign BudgetCampaign Name

Ad

Ad Group StatusAd Group IdAd Groups Created TimeAd Group End TimeAd Groups NameAd Group Start TimeAd Groups StatusAd Groups Type

Creative

Pin TypePin Title

Audience

Audience TypeAudience DescriptionsAudiences IdAudiences NameAudiences StatusAudiences Type

Placement & Device

Ad Group Placement GroupAd Group Traffic Target Type

Product & Catalog

Catalog TypePin Product Tags

Profile & Contact

Customer Lists Created TimeCustomer Lists IdCustomer Lists NameCustomer Lists StatusCustomer Lists TypeCustomer Lists Updated Time

Keywords & Search

Keyword IdKeyword Typekeyword Matching Type

URLs & Links

Ad Destination URLPin URLEvent Tracking Urls Audience VerificationEvent Tracking Urls Buyable Button

Status & Lifecycle

Ad StatusKeyword ArchivedAd Group Auto Targeting EnabledCampaigns StatusCatalog StatusCatalog Product Group StatusConversion Tags Double Click Integration is EnableConfigs Aem Enabled

IDs & Identifiers

Account IdAdvertiser IdBoard IdBoard Pins IdBoard Sections IdCatalog IdCatalog IdCatalogs Porduct Group Id

Other

Account Created TimeAccount NameAccount Owner NameAccount Updated TimeAd NamePin TextAndroid Deep LinkAd Group Billed Event

User Account

Account AboutAccount Follower CountAccount Pin CountAccount TypeAccount Board CountAccount Business NameAccount Following CountAccount Monthly Views

Pins

Pin Image

Prompts que você pode copiar e colar hoje

1. Para agências

Use estes ao gerenciar múltiplas contas de clientes no Pinterest Ads ou construindo relatórios white-label.

2. Para profissionais de marketing B2B

Use estes ao rastrear geração de leads, inscrições e custo por lead do Pinterest Ads.

3. Para equipes de e-commerce

Use estes ao otimizar Shopping Ads, desempenho de catálogo e valor de checkout.

4. Multicanal

Use estes ao mesclar o Pinterest Ads com outras fontes de marketing em uma conversa.

Limites, segurança e melhores práticas para o Pinterest Ads via Claude

A API do Pinterest não é um ecossistema de “banir primeiro”. O ponto de dor mais comum no mundo real que os profissionais de marketing relatam não é a suspensão da conta — é degradação silenciosa de dados. À medida que bloqueadores de anúncios, restrições de privacidade do iOS e depreciação de cookies reduzem a fidelidade do sinal, as métricas de conversão na API se afastam da verdade absoluta. Um profissional de marketing executando campanhas de Pinterest Shopping pode ver números de ROAS na API que sub-relatam o valor real de checkout em 15–30% comparado ao backend do Shopify, não porque a API está quebrada, mas porque o caminho do sinal (pixel → servidor → API) está incompleto. O custo não é uma conta banida; é orçamento mal alocado baseado em dados incompletos.

A limitação de taxa do Pinterest é quota-based and category-specific, não baseada em ferramenta. O Pinterest não bane ou limita contas porque você usou o Claude ou um conector MCP. Ele limita por causa de como a API foi usada: excedendo o 100 requests per second per user per app teto para requisições padrão da API, ou atingindo limites de escrita específicos por categoria (por exemplo, ads_write scope for promotion updates). O acesso de análise somente leitura via OAuth é seguro e esperado. Envios de eventos de conversão em alta frequência e operações de escrita não em lote não são. Permanecer dentro da cota padrão de requisições e usar escopos somente leitura é tratado com elegância. Rajadas paralelas sem limitação em múltiplos apps ou contas não são.

Os três padrões que levam a relatórios imprecisos do Pinterest Ads

Após revisar documentos oficiais e threads da comunidade, dois padrões aparecem repetidamente.

1. Envios de dados de conversão em alta frequência sem batch. Enviar eventos de conversão em tempo real ou quase tempo real sem agrupamento pode disparar os limites de taxa da Conversions API do Pinterest. Quando limitado, os eventos são descartados ou atrasados, o que degrada silenciosamente a precisão da atribuição. O que fazer em vez disso: agrupar eventos de conversão e implementar backoff exponencial ao receber respostas HTTP 429.

2. Confiar nos dados de conversão reportados pela API como verdade absoluta sem verificação cruzada. As métricas de conversão da API do Pinterest Ads estão sujeitas a perda de sinal de bloqueadores de anúncios, restrições de privacidade do iOS 14.5+ e depreciação de cookies. Uma campanha mostrando um ROAS de 2,5x na API pode estar na verdade em 1,8x quando medida contra dados de checkout de primeira parte. Isso não é um risco de banimento da API — é um risco de qualidade de decisão. O que fazer em vez disso: sempre reconcilie os valores de conversão da API do Pinterest com sua plataforma de e-commerce (Shopify, WooCommerce) ou análise de primeira parte dentro de uma janela de 24–48 horas.

3. Expor PII em chamadas de API ou conectores de terceiros. Os termos da API do Pinterest e as políticas de segurança de marca restringem como os dados do usuário são tratados. Passar listas de e-mails brutas, números de telefone ou IDs de clientes por ferramentas de terceiros não verificadas pode violar as políticas de dados do Pinterest e disparar revisão de acesso. O que fazer em vez disso: use conectores baseados em OAuth que não armazenam ou treinam com seus dados, e garanta que qualquer fluxo de upload de público passe pela API nativa de Customer List do Pinterest com identificadores hasheados.

Ambos os comportamentos disparam limitação ou degradação de qualidade de dados, não bans. Se você quer usar o Claude para o Pinterest Ads com segurança, permaneça dentro de escopos somente leitura, agrupe onde necessário, e verifique dados de conversão cruzados com suas fontes de primeira parte.

O protocolo de 5 regras de melhores práticas

Com base nos limites de taxa e cotas documentados do Pinterest e nos comportamentos que realmente causaram degradação de dados — não suposições:

• Mantenha-se abaixo do limite de 100 req/s. O Pinterest impõe um limite de taxa de 100 requests per second per user per app para requisições padrão da API. Rajadas acima deste limite disparam limitação HTTP 429, que atrasa ou descarta requisições de análise. Se você gerencia várias contas de anúncios, o limite se aplica por app por usuário — não por conta, então consultas simultâneas em várias contas contam para a mesma cota. Consequência se ignorado: extrações de métricas incompletas, dashboards desatualizados e janelas de otimização perdidas. Como o Porter impõe isso: O MCP da Porter agrupa requisições de API e implementa limitação de taxa no lado do cliente com backoff automático.

• Agrupe eventos de conversão; não os transmita em fluxo contínuo. Enviar eventos de conversão individuais conforme acontecem consome cota rapidamente e aumenta o risco de limitação. Consequência se ignorado: eventos de conversão descartados, atribuição degradada e relatórios de ROAS imprecisos. Como o Porter impõe isso: O conector do Pinterest da Porter usa escopos de análise somente leitura por padrão e não envia eventos de conversão, eliminando este risco inteiramente para casos de uso de relatórios.

• Reconcilie dados de conversão em 24–48 horas. As métricas de conversão da API do Pinterest Ads têm uma latência de 24–48 horas para atribuição final. Tomar decisões de orçamento com dados do mesmo dia da API leva a super ou subinvestimento em campanhas. Consequência se ignorado: alocação de orçamento baseada em atribuição incompleta, especialmente para caminhos de conversão multitoque comuns no funil orientado à descoberta do Pinterest. Como o Porter impõe isso: O Porter mostra timestamps de atualização de dados nas respostas de consulta para que os usuários saibam quando as métricas são provisórias.

• Use escopos OAuth somente leitura por padrão. A API do Pinterest requer autenticação OAuth 2.0 com permissões específicas por escopo. Conceder acesso de escrita (ads_write) quando apenas relatórios são necessários aumenta o raio de explosão de qualquer comprometimento de credenciais. Consequência se ignorado: modificações acidentais de campanhas, mudanças de orçamento ou pausas de anúncios se os tokens forem mal manuseados. Como o Porter impõe isso: O MCP da Porter solicita escopos mínimos viáveis — acesso de análise somente leitura por padrão. Nenhuma permissão de escrita é solicitada ou armazenada.

• Nunca passe PII bruta por conectores de terceiros. As políticas de segurança de marca e dados do Pinterest exigem identificadores hasheados ou criptografados para dados de público. Fazer upload de listas de e-mails não hasheadas ou dados de clientes por ferramentas intermediárias viola a política da plataforma. Consequência se ignorado: revisão de acesso, suspensão de conector, ou sinalização de conta de anunciante por violações de tratamento de dados. Como o Porter impõe isso: O MCP da Porter não armazena, cacheia ou treina com dados de clientes. Todos os tokens OAuth são criptografados em repouso e as consultas são efêmeras — nenhum dado persiste na infraestrutura da Porter após a resposta ser entregue.

O que o Porter MCP faz de diferente: ele impõe estas salvaguardas no nível da plataforma. O conector do Pinterest Ads da Porter opera com read-only OAuth scopes by default, as requisições são client-side rate-limited with automatic backoff para permanecer dentro da cota de 100 req/s do Pinterest, e no customer data is stored, cached, or used for model training. Esse é o comportamento que os sistemas automatizados do Pinterest tratam com elegância: tráfego previsível, somente leitura, dentro da cota de um app OAuth verificado.

Perguntas frequentes