Numa segunda-feira qualquer, uma gerente comercial abre o Claude, pergunta quais negócios do HubSpot estão parados há mais de trinta dias e recebe a lista em segundos, com o provável motivo de cada um.
Ninguém abriu relatório, ninguém pediu para a operação montar uma visão e ninguém precisou lembrar o nome da propriedade certa.
A mesma facilidade que torna a resposta tão convincente esconde três perguntas que quase ninguém faz antes de conectar:
O que mais esse assistente consegue ver?
O que ele consegue alterar?
Quem confere depois o que ele fez?
Conectar uma IA de fora ao CRM parece uma decisão de produtividade, mas é uma decisão de acesso.
Por isso a pergunta deste post não é qual assistente conectar ao HubSpot, e sim com que crachá ele entra. O HubSpot MCP abre o CRM para Claude, ChatGPT e outras IAs com as permissões de quem fez a conexão, e o valor que a empresa tira disso depende menos da ferramenta do que de ter decidido, antes, o que esse crachá abre.
Resumo executivo
O assistente externo herda as permissões do usuário que fez a conexão, lê contatos, empresas, negócios, tickets e atividades.
O HubSpot MCP é a porta pela qual um assistente de IA de fora, como Claude e ChatGPT, lê e atualiza os dados do seu HubSpot em linguagem natural.
MCP (Model Context Protocol) é o padrão aberto que permite essa conversa entre qualquer assistente compatível e um sistema como o CRM.
Em vez de exportar uma planilha, colar num chat e perder o vínculo com o registro, você conecta o assistente ao HubSpot uma vez, autoriza com a própria conta e passa a perguntar sobre contatos, negócios, tickets e campanhas, ou a pedir que ele crie e atualize registros.
A HubSpot mantém dois servidores, o remoto, que dá acesso aos dados do CRM, e um local, voltado a quem desenvolve aplicativos e sites na plataforma, e o foco aqui é o primeiro.
O servidor remoto saiu do beta em abril de 2026 e aceita qualquer assistente que implemente a autenticação exigida.
Os conectores de IA do HubSpot são as versões prontas dessa conexão, instaladas pelo Marketplace sem configuração técnica, e é por eles que o HubSpot se conecta com Claude, ChatGPT, Copilot e Gemini.
Entre outras coisas, eles permitem criar e analisar campanhas direto no Claude e acessar o contexto completo de conversas por chat, e-mail, SMS, WhatsApp e Messenger.
A conexão usa a conta de um usuário. Você entra no HubSpot, aprova as permissões e o assistente passa a agir como ela.
No HubSpot com Claude, por exemplo, quem é Super Admin ou tem acesso ao Marketplace conecta sem aprovação prévia, os demais dependem de um Super Admin aprovar o conector, e o lado do Claude exige um plano pago da Anthropic.
A conexão leva poucos minutos e tem três momentos, a aprovação do Super Admin quando a pessoa não é administradora, a autorização no próprio assistente e o ajuste das ferramentas de escrita para pedir aprovação.
Os passos abaixo seguem a ordem que a própria HubSpot recomenda para os conectores prontos de Claude, ChatGPT, Gemini e Copilot.
O Super Admin e quem tem acesso ao Marketplace conectam sem aprovação prévia. Todos os outros dependem de um Super Admin revisar e aprovar o conector, escolher as permissões opcionais de dados que ele pode usar e definir quais usuários podem instalá-lo.
Escolha o assistente que a empresa já usa. Os passos mudam de um para outro, e só o Claude e o ChatGPT escrevem no CRM, enquanto o Gemini e o Copilot apenas leem.
No Claude, clique no ícone do perfil, abra Configurações (Settings), vá em Conectores (Connectors) e clique em Procurar (Browse).
Busque HubSpot, clique em Conectar, escolha a conta do HubSpot e faça login. Na página de autorização, selecione as permissões que quer liberar e clique em Conectar app, o que leva de volta à conversa do Claude.
No ChatGPT, o caminho é parecido: clique no ícone do perfil, abra Configurações e depois Apps, selecione HubSpot e clique em Conectar.
Entre no HubSpot, escolha a conta, marque as permissões que quer liberar na página de autorização e clique em Conectar app.
Os nomes de menu mudam entre as versões do ChatGPT, então vale conferir o rótulo atual na tela.
No Gemini, acesse gemini.google.com, abra Configurações e ajuda (Settings & Help) no canto inferior esquerdo, clique em Apps, ative a chave do HubSpot e entre com as credenciais do HubSpot, usando o mesmo e-mail do Gmail do Workspace. Depois, basta escrever @HubSpot antes do pedido.
Quem prefere pode instalar pelo Google Workspace Marketplace, com o administrador ativando o Gemini Alpha no espaço de trabalho e a pessoa clicando em Conectar.
O conector exige um plano pago do Google Workspace, Business Standard, Business Plus ou Enterprise, e funciona só em inglês.
No Copilot, o administrador do Microsoft 365 começa no centro de administração, em Agentes (Agents) e Todos os agentes, procura HubSpot, confirma que o status é Disponível e, na guia Usuários, define quem pode instalar o agente.
Depois, cada pessoa abre o Copilot Chat ou o Copilot no Teams, clica em HubSpot em Agentes, na barra lateral, digita um pedido, clica em Entrar no HubSpot, escolhe a conta e as permissões e clica em Conectar app.
A conexão exige uma licença do Microsoft 365 Copilot ou o complemento do Copilot Chat.
O Claude aceita uma conta do HubSpot por vez e exige um plano pago da Anthropic, e em qualquer assistente a pessoa pode liberar todas as permissões da tela por pressa e dar ao assistente mais acesso do que as perguntas pedem.
O Gemini e o Copilot só leem, e quem espera criar ou atualizar registros por eles descobre tarde que não dá, enquanto a instalação do Copilot depende de dois administradores, o do Microsoft 365 e o do HubSpot.
Nos conectores que escrevem, como os do Claude e do ChatGPT, abra as configurações de ferramentas do HubSpot e ajuste as ferramentas de escrita para pedir aprovação.
A própria HubSpot recomenda isso, porque, com a opção de sempre permitir, o assistente pode editar registros sem perguntar antes.
Na conversa do Claude, clique no sinal de mais, abra Conectores e confirme que o HubSpot está ativado. Faça uma pergunta de consulta e compare a resposta com um relatório do próprio HubSpot.
Quando o pedido for de criação ou atualização, revise a alteração proposta e responda Sim ou Não, e depois clique no link para abrir o registro no HubSpot e conferir.
Quando o Super Admin muda as permissões de dados, cada usuário precisa desconectar e conectar de novo para receber o acesso novo.
O mesmo caminho serve para desconectar, em Configurações, Conectores, HubSpot e Desconectar, e vale para conectores que ninguém usa mais.
Quem usa um assistente sem conector pronto, ou monta uma automação própria, pode criar um conector MCP direto no HubSpot, com ajuda de quem desenvolve.
No HubSpot, vá em Desenvolvimento, abra MCP Connectors e clique em Criar conector MCP, informe o nome e o endereço de redirecionamento do OAuth, e anote o ID e o segredo do cliente gerados.
No assistente, aponte para o servidor remoto da HubSpot com autenticação OAuth com PKCE, complete o fluxo de escolher a conta, conceder permissões e autorizar, e teste com o MCP Inspector, executando a ferramenta que mostra o usuário e o acesso da conexão.
No sentido inverso, abra o Agent Hub, vá à guia Agentes e clone o agente que será alterado.
Em Ações, clique em Adicionar ação, abra a guia Conectores, escolha o aplicativo e clique em Conectar e adicionar para autorizar.
Depois, em Integrações e Apps conectados, nas configurações, defina para cada ferramenta entre Sempre permitir, Pedir permissão e Nunca permitir, e revise essa lista sempre que o agente mudar.
Leia mais: Agent Hub: a central de controle da IA da HubSpot
A IA do HubSpot, como o Breeze e os agentes do Agent Builder, trabalha sobre os dados e as regras da própria plataforma.
Um LLM entra no CRM por uma conexão autorizada e leva para a conversa o que a pessoa já usa fora do HubSpot, como documentos, e-mails e perguntas novas.
A escolha não é entre uma e outra, e sim sobre onde cada trabalho acontece.
O que é recorrente e tem regra clara, como pontuar leads ou rever o pipeline toda semana, tende a ficar dentro, em agentes com permissões e créditos controlados pela plataforma.
O que é exploratório, como cruzar o CRM com um contrato, um e-mail ou uma pergunta que ninguém tinha feito antes, tende a ficar fora, onde a pessoa já conversa com o assistente.
Há um terceiro caminho que o debate costuma esquecer. Os agentes do Agent Builder também funcionam como clientes MCP e se conectam a ferramentas externas, como Notion, Slack, Gmail e Google Drive, para buscar dado e agir fora do HubSpot.
Uma equipe de RevOps pode, por exemplo, ligar um agente ao Notion para analisar conversas com clientes e rascunhar planos de conta.
Leia mais: Agente de IA e RevOps: como estruturar uma operação AI First
Aqui o risco muda de lado, porque agora é o CRM que dá acesso a sistemas de terceiros, e valem as mesmas perguntas sobre permissão, aprovação e auditoria.
A própria HubSpot recomenda conectar a cada agente só as ferramentas de que ele precisa e escolher, para cada ferramenta de escrita, entre sempre permitir, pedir permissão e nunca permitir.
Um assistente conectado ao HubSpot consegue ler a maior parte do portal e escrever em boa parte dele, sempre dentro das permissões do usuário que fez a conexão, e a lista exata de ferramentas disponíveis varia com a assinatura, com as permissões e com a configuração da conta.
A leitura cobre contatos, leads, empresas, negócios, tickets e objetos personalizados, os dados de marketing, como campanhas, páginas, posts de blog, e-mails e listas, os dados comerciais, como itens de linha, orçamentos, faturas, pedidos e assinaturas, e o histórico de atividades, com ligações, reuniões, notas, tarefas, e-mails e conversas do Inbox ou do Help Desk.
Entram também as configurações, como funis, propriedades, usuários e equipes, o que dá ao assistente o mapa de como a empresa organiza o próprio CRM.
A escrita permite criar e atualizar a maior parte dos objetos do CRM, e-mails de marketing, páginas, posts de blog e atividades, e criar campanhas e eventos.
Alguns objetos são só de leitura, como faturas, pedidos e pagamentos, e outros, como orçamentos, ainda estão em beta.
O que torna isso relevante para a operação é que o pedido em linguagem natural vira alteração em registro real, e por isso a regra de aprovação importa mais do que a qualidade da resposta.
Nenhuma exclusão é possível pelo conector, e quem precisa apagar um dado faz isso direto no HubSpot.
As propriedades de dados sensíveis ficam fora do alcance, e, se o recurso de dados sensíveis está ligado na conta, os dados de atividade e de conversa também ficam bloqueados.
As operações em lote têm limite de 10 registros, as regras condicionais de propriedade e as validações de etapa do funil continuam valendo, e páginas ainda não publicadas expõem só os metadados.
Para empresas de saúde e para quem lida com LGPD, esse bloqueio é um ponto de partida do desenho, e não um detalhe de configuração.
Os conectores do Claude e do ChatGPT leem e escrevem, o do Gemini é só de leitura e cobre contatos, empresas e negócios, e o agente do Copilot também é só de leitura, com um conjunto amplo de objetos.
A decisão sobre aprovação de escrita vale, portanto, para Claude e ChatGPT, e a lógica de acesso, em que o assistente vê só o que o usuário vê, vale para os quatro.
Quem audita é o próprio HubSpot, que registra quem conectou o conector e cada criação e atualização feita por ele, atribuídas ao usuário e ao conector, e o Super Admin decide quem pode instalar, quais permissões opcionais de dados o conector recebe e quando o acesso é revogado.
O registro existe, e o que costuma faltar é alguém com o hábito de olhar para ele.
Como o assistente age com as permissões de quem conectou, um diretor com acesso a tudo que liga o Claude ao HubSpot entrega ao assistente o acesso a tudo.
As permissões do conector só mudam quando cada usuário reconecta, e os administradores do Claude Enterprise ainda podem bloquear conexões de contas fora do domínio verificado da empresa. O desenho certo começa, portanto, por perguntar quem vai conectar, e não por qual assistente escolher.
A própria HubSpot recomenda deixar as ferramentas de escrita em pedir aprovação, de modo que o assistente mostre a alteração proposta e você responda sim ou não.
Com a opção de sempre permitir, a edição acontece sem confirmação, o que é aceitável para rascunhos de baixo risco e perigoso para qualquer coisa que mude estágio de negócio, valor ou propriedade usada em relatório.
A Gartner prevê que, até 2028, 25% das violações de segurança em empresas terão origem no uso indevido de agentes de IA, e a McKinsey mostra que segurança e risco já são a principal barreira para escalar IA agêntica.
Em conversas com empresas de distribuição e de indústria, a Aconcaia já ouviu o marketing descobrir que não tinha acesso à própria conta de anúncios, com um ex-funcionário ainda logado nela.
O mesmo descuido, aplicado a uma conexão de IA com o CRM, vira um acesso que ninguém lembra de ter concedido.
O HubSpot MCP acelera as perguntas que hoje dependem de alguém da operação montar um relatório ou abrir cinco abas, e vira bagunça quando o CRM tem dado duplicado, etapa sem critério ou propriedade sem dono, porque o assistente responde com a mesma convicção sobre uma base boa e sobre uma base ruim.
Quando a pergunta é quais negócios de uma faixa de valor pararam e há quanto tempo, a IA externa consulta o CRM e responde na hora, sem fila e sem relatório novo que ninguém vai reabrir.
O mesmo vale para analisar a atribuição de receita de uma campanha ou comparar o desempenho de dois e-mails, que são perguntas de poucos minutos e que o conector já cobre.
Preparar uma reunião deixa de ser uma caçada entre abas e vira uma pergunta sobre a conta, com e-mails, reuniões, notas, tickets e conversas reunidos na resposta.
A vantagem da IA de fora sobre a de dentro está em cruzar esse histórico com o que não está no HubSpot, como a proposta em PDF, a ata de uma reunião ou a pesquisa sobre o cliente, que a pessoa já tem aberta na conversa.
A primeira bagunça é a do dado. Um assistente conectado a um CRM com contatos duplicados resume uma versão parcial do cliente, e quem lê a resposta decide em cima do que falta, o mesmo problema que a IA de dentro tem e que só aparece mais rápido quando qualquer um pode perguntar.
A segunda é a da escrita sem convenção, já que o servidor remoto também expõe ferramentas para criar propriedades personalizadas e funis, e um pedido bem-intencionado pode gerar o campo duplicado que a operação leva meses para limpar.
A conclusão é a mesma dos agentes nativos, o que a IA entrega depende do contexto e da qualidade do dado que a empresa colocou antes.
Leia mais: Context Home no HubSpot: contexto de negócio primeiro, IA depois
A decisão segue uma ordem, que é saber quem conecta, com que acesso, o que o assistente só lê, o que ele pode alterar com aprovação, o que fica fechado e quem confere depois.
Pular um desses passos é o que transforma uma boa ideia de produtividade em um acesso sem dono.
Comece listando quem é Super Admin, quem tem acesso ao Marketplace e quem já conectou algum assistente, porque essas pessoas conectam sem aprovação prévia.
O pré-requisito é ter o mapa de usuários e perfis de permissão atualizado, e o critério é simples, quem não precisa conectar não deveria poder.
Como o assistente herda o acesso de quem conectou, conecte com o usuário que enxerga só o que as perguntas precisam, e não com o administrador que tem acesso a tudo.
Aconcaia recomenda, quando a licença permite, um usuário e um perfil de permissão dedicados ao uso com IA, com acesso enxuto e dono definido.
Use as primeiras semanas para perguntas de consulta, como negócios parados, histórico de uma conta ou desempenho de uma campanha. O critério de avanço é a resposta do assistente bater com o relatório do próprio HubSpot em uma amostra de casos.
Mantenha as ferramentas de escrita em pedir aprovação e comece por notas, tarefas e rascunhos.
Etapa de negócio, valor, propriedades usadas em relatório, funis e criação de propriedades ficam para depois, e só entram quando a operação tem convenção escrita de nomes e critérios.
Dados de saúde, conversas com clientes, informações de contrato e qualquer coisa coberta por LGPD precisam de decisão explícita.
Ative o recurso de dados sensíveis do HubSpot onde ele se aplica, sabendo que ele bloqueia atividades e conversas para o conector, e escolha com o Super Admin as permissões opcionais de dados.
Defina quem lê o registro de auditoria, com que frequência nas primeiras semanas e o que dispara uma revisão, como troca de colaborador no time, mudança de permissão ou conector sem uso, que deve ser desconectado.
Os especialistas HubSpot da Aconcaia sugerem começar com uma leitura quinzenal e espaçar quando o uso estiver estável.
As IAs externas vão chegar ao CRM de qualquer jeito, porque as pessoas já conversam com elas todos os dias, e a diferença está em chegarem pela porta da frente, com acesso decidido, ou pelo atalho de quem conecta primeiro e pergunta depois.
Na Aconcaia, o HubSpot MCP é tratado como uma política de acesso da operação de receita, e só depois como um ganho de produtividade.
Por isso o trabalho começa pelo diagnóstico de quem tem acesso a quê e da qualidade do dado que o assistente vai ler, passa pelo desenho do crachá, com perfil de permissão, aprovação de escrita e o que fica fechado, e só então chega ao piloto de leitura.
A rotina de auditoria fecha o ciclo, para que o acesso seja revisto quando o time, as permissões ou os conectores mudam.
Quer decidir o que abrir e o que manter fechado no seu HubSpot antes de conectar um assistente? Conheça o trabalho da Aconcaia com Breeze e agentes de IA no HubSpot.
O que é o HubSpot MCP?
É o servidor que permite a assistentes de IA externos, como Claude e ChatGPT, consultar e atualizar dados do CRM do HubSpot em linguagem natural, usando o padrão aberto MCP (Model Context Protocol). O assistente age com as permissões do usuário que fez a conexão.
Como conectar o Claude ao HubSpot?
O HubSpot oferece um conector próprio para o Claude, que o Super Admin ou quem tem acesso ao Marketplace instala sem aprovação prévia, e os demais usuários precisam da aprovação de um Super Admin. No Claude, você abre Configurações, Conectores, procura HubSpot, clica em Conectar e autoriza as permissões, e o lado do Claude exige um plano pago da Anthropic.
O HubSpot funciona com ChatGPT, Gemini e Copilot?
Sim, o HubSpot se conecta com Claude, ChatGPT, Copilot e Gemini por conectores no Marketplace, e o servidor remoto aceita qualquer assistente compatível com a autenticação exigida. Os conectores de Claude e ChatGPT leem e escrevem, e os do Gemini e do Copilot são só de leitura.
O que uma IA conectada ao HubSpot consegue alterar?
No Claude e no ChatGPT, ela cria e atualiza a maior parte dos objetos do CRM, e-mails de marketing, páginas, posts de blog e atividades, com limite de 10 registros por operação em lote, e algumas ferramentas, como orçamentos, seguem em beta. Faturas, pedidos e pagamentos são apenas de leitura, e no Gemini e no Copilot o acesso inteiro é só de leitura.
Uma IA externa consegue excluir registros do HubSpot?
Não, o conector não permite excluir nenhum objeto, e a exclusão precisa ser feita direto no HubSpot. Isso não impede alterações indevidas de valor, etapa ou propriedade, que continuam exigindo aprovação de escrita.
Como controlar o acesso de uma IA externa ao CRM?
O controle combina o Super Admin, que aprova o conector e escolhe as permissões opcionais de dados, as ferramentas de escrita em pedir aprovação e o registro de auditoria, que mostra cada criação e atualização por usuário e conector. Aconcaia recomenda conectar com um usuário de permissão enxuta e dar um dono à revisão do registro.
O HubSpot MCP acessa dados sensíveis?
Não acessa as propriedades de dados sensíveis e, se o recurso de dados sensíveis está ligado na conta, bloqueia também os dados de atividade e de conversa. A decisão do que classificar como sensível precisa vir antes de ligar o conector.
Qual a diferença entre o HubSpot MCP e o Breeze?
O Breeze é a IA que trabalha dentro do HubSpot, com o Breeze Assistant e os agentes, e o HubSpot MCP é a conexão que deixa uma IA de fora consultar o CRM. Os agentes do Agent Builder também podem se conectar por MCP a ferramentas externas, como Gong, Notion e Slack, no caminho inverso.