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

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

Aprenda a conectar o HubSpot ao Claude via MCP em menos de 5 minutos — com alternativas para Sheets, BigQuery e API direta.

rocket_launch Experimente grátisTeste grátis ilimitado por 14 dias. Depois, mantenha consultas ilimitadas para até 3 portais 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 · 27 min de leitura

TL;DR

Para conectar o HubSpot 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 os dados do seu CRM HubSpot em inglês simples.

Uma vez conectado, você pode automatizar seus relatórios e análises do HubSpot — 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 Porter Metrics com sua conta HubSpot conectada (o plano gratuito é suficiente para testar de ponta a ponta)
  • Uma conta Claude — o plano gratuito funciona para o Claude Web; uma assinatura Pro é necessária para os recursos Claude Code e Desktop MCP
  • Acesso de administrador ou padrão às contas HubSpot que você deseja conectar

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

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 HubSpot 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 por copiar e colar
Sem tokens, sem scripts, sem ajuda de desenvolvedor — literalmente cole uma URL no Claude e pronto.
hub
Funciona com toda 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 envia HubSpot mais Google Ads, GA4, Shopify, HubSpot, Klaviyo, Google Sheets e mais de 20 outras. Consulte e combine todas elas em uma única conversa.
tune
Granularidade perfeita
Planilhas te prendem às colunas que você exportou. O MCP acessa a API do HubSpot diretamente — então você pode filtrar por estágio do ciclo de vida do contato, detalhar por estágio do negócio ou indústria da empresa, e adicionar novas dimensões instantaneamente sem reconstruir tabelas.

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

1. Conecte seus dados do HubSpot à Porter

A Porter fica entre a API de CRM do HubSpot e o Claude. Ela lida com OAuth, limitação de taxa, paginação e toda a infraestrutura para que o Claude sempre 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 HubSpot. Na Porter, clique em Criar → escolha Claude como destino → selecione HubSpot como fonte → faça login com o HubSpot para conceder acesso às suas contas.

Selecione suas contas. Escolha as contas HubSpot 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ó.

Opcional: 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 do HubSpot 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.

src=”https://portermetrics.com/wp-content/uploads/2026/04/porter-mcp-claude-v2-step-1.webp” alt=”Clique no ícone + no campo de entrada do chat do Claude”

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

src=”https://portermetrics.com/wp-content/uploads/2026/04/porter-mcp-claude-v2-step-2.webp” alt=”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.

src=”https://portermetrics.com/wp-content/uploads/2026/04/porter-mcp-claude-v2-step-3.webp” alt=”Clique no + no topo do painel de Conectores”

Escolha Adicionar conector personalizado no menu suspenso que aparece.

src=”https://portermetrics.com/wp-content/uploads/2026/04/porter-mcp-claude-v2-step-4.webp” alt=”Selecione Adicionar conector personalizado no menu suspenso”

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

src=”https://portermetrics.com/wp-content/uploads/2026/04/porter-mcp-claude-v2-step-5.webp” alt=”Digite Porter no campo de nome do conector”

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

src=”https://portermetrics.com/wp-content/uploads/2026/04/porter-mcp-claude-v2-step-6.webp” alt=”Cole a URL do MCP da Porter no campo de servidor MCP remoto”

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 e aprove o acesso.

src=”https://portermetrics.com/wp-content/uploads/2026/04/porter-mcp-claude-v2-step-7.webp” alt=”Clique em Adicionar na caixa de diálogo do conector personalizado”

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.

src=”https://portermetrics.com/wp-content/uploads/2026/04/porter-mcp-claude-v2-step-8.webp” alt=”Ferramentas somente leitura da Porter visíveis no painel de conectores do Claude”

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

3. Comece a criar perguntas e dashboards

Com a Porter conectada, abra um novo chat no Claude e pergunte qualquer coisa sobre seu HubSpot em inglês simples. O Claude chama a Porter nos bastidores, obtém dados ao vivo do HubSpot 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 negócios por valor do negócio fechando neste trimestre.”
chat_bubble“Liste contatos que não foram contatados há 30 dias e não têm negócios abertos.”
chat_bubble“Resuma meu desempenho de e-mail marketing do mês passado.”

Para um catálogo completo de prompts prontos para copiar e colar organizados por caso de uso (agências, profissionais de marketing B2B, equipes de vendas, multicanal), vá para a seção de prompts abaixo.

Outras formas de conectar o HubSpot 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 HubSpot na frente do Claude. As alternativas mais comuns são a API direta do HubSpot (ou seu MCP oficial, se houver), uma ponte via 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 do HubSpot (ou MCP oficial) — Converse com a CRM API do HubSpot você mesmo, ou instale o MCP oficial do HubSpot 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 multiconta. O BigQuery agrega; o Claude só consulta resumos pré-construídos.

Via API direta do HubSpot (ou MCP oficial)

Se você está construindo um produto em torno do HubSpot — ou é um desenvolvedor que prefere controlar cada camada da integração — o caminho mais direto é conversar com a CRM API do HubSpot você mesmo, ou instalar o MCP oficial do HubSpot. O HubSpot oferece tanto um Conector Nativo oficial para o Claude quanto um Servidor MCP oficial. O Conector Nativo é o caminho mais fácil para a maioria dos usuários; o Servidor MCP dá mais controle aos desenvolvedores. Você precisará seguir os limites de taxa e cotas do HubSpot e solicitar um Token de Desenvolvedor / acesso à API quando aplicável. De qualquer forma, você pula a Porter inteiramente e chama o HubSpot do seu próprio código ou do Claude Code com requisições HTTP brutas.

A contrapartida a saber. Ir direto 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 OAuth, 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 fonte. No momento em que você também quer 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 HubSpot como um recurso (onde você já possui a integração de qualquer forma), ou scripts pontuais onde você não se importa em escrever o código de autenticação e paginação você mesmo. Para profissionais de marketing que querem fazer perguntas em inglês simples e combinar o HubSpot com o resto de sua stack em uma única conversa, o caminho do Porter MCP é dramaticamente menos trabalhoso.

Via Google Sheets (planilha ao vivo ou CSV manual)

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

A contrapartida a saber. Com o caminho MCP, o Claude chama a API do HubSpot diretamente e o HubSpot 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 do que chamadas de API ao vivo.
Quando isso faz sentido: equipes de finanças que querem revisar os números antes de o Claude agir 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 é aquele que salva você quando sua conta HubSpot fica séria. Um único usuário 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 atingindo o tempo limite em grandes extrações.

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

Quando isso faz sentido: contas enterprise com milhares de contatos e negócios, 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 HubSpot (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 →

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

O Claude é uma interface de chat. Você faz uma pergunta, o Claude obtém dados ao vivo por meio 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 programadas, aplicativos HTML, dashboards internos, integrações que rodam 24/7 sem sua intervenção. Uma vez conectado ao MCP da Porter para o HubSpot, uma categoria inteira de trabalho se torna possível.

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

É aqui que o ecossistema MCP mais compensa. Como o Claude Code pode combinar o MCP da Porter com outros MCPs — Firecrawl para web scraping, Airtable para dados estruturados, Notion para wikis, Vercel para implantação, Slack e Gmail para entrega — você não está mais consultando dados. Você está construindo ferramentas.

🛠️ Construa seu próprio dashboard de CRM

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

Alimente o Claude Code com seus objetivos de pipeline do HubSpot, valores de negócios e taxas de fechamento — e peça para ele gerar um dashboard de pipeline personalizado para cada cliente. Ele constrói o HTML, obtém dados ao vivo, implanta em uma URL. Sem incorporação estática de planilha que quebra quando o fornecedor muda os preços, sem restrições de modelo. O dashboard 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.

🔍 Monitoramento completo de concorrentes + desempenho

Stack: Porter MCP + Firecrawl MCP

Combine seu próprio desempenho do HubSpot da Porter com estratégias de CRM de concorrentes e posicionamento de mercado coletados via Firecrawl. O Claude Code une ambos em um relatório semanal de inteligência competitiva — seus números ao lado da velocidade de pipeline e tamanhos de negócios deles, com um resumo de LLM sobre o que mudou semana após semana. Roda em cron, chega na sua caixa de entrada toda segunda-feira de manhã.

Melhor 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: Porter MCP + Airtable MCP (ou Notion MCP)

Use o Airtable ou Notion como esquema, a Porter como fonte de dados. O Claude Code mantém cada página populada com o valor atual do negócio, probabilidade do negócio e estágio do ciclo de vida do contato 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.

Melhor para: agências e equipes de operações que fazem onboarding de analistas frequentemente ou rotacionam gerentes de conta.

🔔 Alertas 24/7 sobre saúde do pipeline, estagnação de negócios e inatividade de contatos

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

Uma rotina do Claude Code em cron obtém dados do HubSpot via Porter, avalia limites — probabilidade do negócio cai abaixo de 20%, nenhuma atividade em negócios de alto valor por mais de 14 dias — 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.

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 pontuais. O Claude Code é para construir aplicativos, 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 uma vez que o HubSpot está conectado ao Claude

Conectar corretamente é 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 HubSpot — desde perguntas 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.

chat_bubble“Mostre meus 10 principais negócios por valor do negócio fechando neste trimestre.”
chat_bubble“Liste contatos que não foram contatados há 30 dias e não têm negócios abertos.”
chat_bubble“Resuma meu desempenho de e-mail marketing do mês passado.”

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

2. Combine o HubSpot com seus dados de receita (Meta Ads, Google Ads, LinkedIn Ads)

É aqui que uma visão 360° fica real. Quando você conecta o HubSpot e sua fonte de receita (Meta Ads para geração de leads, Google Ads para pesquisa paga, LinkedIn Ads para prospecção B2B), o Claude pode mapear negócios e contatos para negócios fechados efetivamente — usando fonte do contato, nomes de campanhas e carimbos de data/hora — e dar a você uma atribuição que nenhum número de plataforma isolada pode.

chat_bubble“Cruze minha fonte original de negócios do HubSpot com minhas campanhas do Google Ads do trimestre passado. Quais campanhas geraram o maior valor de negócios ganhos?”
chat_bubble“Combine meus clientes da Shopify com contatos do HubSpot cuja receita total do contato é superior a US$ 1.000 e cuja data de fechamento recente do contato está nos últimos 30 dias.”

O Claude lida com a fonte do contato, nomes de campanhas e mapeamento de carimbos de data/hora e junções. Você obtém um relatório de atribuição pronto para o cliente que nenhuma plataforma isolada pode gerar por conta própria.

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

Com o Claude Code você pode transformar o monitoramento do HubSpot 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 programada do Claude Code que obtém o desempenho toda manhã e notifica você apenas quando algo realmente precisa de atenção.

chat_bubble“Me alerte quando meus dias para fechar do negócio excederem 60 dias para negócios onde o negócio fechado ganho é falso esta semana.”
chat_bubble“Sinalize meus negócios onde o número de atividades de vendas do negócio excede 10 e a data da última atividade do negócio tem mais de 14 dias.”

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 relatório estático do HubSpot cujas exportações quebram quando os filtros mudam — 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.

chat_bubble“Elabore um e-mail para o cliente resumindo minhas médias de pontuação do HubSpot por estágio do ciclo de vida do contato do mês passado.”
chat_bubble“Mostre por que meu valor de negócio caiu ontem com uma divisão por proprietário do negócio e pipeline do negócio.”

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 HubSpot que você pode consultar com o Claude

Antes de começar a escrever prompts, ajuda saber quais dados estão realmente disponíveis. O Porter MCP dá ao Claude acesso a 510 campos e métricas do HubSpot em todos os níveis de relatório, além de divisões por contato, empresa, negócio e dimensões de engajamento. E a mesma URL MCP também desbloqueia mais de 25 outras fontes — então o Claude pode combinar o HubSpot com Google Ads, GA4, Shopify e mais em um único prompt.

Níveis de relatório
Contact street addressContact buying roleContact cityContact close dateContact country/regionContact create dateContact days to closeContact emailContact email domainContact date of last meeting booked in meetings toolContact campaign of last booking in meetings toolContact medium of last booking in meetings toolContact source of last booking in meetings toolContact fax numberContact first deal created date+307 mais
Engagement metrics
Marketing email abMarketing email bodyMarketing email bounceMarketing email bounce totalMarketing email bounce ratioMarketing email campaign IdMarketing email campaign nameMarketing email campaign utmMarketing email clickMarketing email click totalMarketing email click ratioMarketing email click through ratioMarketing email contacts lostMarketing email contacts lost totalMarketing email contacts lost ratio+105 mais
Conversion metrics
Contact Facebook click IDContact first conversion dateContact first conversionContact Google ad click IDContact IP cityContact IP countryContact IP country codeContact IP state/regionContact IP state/region codeContact IP time zoneContact number of unique forms submittedContact recent conversion dateContact recent conversionCompany first conversion dateCompany first conversion+8 mais
Audience breakdowns
DateDay of monthDay of week (Mon – Sun)Hour of dayMonthQuarterWeekYearMonth and yearQuarter and yearWeek and year
Fontes multicanal (mesma URL)
Google AdsGoogle Analytics 4ShopifyHubSpotTikTok AdsLinkedIn AdsInstagramMailchimpKlaviyoActiveCampaignGoogle SheetsGoogle Search ConsoleGoogle Business ProfileFacebook InsightsFacebook Public Data+11 mais

Veja All HubSpot fields and metrics para a referência completa.

Prompts que você pode copiar e colar hoje

1. Para agências

Use estes ao gerenciar várias contas de clientes no HubSpot ou ao construir relatórios white-label.

chat_bubble“Liste meus 10 principais negócios por valor do negócio onde a categoria de previsão do negócio é Compromisso neste trimestre em uma tabela.”
chat_bubble“Mostre meus contatos onde o número de negócios associados do contato é zero e a data da última atividade do contato foi há mais de 30 dias em uma lista.”
chat_bubble“Elabore um e-mail para o cliente resumindo minhas médias de pontuação do HubSpot por estágio do ciclo de vida do contato do mês passado.”
chat_bubble“Mostre por que meu valor de negócio caiu ontem com uma divisão por proprietário do negócio e pipeline do negócio.”

2. Para profissionais de marketing B2B

Use estes para desempenho de campanha, nutrição de leads e análise de funil.

chat_bubble“Mostre meus 5 piores e-mails de marketing por taxa de cliques de e-mail marketing do mês passado em uma lista classificada.”
chat_bubble“Compare meus contatos Assinante com meus contatos Cliente na receita total do contato do trimestre passado em uma tabela.”
chat_bubble“Liste minha fonte original do contato classificada pela maior taxa de lead para cliente e menor média de visualizações de página do contato este ano.”
chat_bubble“Compare meu número de formulários únicos enviados pelo contato este mês versus o mês passado por semana em um gráfico.”

3. Para equipes de vendas

Use estes para saúde do pipeline, previsão de negócios e acompanhamento de atividades de vendas.

chat_bubble“Liste meus 10 principais negócios por probabilidade do negócio fechando este mês com valor do negócio e proprietário do negócio em uma tabela.”
chat_bubble“Projete meu valor previsto do negócio para o próximo trimestre com base no valor ponderado do negócio dos últimos 90 dias como uma tabela.”
chat_bubble“Me alerte quando meus dias para fechar do negócio excederem 60 dias para negócios onde o negócio fechado ganho é falso esta semana.”
chat_bubble“Sinalize meus negócios onde o número de atividades de vendas do negócio excede 10 e a data da última atividade do negócio tem mais de 14 dias.”

4. Multicanal

Use estes quando o HubSpot estiver conectado junto com outras fontes de dados por meio do Porter MCP.

chat_bubble“Cruze minha fonte original de negócios do HubSpot com minhas campanhas do Google Ads do trimestre passado. Quais campanhas geraram o maior valor de negócios ganhos?”
chat_bubble“Combine meus clientes da Shopify com contatos do HubSpot cuja receita total do contato é superior a US$ 1.000 e cuja data de fechamento recente do contato está nos últimos 30 dias.”
chat_bubble“Liste minha fonte original do contato do Google Ads pela maior receita total do contato e menor número de visualizações de página do contato este mês.”
chat_bubble“Mostre por que minha taxa de lead para cliente do HubSpot caiu na semana passada com uma divisão por fonte original do contato e primeira página vista do contato.”

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

chat_bubble“Estávamos sincronizando 50 mil contatos todas as noites via API. Uma noite o job atingiu a cota diária e tudo após o registro 12.847 simplesmente… falhou silenciosamente. Nossa equipe de vendas passou três dias ligando para leads desatualizados porque o campo ‘data da última atividade’ estava meio atualizado.” — usuário da API do HubSpot relatado, HubSpot Community Forums, 2025″

Este é o padrão de ‘história de terror’ mais comum para usuários da API do HubSpot: não bans, mas falhas parciais silenciosas em escala. Como o HubSpot retorna erros HTTP 429 (limitação) em vez de interromper todo o pipeline, jobs ETL e scripts de automação frequentemente continuam com dados incompletos. Um profissional de marketing executando um enriquecimento em massa de contatos via Claude MCP que não verifica códigos de resposta pode acabar com um CRM onde 40% dos registros têm estágios do ciclo de vida atualizados e 60% não — tornando a segmentação e os relatórios não confiáveis. O custo não é a suspensão da conta; é decisões tomadas com dados sujos.

A aplicação de limites de taxa do HubSpot é baseada em cota e janela rolante, não baseada em ferramenta. O HubSpot não bane ou suspende contas porque você usou o Claude, um servidor MCP ou uma integração de terceiros. Ele limita as requisições por causa de como a API foi usada: excedendo limites de burst (requisições por janela de 10 segundos), excedendo cotas diárias (totais rolantes de 24 horas), ou atingindo limites por endpoint como o limite de 4 requisições/segundo da API de Busca. Uso somente leitura dentro da cota do seu plano é seguro. Escritas paralelas em burst, operações em massa não agrupadas e chaves de API não escopadas não são. Quando um limite é atingido, o HubSpot retorna HTTP 429 com um cabeçalho; as requisições retomam automaticamente assim que a janela rolante é reabastecida. Não há sistema de ‘pontuação’ permanente ou penalidade em nível de conta. Retry-After O que realmente dá errado ao escalar o HubSpot via Claude

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

1. Burst paralelos de API e escritas em massa não agrupadas.

Enviar requisições concorrentes ou grandes payloads não agrupados viola os limites de burst de token-bucket do HubSpot (100 requisições por 10 segundos no Free/Starter, 190 no Professional, 200 no Enterprise). Quando excedido, o HubSpot retorna HTTP 429 e bloqueia novas requisições até que o bucket seja reabastecido. Se sua ferramenta MCP do Claude ou script de automação não lida com 429s com backoff exponencial, o pipeline continua com dados parciais — criando um CRM inconsistente. Documentos oficiais: HubSpot API Usage Limits via Reform.app rate limit guide O que fazer em vez disso:. agrupar escritas em no máximo 100 registros por requisição e implementar backoff exponencial começando em 1 segundo, dobrando até 16 segundos. 2. Expor chaves de API ou tokens de acesso em ambientes compartilhados.

Uma auditoria de segurança de 2024 encontrou que 1,6 milhão de dados de usuários do HubSpot foram comprometidos por meio de chaves de API expostas em repositórios públicos, extensões de navegador e configurações compartilhadas do Claude Desktop. Diferentemente dos Conectores Nativos baseados em OAuth (que usam tokens escopados e rotativos), configurações de Servidor MCP e Aplicativos Privados dependem de tokens de acesso estáticos que podem vazar em arquivos de configuração JSON, gists do GitHub ou configurações compartilhadas do Claude Desktop. Fonte: BeVigil security research O que fazer em vez disso:. use o Conector Nativo OAuth quando possível; se estiver usando o Servidor MCP, armazene tokens em variáveis de ambiente ou um gerenciador de segredos, nunca em arquivos JSON commitados. 3. Escopos superprivilegiados e ignorar bypasses de validação.

O Conector Nativo do HubSpot para o Claude solicita escopos amplos de leitura/escrita na configuração. Se configurado antes de 20 de novembro de 2025, pode faltar permissões de escrita e exigir uma desconexão/reconexão completa para habilitar a criação de registros — uma interrupção que quebra fluxos de trabalho automatizados. Mais criticamente, regras de validação personalizadas configuradas no HubSpot NÃO são aplicadas ao criar ou atualizar registros via API ou conector , o que significa que o Claude pode escrever dados que violam as próprias regras de qualidade de dados do seu CRM (por exemplo, formatos de e-mail inválidos, campos obrigatórios ausentes, nomes de empresa duplicados).Fonte: HubSpot Knowledge Base — Best Practices e developers.hubspot.com/mcp O que fazer em vez disso:. audite os escopos após a configuração, reconecte se as permissões de escrita estiverem ausentes, e execute relatórios de validação na interface do HubSpot após qualquer atualização em massa iniciada pelo Claude. Ambos os comportamentos desencadeiam limitação baseada em cota e degradação da qualidade dos dados. Se você quer usar o Claude para o HubSpot com segurança, use o MCP gerenciado da Porter que lida com agrupamento, backoff e rotação OAuth automaticamente.

O protocolo de melhores práticas de 5 regras

Com base nos limites de taxa e cotas documentados do HubSpot e nos comportamentos que realmente causaram falhas parciais silenciosas — não suposições:

Fique abaixo do limite de burst do seu plano.

  • Contas Free e Starter do HubSpot são limitadas a 100 requisições de API por janela de 10 segundos ; Professional a190 ; Enterprise a200 . Exceder isso dispara HTTP 429 e pausa seu pipeline.NEEDS_REVIEW: limite exato de burst do Enterprise — fontes conflitantes citam 200 vs 250 Consequência se ignorado: . a limitação no meio da sincronização deixa seu CRM em um estado parcialmente atualizado. Aplicação da Porter: O MCP da Porter agrupa todas as requisições do HubSpot e aplica ritmo de taxa por janela de 10 segundos automaticamente. Agrupe operações em massa em 100 registros por requisição.
  • Os endpoints em massa do HubSpot aceitam até 100 registros por lote . O Conector Nativo para o Claude tem um limite mais estrito de10 registros máximo por operação de criação/atualização . Enviar payloads maiores resulta em registros rejeitados ou transações divididas.Fonte: HubSpot Knowledge Base (tabela do Conector Nativo) e HubSpot API docs Consequência se ignorado:. registros falham silenciosamente ou exigem reentrada manual. Aplicação da Porter: A Porter divide requisições em massa em blocos de 100 registros e exibe registros com falha na resposta. Implemente backoff exponencial em erros 429.
  • Quando o HubSpot limita a taxa, ele retorna HTTP 429 com um cabeçalho. A melhor prática é esperar Retry-After 1 segundo no primeiro 429, depois dobrar o tempo de espera (2s, 4s, 8s, 16s) até um máximo de 16 segundos antes de tentar novamente. Fonte: HubSpot Developer Docs via Consultevo rate limit guide Consequência se ignorado:. tentar novamente imediatamente estende a janela de limitação e pode agravar estados de falha parcial. Aplicação da Porter: O MCP da Porter inclui backoff exponencial automático com jitter em todas as respostas 429. Monitore sua cota diária, não apenas os limites de burst.
  • Contas Free/Starter têm uma cota rolante de 24 horas de 250.000 requisições ; Professional650.000 ; Enterprise1.000.000 ; Aplicativos públicos500.000 . Uma sincronização histórica grande ou backfill pode consumir toda a cota diária ao meio-dia, deixando automações da noite paradas.Fonte: Reform.app rate limit guide e Consultevo guide Consequência se ignorado:. fluxos de trabalho programados (envios de e-mail, pontuação de leads, atualizações de relatórios) falham por horas. Aplicação da Porter: A Porter rastreia o consumo de cota diária por conta e avisa quando 80% é atingido. Nunca commit tokens de API em arquivos ou repositórios compartilhados.
  • Tokens de Aplicativo Privado do HubSpot e chaves de API legadas são credenciais estáticas. Uma auditoria de 2024 encontrou 1,6 milhão de usuários com dados expostos por meio de chaves vazadas em repositórios de código públicos. Se estiver usando o caminho do Servidor MCP com o Claude Desktop, armazene o em variáveis de ambiente ou um gerenciador de segredos — nunca em accessToken que é compartilhado via Slack, Notion ou GitHub. claude_desktop_config.json Fonte: BeVigil security research Consequência se ignorado:. acesso não autorizado ao seu CRM inteiro, incluindo contatos, negócios, dados de receita e histórico de engajamento. Aplicação da Porter: O MCP gerenciado da Porter usa rotação de token OAuth e nunca expõe credenciais estáticas aos usuários finais. O que o Porter MCP faz de diferente:

ele aplica esses limites e salvaguardas no nível da plataforma. O MCP do HubSpot da Porter agrupa requisições em blocos compatíveis com o HubSpot (máximo 100 registros por lote), aplica ritmo de burst por plano (100/190/200 por 10s), implementa backoff exponencial automático com jitter em respostas 429, e rastreia o consumo de cota diária em todas as contas conectadas. Diferentemente de servidores MCP auto-hospedados onde a lógica de limite de taxa é responsabilidade do usuário, a Porter lida com rotação de token via OAuth (sem chaves estáticas em arquivos JSON), minimiza escopos para somente leitura por padrão, e exibe avisos de validação quando regras personalizadas do HubSpot seriam ignoradas. Esse é o comportamento que os sistemas automatizados do HubSpot lidam com elegância — sem limitação, sem sincronizações parciais, sem credenciais expostas. Perguntas frequentes

P: O que é um HubSpot MCP?

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

P: 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 HubSpot via MCP.

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

A API do HubSpot atualiza em uma janela rolante. O MCP da Porter obtém dados ao vivo, então seus dados estão sempre dentro dessa janela.

P: Existem limites de taxa para dados do HubSpot?

Sim. O HubSpot impõe limites de burst por plano: 100 requisições por 10 segundos no Free/Starter, 190 no Professional e 200 no Enterprise, além de cotas diárias de até 1.000.000 de requisições. O MCP da Porter agrupa requisições em blocos de 100 registros e aplica ritmo por plano automaticamente. Fonte: [HubSpot API Usage Details]

P: Por que os números do Claude às vezes diferem do dashboard do HubSpot?

Duas razões comuns: (1) Atraso de atualização — os dados de relatório do HubSpot atualizam em uma janela rolante, então pulls de API podem ficar atrás da interface. (2) Sincronização parcial — operações limitadas ou em massa podem deixar registros meio atualizados se erros 429 não forem tratados. A solução: teste com um intervalo de datas pequeno primeiro e verifique se as contagens de registros correspondem. Fonte: [HubSpot Knowledge Base, HubSpot API Usage Details]

P: Usar o Claude afetará meu acesso ou limites do HubSpot?

Não. O HubSpot não bane ou restringe contas por uso legítimo da API, e o MCP da Porter é somente leitura por padrão — fica bem dentro dos limites normais de taxa do HubSpot. O que observar é a limitação de taxa causando falhas parciais silenciosas em escala — veja a seção de limites acima. Fonte: [HubSpot API Usage Details, HubSpot Community Forums]

Pronto para conversar com o seu HubSpot?

Pronto para conversar com o seu HubSpot?

Abra o Claude, adicione o conector Porter e faça sua primeira pergunta. Se ainda não tiver o Porter, comece um teste grátis e conecte sua conta do HubSpot — você estará conversando com seus negócios, contatos e empresas em menos de cinco minutos.

rocket_launch Experimente grátisopen_in_new Agende uma demo