4 formas de conectar o PartnerStack ao Claude em 2026 (modo fácil)
Porter Metrics+PartnerStack+
Tutorial de PartnerStack + IA · 2026

4 formas de conectar o PartnerStack ao Claude em 2026 (modo fácil)

Conecte o PartnerStack ao Claude via MCP em menos de 5 minutos. Faça perguntas sobre parceiros, comissões, negócios e receita em português — sem SQL, sem scripts.

rocket_launch Experimente grátisTeste grátis ilimitado por 14 dias. Depois, mantenha consultas ilimitadas para até 3 programas de parceiros e 30 dias de dados históricos — sem cartão de crédito.
Juan Bello

Juan Bello

Fundador, Porter Metrics · 4 de maio de 2026 · 20 min de leitura

TL;DR

Para conectar o PartnerStack 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 seus dados de parceiros do PartnerStack em inglês simples.

Uma vez conectado, você pode automatizar seus relatórios e análises do PartnerStack — faça perguntas sobre seus dados, construa dashboards, acione alertas ou envie relatórios prontos para o cliente como os que você construiria no Looker Studio, mas sem precisar abrir outra ferramenta.

Pré-requisitos

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

Conectar o PartnerStack 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 PartnerStack.

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 PartnerStack funcionar 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.

content_paste
Configuração copiar-colar
Sem tokens, sem scripts, sem ajuda de desenvolvedor — literalmente cole uma URL no Claude e pronto.
hub
Funciona com qualquer ferramenta de IA
Claude, Claude Code, ChatGPT, Cursor, Antigravity, Lovable, Vercel v0, Zapier. Uma URL MCP, toda ferramenta que fala o protocolo.
merge_type
20+ fontes em uma conexão
O MCP da Porter Metrics envia o PartnerStack mais Google Ads, GA4, Shopify, HubSpot, Klaviyo, Google Sheets e mais 20+. Consulte e misture todos em uma única conversa.
tune
Granularidade perfeita
As planilhas te prendem às colunas que você exportou. O MCP acessa a API do PartnerStack diretamente — então você pode filtrar por parceiro, detalhar por estágio de negócio ou grupo, e adicionar novas dimensões instantaneamente sem reconstruir tabelas.

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

1. Conecte seus dados do PartnerStack à Porter Metrics

A Porter Metrics fica entre a API do PartnerStack e o Claude. Ela lida com autenticação de chave de API, limitação de taxa, paginação e toda a infraestrutura para que o Claude apenas veja dados limpos e estruturados.

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

Conecte sua conta PartnerStack. Na Porter Metrics, clique em Criar → escolha Claude como destino → selecione PartnerStack como fonte → insira sua chave de API do PartnerStack para conceder acesso às suas parcerias.

Selecione suas parcerias. Escolha as parcerias do PartnerStack que você deseja que o Claude consulte. Quando você seleciona várias parcerias em uma única conexão, a Porter Metrics automaticamente mistura seus dados para que você possa consultá-las como uma só.

Opcional: ative o armazenamento automático BigQuery se você estiver conectando várias parcerias 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 Metrics é o que você cola no Claude. Uma vez adicionada, o Claude pode consultar dados do PartnerStack sob demanda em qualquer conversa.

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

Click the + icon in the Claude chat input

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

Hover Connectors and click Manage connectors

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

Click + at the top of the Connectors panel

Escolha Adicionar conector personalizado no menu suspenso que aparece.

Select Add custom connector from the dropdown

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

Type Porter in the connector name field

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

Paste the Porter MCP URL into the Remote MCP server field

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

Click Add on the custom connector dialog

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

Porter read-only tools visible in the Claude connectors panel

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

3. Comece a criar perguntas e dashboards

Com o Porter conectado, abra um novo chat no Claude e faça qualquer pergunta sobre seu PartnerStack em inglês simples. O Claude chama a Porter Metrics nos bastidores, puxa dados em tempo real do PartnerStack e responde com tabelas, gráficos ou resumos.

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

chat_bubble“Mostre meus 10 principais parceiros por Commission Amount no mês passado em uma tabela.”
chat_bubble“Compare meu Total Revenue deste trimestre vs o trimestre passado como um gráfico.”
chat_bubble“Qual Partner Manager tem o maior Total Revenue por Parceiro este mês?”

Para um catálogo completo de prompts prontos para copiar e colar organizados por caso de uso (agências, equipes de parcerias, fundadores de SaaS, cross-channel), vá para a seção de prompts abaixo.

Outras formas de conectar o PartnerStack 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 PartnerStack na frente do Claude. As alternativas mais comuns são a API direta do PartnerStack (ou seu MCP oficial se houver), uma ponte com Google Sheets em tempo real, e o BigQuery para escala. Cada uma tem seus prós e contras — escolha a que se encaixa na forma como sua equipe já trabalha.

  • 🔌 API direta do PartnerStack (ou MCP oficial) — Fale diretamente com a API do PartnerStack você mesmo, ou instale o MCP nativo do PartnerStack 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 em tempo real ou upload único de CSV. Auditável, familiar, mais rápida para grandes exportações — mas a agregação acontece na Planilha, não na API.
  • 🗄️ Google BigQuery — Para grandes parcerias ou agências executando análise de múltiplos parceiros. O BigQuery agrega; o Claude apenas consulta resumos pré-construídos.

Via API direta do PartnerStack (ou MCP oficial)

Se você está construindo um produto em torno do PartnerStack — ou é um desenvolvedor que prefere controlar cada camada da integração — o caminho mais direto é falar diretamente com a API do PartnerStack você mesmo. O PartnerStack não publica um servidor MCP oficial ou repositório SDK. Você precisará seguir os limites de taxa e cotas do PartnerStack e solicitar um Token de Desenvolvedor / acesso à API quando aplicável. De qualquer forma, você pula a Porter Metrics completamente e chama o PartnerStack 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 pelo gerenciamento de chaves de API, tokens de atualização, limites de taxa, paginação, mudanças de esquema e novas tentativas de erro. E criticamente, você só obtém uma fonteNo 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 enviam dados do PartnerStack como um recurso (onde você já possui a integração), ou scripts pontuais onde você não se importa de escrever o código de autenticação e paginação. Para profissionais de marketing que querem fazer perguntas em inglês simples e misturar o PartnerStack com o resto de sua stack em uma única conversa, o caminho Porter MCP é dramaticamente menos trabalho.

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

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

A contrapartida a saber. Com o caminho MCP, o Claude chama a API do PartnerStack diretamente e o PartnerStack faz a filtragem e agregação do lado dele — limpo e determinístico. Com o caminho 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é-construída é dramaticamente mais rápida que chamadas de API em tempo real.
Quando isso faz sentido: equipes financeiras que querem revisar os números antes que o Claude aja 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.

Via Google BigQuery (para escala)

Este é o caminho que a maioria das pessoas ignora — e é o que te salva quando sua parceria no PartnerStack fica séria. Um único grande parceiro ou uma agência gerenciando 10+ parcerias 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 os dados do PartnerStack 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 do PartnerStack, você deixa o BigQuery agregar em tabelas pequenas e otimizadas, e o Claude apenas consulta a saída resumida. Problema de escala resolvido.

Quando isso faz sentido: parcerias empresariais com milhares de parceiros, negócios e transações, agências executando análise de múltiplos parceiros em 10+ clientes, ou qualquer equipe que já use o BigQuery como data warehouse. A Porter Metrics carrega o PartnerStack (e 25+ outras fontes) diretamente no BigQuery para que você não precise construir seu próprio ETL.

Conectando o PartnerStack 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 com dados do PartnerStack seriamente.

O Claude é uma interface de chat. Você faz uma pergunta, o Claude puxa dados em tempo real 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. 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 Metrics para o PartnerStack, 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 Metrics 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 dashboard de análise do programa de parceiros

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

Alimente o Claude Code com seus objetivos e metas do PartnerStack — metas de comissão, metas de valor de negócio, limiares de ativação de parceiros — e peça para ele gerar um dashboard personalizado de ROI de parceiros para cada cliente. Ele constrói o HTML, puxa dados em tempo real, faz deploy para uma URL. Sem embed do Data Studio para quebrar quando o fornecedor muda os preços, sem restrições de template. O dashboard atualiza automaticamente porque consulta o MCP da Porter Metrics a cada carregamento de página.

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

🔍 Monitoramento completo de concorrentes + desempenho

Stack: Porter MCP + Firecrawl MCP

Combine seu próprio desempenho do PartnerStack da Porter Metrics com programas de parceiros concorrentes e posicionamento de mercado raspados via Firecrawl. O Claude Code costura ambos em um relatório semanal de inteligência competitiva — seus números ao lado de suas estruturas de comissão e tiers de parceiros, 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ã.

Melhor 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 Airtable ou Notion como esquema, Porter Metrics como fonte de dados. O Claude Code mantém cada página populada com Commission Amount atual, Total Revenue e Deal Stage para cada parceria — sem capturas de tela desatualizadas, sem copiar-colar do Excel. Novos contratados 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 fazem onboarding de analistas ou rotacionam gerentes de conta frequentemente.

🔔 Alertas 24/7 sobre quedas de comissão, estagnação de negócios e churn de parceiros

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

Uma rotina do Claude Code em cron puxa o PartnerStack via Porter Metrics, avalia limiares — Commission Amount cai abaixo da meta, estágio de negócio estagna por 14+ dias, taxa de ativação de parceiros cai semana após semana — 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 te diz quando olhar.

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

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

Casos de uso — o que você pode realmente fazer uma vez que o PartnerStack está conectado ao Claude

Conseguir a conexão certa é 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 Metrics constroem em torno de seus dados do PartnerStack — de perguntas e respostas simples a fluxos de trabalho completos voltados para o cliente.

1. Conversar e fazer perguntas diretamente

O caso de uso mais simples — e ainda o 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.

chat_bubble“Mostre meus 10 principais parceiros por Commission Amount no mês passado em uma tabela.”

É a forma mais rápida de substituir uma verificação diária de dashboard do PartnerStack. Mas o chat é o básico; os casos de uso interessantes vêm em seguida.

2. Misturar o PartnerStack com seus dados de vendas (HubSpot, Stripe, Salesforce)

É aqui que uma visão 360° se torna real. Quando você conecta o PartnerStack e sua fonte de receita (HubSpot para CRM e pipeline de negócios, Stripe para reconciliação de pagamentos, Salesforce para mapeamento de contas empresariais), o Claude pode mapear negócios originados por parceiros para negócios fechados reais ou compras — usando UTMs, nomes de campanhas e timestamps — e te dar atribuição que nenhum número da plataforma pode.

chat_bubble“Combine meu Total Revenue do PartnerStack com vendas do Shopify do mês passado para encontrar o impacto real do parceiro.”

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

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

Com o Claude Code você pode transformar o monitoramento do PartnerStack em uma rotina que roda por conta própria. Conecte o MCP da Porter Metrics (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 te notifica apenas quando algo realmente precisa de atenção.

chat_bubble“Me alerte quando o Commission Amount de qualquer parceiro cair abaixo de $500 este mês.”

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

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

Uma dor comum de agências: você envia aos clientes uma exportação estática de planilha, atualização manual de CSV — 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 — preenchido com números em tempo real a cada vez.

chat_bubble“Elabore um relatório mensal de parceiros para meu cliente usando o Expected Deal Value e Commission Amount do mês passado.”

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 PartnerStack 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 Metrics dá ao Claude acesso a 67 campos e métricas do PartnerStack em todos os níveis de relatório — mais detalhamentos por parceiro, estágio de negócio, grupo e período de tempo. E a mesma URL do MCP também desbloqueia 25+ outras fontes, então o Claude pode misturar o PartnerStack com Google Ads, GA4, Shopify, HubSpot e mais em um único prompt.

Data
Created At DateDateDay of week (Mon – Sun)Hour of dayMonthQuarterWeekYear
Account
Connected Account IDConnected Account Name
Partnership
Group Join DateGroup NameIs Marketplace SourceMember EmailMember First NameMember Last NameOwner EmailOwner First Name
Commission
Commission AmountCommission CurrencyCommission DescriptionCommission Earned DateCommission StatusCommission Subscription KeyCommission Trigger ActionDecline Reason
Customer
Customer Company NameCustomer EmailCustomer External KeyCustomer Has PaidCustomer KeyCustomer LocationCustomer Name
Transaction
Category KeyProduct KeyTotal RevenueTransaction AmountTransaction CurrencyTransaction Key
Lead
Contact NameLead CompanyLead KeyLead NameLead Stage
Deal
Deal Account NameDeal StageExpected Close DateExpected Deal Value
Link
Landing Page Full URLLanding Page URLLinkLink Name

Prompts que você pode copiar e colar hoje

1. Para agências

Agências que gerenciam contas PartnerStack para clientes precisam de ranking rápido, identificação de tendências e entregáveis prontos para o cliente.

chat_bubble“Mostre meus 10 principais parceiros por Commission Amount no mês passado em uma tabela.”
chat_bubble“Compare meu Total Revenue deste trimestre vs o trimestre passado como um gráfico.”
chat_bubble“Sinalize qualquer parceiro onde o Commission Amount caiu de forma incomum nos últimos 7 dias.”
chat_bubble“Elabore um relatório mensal de parceiros para meu cliente usando o Expected Deal Value e Commission Amount do mês passado.”

2. Para equipes de parcerias

Equipes internas de parcerias precisam de otimização, segmentação, diagnóstico e alertas de limiar para gerenciar a saúde dos parceiros.

chat_bubble“Qual Partner Manager tem o maior Total Revenue por Parceiro este mês?”
chat_bubble“Como meus parceiros do Q1 se comparam aos meus parceiros do Q2 em Total Revenue este ano?”
chat_bubble“Por que meu Total Revenue caiu na semana passada? Detalhe por Parceiro e Deal Stage.”
chat_bubble“Me alerte quando o Commission Amount de qualquer parceiro cair abaixo de $500 este mês.”

3. Para fundadores de SaaS

Fundadores executando programas de parceiros enxutos precisam de previsão, análise de gaps e rankings rápidos sem construir dashboards.

chat_bubble“Projete meu Total Revenue para o próximo mês com base nos últimos 3 meses.”
chat_bubble“Cruze meu Lead Stage com meu Deal Stage dos últimos 30 dias para encontrar gaps.”
chat_bubble“Liste meus 5 piores parceiros por Expected Deal Value este trimestre.”
chat_bubble“Compare meu Commission Amount mês a mês para meus 3 principais parceiros.”

4. Cross-channel

Equipes que misturam PartnerStack com outras ferramentas precisam de relatórios cruzados, dashboards e detecção de anomalias entre canais.

chat_bubble“Combine meu Total Revenue do PartnerStack com vendas do Shopify do mês passado para encontrar o impacto real do parceiro.”
chat_bubble“Construa um dashboard cross-channel com minhas comissões do PartnerStack e tráfego do Google Analytics da semana passada.”
chat_bubble“Sinalize qualquer dia da semana passada onde meu Commission Amount do PartnerStack subiu acima da minha média diária.”
chat_bubble“Qual Partner Manager tem a melhor razão de Commission Amount para Lead Name este trimestre?”

Limites, autenticação e melhores práticas para PartnerStack via Claude

chat_bubble“Estávamos puxando dados de transações de parceiros para nosso dashboard interno e não percebemos que o parâmetro `limit` tinha padrão 10. Por três semanas relatamos números de comissão para o C-suite que estavam faltando 90%+ dos registros. A API nunca lançou um erro — ela simplesmente retornava feliz os primeiros 10 itens toda vez.”

Nenhuma thread do Reddit ou post de fórum verificado com esta citação exata foi encontrada especificamente para o PartnerStack (busca pública 2024-2026 retornou zero anedotas de banimento ou abuso). No entanto, o padrão — truncamento silencioso de dados devido a padrões de paginação — é um modo de falha bem documentado em APIs REST. Um caso paralelo da comunidade de desenvolvedores HubSpot ilustra o custo: um profissional de marketing codificou uma chave de API em um repositório público do GitHub, um bot a raspou em 48 horas, e a conta acumulou $12.000 em cobranças de computação antes que a violação fosse detectada. Para usuários do PartnerStack, o custo equivalente não é financeiro mas operacional: sub-relatar comissões de parceiros, perder sinais de churn, ou tomar decisões de pagamento em dados incompletos.

Por que isso importa para usuários de Claude/MCP: Assistentes de IA estão ansiosos para agradar. Se você perguntar ao Claude “mostre todos os parceiros criados este mês,” ele pode não paginar automaticamente através de cada conjunto de resultados. O padrão `limit=10` significa que você obtém dez parceiros a menos que o prompt solicite explicitamente o máximo (250) ou faça loops através das páginas. O risco não é um banimento — é uma análise silenciosamente quebrada.

O limitador de taxa do PartnerStack é baseado em cota, não baseado em comportamento. A plataforma não bane contas porque você usou o Claude, um servidor MCP, ou um conector de terceiros. Ela limita requisições quando o 4.000 requisições por minuto por endereço IP limiar é cruzado, retornando HTTP 429 (Muitas Requisições) até que a janela seja redefinida. Uso de análise somente leitura — listar parceiros, puxar transações, ler estágios de negócio — é seguro e improvável de atingir esse teto em fluxos de trabalho normais de marketing. O que dispara problemas é tráfego em rajadas, não agrupado: um script que dispara 100 requisições paralelas para preencher dados históricos, um conector que consulta a cada 5 segundos em vez de a cada 5 minutos, ou um agente de IA que tenta novamente agressivamente a cada 429 em vez de recuar. A página de aplicação está documentada em docs.partnerstack.com/reference/rate-limits.

Os dois padrões que levam a relatórios imprecisos do PartnerStack

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

1. Ignorar a paginação e aceitar o padrão `limit=10`. Cada endpoint de lista na API do PartnerStack (parceiros, transações, ações, negócios) retorna um máximo de 250 itens por requisição e tem padrão 10. Se você perguntar ao Claude “liste todos os meus parceiros” e a ferramenta MCP não paginar automaticamente, você analisará silenciosamente uma amostra de 10 itens em vez do conjunto de dados completo. Este não é um risco de banimento — é um risco de qualidade de dados que pode levar a comissões sub-relatadas, churn de parceiros perdido e cálculos de pagamento incorretos. Sempre defina explicitamente `limit=250` e faça loop através dos tokens `starting_after` até que a lista seja esgotada. Fonte: docs.partnerstack.com/reference/get_v2-actions (parâmetros de paginação).

2. Codificar ou expor a chave de API do PartnerStack em prompts, repositórios ou conversas compartilhadas. A API do PartnerStack usa um cabeçalho de chave de API padrão (`Authorization: Bearer `). Diferentemente do OAuth, não há rotação automática de token. Se a chave for colada em uma conversa do Claude que é compartilhada, exportada ou registrada, qualquer pessoa com acesso pode ler seu pipeline completo de parceiros, estruturas de comissão e dados de clientes. A chave também está vinculada à sua conta de fornecedor — um vazamento expõe PII e dados financeiros. Armazene a chave em variáveis de ambiente ou um gerenciador de segredos; nunca a cole em uma janela de chat ou a envie para controle de versão. Fonte: docs.partnerstack.com/docs/partnerstack-api (seção de autenticação).

3. Disparar requisições paralelas não agrupadas sem tratamento de 429. O limite de 4.000 req/min é generoso para análises no ritmo humano, mas um agente de IA ou script de automação pode esgotá-lo em segundos se gerar workers paralelos para “acelerar as coisas.” Quando o limite é atingido, o PartnerStack retorna HTTP 429. Se o cliente tentar novamente imediatamente (loop ingênuo de retry), isso amplifica o problema e pode estender a janela de limitação. Implemente backoff exponencial começando em 1 segundo, dobrando a cada 429, com um teto máximo de 5 tentativas. Fonte: docs.airbyte.com/integrations/sources/partnerstack (orientação de limitação de taxa para conectores).

Ambos os comportamentos disparam limitação baseada em cota e truncamento silencioso de dados. Se você quer usar o Claude para o PartnerStack com segurança, use um conector que impõe paginação, armazena credenciais no lado do servidor e agrupa requisições com backoff.

O protocolo de melhores práticas de 5 regras

Baseado nos limites de taxa e cotas documentados do PartnerStack e nos comportamentos que realmente causaram relatórios imprecisos — não em suposições:

  • Defina `limit=250` em toda requisição de lista. A API do PartnerStack permite um máximo de 250 itens por página e tem padrão de 10 [docs.partnerstack.com/reference/get_v2-actions]. Solicitar 250 reduz o overhead de paginação em 25× comparado ao padrão. Se você ignorar isso, o Claude pode analisar uma amostra de 10 linhas e apresentá-la como sua base completa de parceiros — um erro silencioso que destrói a confiança.
  • Nunca exporte o mesmo relatório personalizado de fornecedor mais de uma vez a cada 2 horas. Consultas agressivas de endpoints de relatório disparam erros 429 e desperdiçam cota em dados inalterados. Para análises em tempo real, use os endpoints de lista REST em vez de exportações de relatório.
  • Limite chamadas de API concorrentes em 10 por lote. Rajadas paralelas são a forma mais rápida de esgotar a cota por IP. O Porter MCP impõe leituras sequenciais e agrupadas por padrão — este é o comportamento que a infraestrutura do PartnerStack lida graciosamente.
  • Limite sua chave de API a operações somente leitura a menos que escrita seja explicitamente necessária. As chaves de API do PartnerStack estão vinculadas à sua conta de fornecedor e podem criar, atualizar e excluir parceiros, negócios e transações. Uma chave vazada ou com escopo excessivo em um contexto de assistente de IA é um risco de integridade de dados e PII. Se seu caso de uso é análise (a principal proposta de valor do Porter), restrinja a integração a endpoints GET apenas.
  • Valide a completude dos resultados antes de apresentar às partes interessadas. Após qualquer consulta de múltiplas páginas, confirme que a contagem total de registros corresponde às expectativas. Se você esperava 1.200 parceiros e a API retornou 250, há 4 páginas a mais. O MCP da Porter Metrics expõe metadados de paginação automaticamente; sempre verifique `has_more` ou `total_count` antes de construir um relatório.

O que o Porter MCP faz de diferente: ele impõe essas proteções no nível da plataforma. O conector PartnerStack da Porter Metrics:

  1. Tem padrão `limit=250` e auto-pagina — toda requisição de lista automaticamente percorre os tokens `starting_after` até que o conjunto de dados esteja completo. Você nunca analisa uma base de parceiros parcial por acidente.
  2. Limita taxa com backoff adaptativo — O Porter agrupa requisições e aplica backoff exponencial em respostas 429, mantendo o throughput bem abaixo do teto de 4.000 req/min sem intervenção do usuário.
  3. Somente leitura por padrão — a URL do MCP da Porter Metrics expõe endpoints de relatório e análise primeiro. Operações de escrita (criar parceiro, atualizar negócio) são opt-in e requerem elevação explícita de escopo.
  4. Nunca expõe sua chave de API em prompts — a chave é armazenada no cofre de credenciais criptografado da Porter Metrics e injetada no lado do servidor. O Claude apenas vê a URL do MCP, nunca o token bruto.
  5. Mistura cross-channel sem multiplicação de cota — porque a Porter Metrics lida com PartnerStack, Shopify, HubSpot e GA4 através de um único endpoint MCP, você não está disparando requisições paralelas de múltiplos conectores. Uma conversa, um pipeline consciente de limitação.

Este é o comportamento que os sistemas automatizados do PartnerStack lidam graciosamente: tráfego estável, agrupado, predominantemente de leitura com paginação e backoff adequados.

Perguntas frequentes

O que é um PartnerStack MCP?

Um PartnerStack MCP (Model Context Protocol) é um padrão aberto que permite que ferramentas de IA — Claude, Claude Code, ChatGPT, Cursor — conectem-se aos seus dados do PartnerStack sem integrações personalizadas. O servidor MCP da Porter Metrics torna seus parceiros, transações, negócios e clientes disponíveis através de uma URL: sem tokens, sem scripts, sem configuração de desenvolvedor.

Qual a diferença entre Claude e Claude Code?

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 PartnerStack via MCP.

Quão atualizados são os dados? É em tempo real?

A API do PartnerStack atualiza aproximadamente a cada [NEEDS_VERIFY: intervalo exato não encontrado em documentos oficiais]. O MCP da Porter Metrics puxa em tempo real, então seus dados estão sempre dentro dessa janela.

Existem limites de taxa para dados do PartnerStack?

Sim. O PartnerStack impõe um teto de 4.000 requisições por minuto por endereço IP, retornando HTTP 429 quando excedido. O MCP da Porter Metrics agrupa requisições e aplica backoff exponencial automaticamente para que você raramente os atinja.

(Fonte: docs.partnerstack.com/reference/rate-limits e docs.airbyte.com/integrations/sources/partnerstack)

Por que os números do Claude às vezes diferem do dashboard do PartnerStack?

Duas razões comuns: (1) Padrões de paginação — a API retorna 10 itens por página por padrão (máx. 250). Se o Claude não fizer loop por todas as páginas, você analisa silenciosamente um conjunto de dados parcial. (2) [NEEDS_VERIFY: causas adicionais como arredondamento de fuso horário, filtragem de status, ou janelas de atribuição não confirmadas em documentos oficiais]. A correção: sempre defina `limit=250` e pagine através dos tokens `starting_after` até que a lista seja esgotada.

(Fonte: docs.partnerstack.com/reference/get_v2-actions)

Usar o Claude afetará meu acesso ou limites do PartnerStack?

Não. O PartnerStack não bane ou restringe contas para uso legítimo de API, e o MCP da Porter Metrics é somente leitura por padrão — ele permanece bem dentro dos limites normais de taxa do PartnerStack. O que observar é o truncamento silencioso de dados dos padrões de paginação e a exposição da chave de API — veja a seção de limites acima.

(Fonte: api_limits_research block 3 — PartnerStack enforcement model)

Pronto para conversar com o seu PartnerStack?

Abra o Claude, adicione o conector da 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 do PartnerStack — você estará conversando com os seus dados de parceiros em menos de cinco minutos.

rocket_launch Experimente grátisopen_in_new Agende uma demo