HubSpot MCP Server

O que é o HubSpot MCP Server?

O HubSpot MCP Server é uma aplicação leve que expõe as capacidades do CRM HubSpot como ferramentas padronizadas do MCP. Com essa integração, clientes de IA como Claude Desktop, Cursor e outros compatíveis com o protocolo MCP podem acessar, consultar e modificar dados do HubSpot sem a necessidade de integração manual com a API ou aprender os detalhes da API do HubSpot. Ele resume operações complexas de CRM em comandos fáceis de usar, ideais para fluxos de trabalho dirigidos por IA e automação de agentes.

Como Configurar o HubSpot MCP Server

Instale o Node e o NPM: Baixe e instale o Node.js e o npm em nodejs.org.
Crie um Aplicativo Privado no HubSpot:
- Acesse o seu painel do HubSpot: Configurações > Integrações > Aplicativos Privados.
- Clique em "Criar aplicativo privado", nomeie-o, defina os escopos necessários e copie o token de acesso gerado.
Configure o Cliente MCP:
- Para Claude Desktop:
  - Adicione a configuração do servidor HubSpot com seu token de acesso ao arquivo de configuração do Claude (claude_desktop_config.json) e reinicie o aplicativo.
- Para Cursor:
  - Adicione a configuração em .cursor/mcp.json no diretório do seu projeto.
- Para outros clientes MCP, siga as instruções específicas deles para configurar servidores MCP externos.
Variável de Ambiente: Verifique se a variável PRIVATE_APP_ACCESS_TOKEN está definida corretamente na sua configuração.

Como Usar o HubSpot MCP Server

Após configurar o servidor, reinicie seu cliente MCP (por exemplo, Claude Desktop ou Cursor).
Agora você pode acessar ferramentas específicas do HubSpot diretamente do seu cliente de IA. Use comandos como "Obter a última atualização sobre a Acme Inc." ou "Criar um novo contato na minha conta do HubSpot".
O agente de IA usará ferramentas MCP para realizar operações de CRM, buscar insights e atualizar registros conforme solicitado.
Visite a documentação correspondente ou a página de solução de problemas caso encontre problemas de configuração.

Principais Recursos

Acesso Unificado: Conecte-se ao HubSpot de qualquer cliente compatível com MCP sem lidar manualmente com APIs.
Amplitude Funcional: Realize uma ampla gama de ações de CRM, desde leitura e atualização de registros até gerenciamento de associações, fluxos de trabalho e engajamentos.
Seguro e Flexível: Opera de forma segura usando o token de acesso do seu aplicativo privado e não exige a exposição de credenciais brutas do HubSpot.
Extensível: Aproveite um conjunto crescente de ferramentas MCP mapeadas para o fluxo de trabalho do seu CRM HubSpot.
Suporte ao Feedback: Gere instantaneamente links de feedback para relatar ou sugerir melhorias.

Casos de Uso

Insights de Dados de CRM: Resuma negócios, tickets e interações de empresas para inteligência de negócios instantânea.
Gerenciamento de Contatos e Negócios: Automatize a criação, atualização e associação de contatos, empresas, negócios e tickets.
Rastreamento de Atividades: Adicione anotações ou tarefas e rastreie ações atrasadas dentro do CRM.
Análise de Fluxo de Trabalho: Recupere e analise fluxos de trabalho do HubSpot, matrícula e programação.
Gerenciamento de Propriedades Personalizadas: Liste, crie e atualize propriedades personalizadas em objetos de CRM programaticamente.

FAQ

Q1: Quais permissões preciso no meu aplicativo privado do HubSpot para usar o servidor MCP?
R: É recomendado começar com escopos de leitura apenas para a configuração inicial. À medida que você expande seu uso, conceda apenas os escopos necessários para as operações desejadas (por exemplo, leitura/gravação de objetos de CRM, acesso a engajamentos, gerenciamento de propriedades).

Q2: Meus dados do HubSpot estão seguros ao usar o servidor MCP?
R: Sim. O servidor MCP opera completamente dentro da sua infraestrutura e usa apenas o token de acesso do seu aplicativo privado configurado. Nenhuma credencial do HubSpot ou dado sensível é armazenado ou exposto além da sua configuração.

Q3: Posso usar o HubSpot MCP Server com vários aplicativos clientes MCP?
R: Sim, você pode adicionar a configuração do servidor a qualquer cliente compatível com MCP, como Claude Desktop ou Cursor, e acessar as ferramentas do HubSpot em cada um deles.

Q4: Como posso fornecer feedback ou relatar um problema com as ferramentas MCP?
R: Use a ferramenta hubspot-generate-feedback-link para gerar uma URL de feedback ou use o comando dedicado no seu cliente MCP.

Q5: Que tipo de ações posso automatizar usando agentes de IA com este servidor?
R: Você pode automatizar tudo, desde a criação e atualização em massa de registros até a geração de relatórios, gerenciamento de associações e rastreamento de engajamentos—tudo por meio de comandos em linguagem natural.

Nome do Protocolo	Descrição
hubspot-get-user-details	Autentica o token de acesso do aplicativo privado do HubSpot atual e recupera informações do usuário, detalhes do portal, escopos autorizados e metadados da conta.
hubspot-list-objects	Recupera uma lista paginada de registros de CRM de um tipo de objeto especificado (por exemplo, contatos, empresas, negócios ou tickets).
hubspot-search-objects	Realiza pesquisas filtradas no seu CRM HubSpot usando critérios personalizados e filtros baseados em propriedades entre diferentes tipos de registros.
hubspot-batch-create-objects	Cria múltiplos registros de CRM de um tipo de objeto em uma única chamada, facilitando a entrada em massa e fluxos de trabalho de integração.
hubspot-batch-update-objects	Atualiza vários registros de CRM existentes com novos valores de propriedade em uma única operação.
hubspot-batch-read-objects	Recupera múltiplos registros de CRM pelos seus IDs em uma chamada, otimizando o desempenho para consultas em lote.
hubspot-get-schemas	Lista os esquemas de objetos personalizados disponíveis, mostrando objectTypeIds e suas definições para personalização avançada do CRM.
hubspot-list-properties	Lista todas as definições de propriedade para qualquer tipo de objeto CRM do HubSpot, fornecendo insights sobre o esquema e campos personalizados.
hubspot-get-property	Recupera metadados detalhados sobre uma definição de propriedade específica do CRM.
hubspot-create-property	Cria uma nova propriedade personalizada para um tipo de objeto CRM especificado.
hubspot-update-property	Atualiza as configurações e a configuração de uma propriedade personalizada existente.
hubspot-create-association	Estabelece ou atualiza relacionamentos entre registros de CRM (como associar um contato a uma empresa).
hubspot-list-associations	Recupera todas as associações entre um registro de CRM específico e quaisquer registros relacionados.
hubspot-get-association-definitions	Fornece uma lista de tipos e rótulos de associação válidos entre tipos de objetos de CRM especificados.
hubspot-create-engagement	Cria um novo engajamento, como uma Nota ou Tarefa, associando-a a contatos, empresas, negócios ou tickets relevantes.
hubspot-get-engagement	Recupera detalhes do engajamento para um ID de engajamento específico.
hubspot-update-engagement	Atualiza detalhes ou propriedades de um engajamento existente.
hubspot-list-workflows	Recupera e lista fluxos de trabalho disponíveis configurados na sua conta do HubSpot.
hubspot-get-workflow	Obtém informações detalhadas sobre um fluxo de trabalho específico, incluindo gatilhos, ações e agendamentos matriculados.
hubspot-generate-feedback-link	Gera uma URL de feedback para relatar problemas, sugerir novos recursos de ferramentas ou fornecer outros comentários relacionados às ferramentas MCP.
hubspot-get-link	Gera uma URL direta da interface do usuário do HubSpot para visualizar registros de CRM específicos em seu portal.