Integração do HubSpot MCP Server

O que faz o “HubSpot” MCP Server?

O HubSpot MCP (Model Context Protocol) Server foi projetado para permitir que assistentes de IA interajam diretamente com dados do HubSpot CRM. Atuando como uma ponte entre modelos de IA e sua conta HubSpot, este servidor proporciona acesso contínuo a contatos, empresas e métricas de engajamento. Ele incorpora armazenamento vetorial integrado (usando FAISS) para busca semântica e mecanismos de cache que ajudam a contornar limitações da API do HubSpot, garantindo respostas mais rápidas e confiáveis. O foco está em operações de CRM de alto valor e uso frequente, com tratamento robusto de erros e otimização amigável para IA. Isso torna fluxos de CRM complexos e em múltiplas etapas mais eficientes e potencializa o desenvolvimento de IA ao fornecer acesso direto, contextualizado e rico aos dados do negócio.

Lista de Prompts

• (Nenhum template de prompt explícito encontrado no repositório. A seção “Exemplo de Prompts” no README contém apenas exemplos de prompts de usuário, não templates reutilizáveis.)

Lista de Recursos

(Nenhum recurso explícito é descrito no repositório ou documentação. Não há primitivas de recurso MCP listadas.)

Lista de Ferramentas

• hubspot_create_contact
  Crie contatos do HubSpot com lógica de prevenção de duplicatas.

• hubspot_create_company
  Crie empresas do HubSpot com lógica de prevenção de duplicatas.

• hubspot_get_company_activity
  Recupere atividades de empresas específicas.

• hubspot_get_active_companies
  Recupere as empresas mais recentemente ativas.

• hubspot_get_active_contacts
  Recupere os contatos mais recentemente ativos.

• hubspot_get_recent_conversations
  Recupere conversas recentes com mensagens.

• hubspot_search_data
  Busca semântica nos dados do HubSpot previamente obtidos.

Casos de Uso deste MCP Server

• Criação Automatizada de Contatos
  Permite que assistentes de IA criem novos contatos no HubSpot diretamente de conversas, e-mails ou textos de perfil do LinkedIn, agilizando a captação de leads e reduzindo o trabalho manual.

• Gestão de Dados de Empresas
  Simplifica o processo de criação e atualização de perfis de empresas no HubSpot através de fluxos de trabalho movidos por IA, garantindo registros precisos e atualizados no CRM.

• Monitoramento de Atividades e Engajamento
  Recupere as atividades mais recentes de empresas e contatos, permitindo que equipes de vendas e agentes de IA monitorem tendências de engajamento e realizem follow-up de maneira mais eficaz.

• Análise de Conversas
  Acesse e analise conversas recentes, permitindo que a IA resuma interações ou identifique oportunidades de follow-up.

• Busca Semântica no CRM
  Use o armazenamento vetorial integrado para realizar buscas semânticas nos dados do HubSpot, facilitando para a IA encontrar informações relevantes em interações e registros anteriores do CRM.

Como configurar

Windsurf

1. Certifique-se de ter o Docker instalado.
2. Obtenha seu token de acesso do HubSpot com os escopos necessários.
3. Na configuração do Windsurf, localize a seção de servidores MCP.
4. Adicione o servidor HubSpot MCP usando o seguinte trecho JSON:

   {
     "mcpServers": {
       "hubspot": {
         "command": "docker",
         "args": [
           "run", "-i", "--rm",
           "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
           "-v", "/path/to/storage:/storage",
           "buryhuang/mcp-hubspot:latest"
         ]
       }
     }
   }
   

5. Salve sua configuração e reinicie o Windsurf.
6. Verifique a configuração consultando seus dados do HubSpot via Windsurf.

Claude

1. Instale o Node.js se ainda não estiver instalado.
2. Obtenha seu token de acesso do HubSpot.
3. Edite a configuração do Claude para incluir o servidor MCP.
4. Insira o servidor HubSpot MCP com:

   {
     "mcpServers": {
       "hubspot": {
         "command": "docker",
         "args": [
           "run", "-i", "--rm",
           "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
           "-v", "/path/to/storage:/storage",
           "buryhuang/mcp-hubspot:latest"
         ]
       }
     }
   }
   

5. Salve e reinicie o Claude.
6. Confirme que o servidor MCP está listado e respondendo.

Cursor

1. Instale Docker e Node.js.
2. Obtenha o token de acesso do HubSpot.
3. Abra o arquivo de configuração do Cursor.
4. Adicione isto em mcpServers:

   {
     "mcpServers": {
       "hubspot": {
         "command": "docker",
         "args": [
           "run", "-i", "--rm",
           "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
           "-v", "/path/to/storage:/storage",
           "buryhuang/mcp-hubspot:latest"
         ]
       }
     }
   }
   

5. Salve as alterações e reinicie o Cursor.

Cline

1. Certifique-se de que o Docker está instalado.
2. Adquira o token de acesso do HubSpot.
3. No seu ambiente Cline, abra o arquivo de configuração relevante.
4. Adicione:

   {
     "mcpServers": {
       "hubspot": {
         "command": "docker",
         "args": [
           "run", "-i", "--rm",
           "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
           "-v", "/path/to/storage:/storage",
           "buryhuang/mcp-hubspot:latest"
         ]
       }
     }
   }
   

5. Salve e reinicie o Cline.

Protegendo Chaves de API
É uma prática recomendada proteger seu token de acesso do HubSpot usando variáveis de ambiente em vez de inserir valores diretamente. Exemplo:

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "HUBSPOT_ACCESS_TOKEN=${HUBSPOT_ACCESS_TOKEN}",
        "-v", "/path/to/storage:/storage",
        "buryhuang/mcp-hubspot:latest"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your_token"
      }
    }
  }
}

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração MCP do sistema, insira os detalhes do seu servidor MCP usando este formato JSON:

{
  "hubspot": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Após configurar, o agente de IA já poderá usar este MCP como ferramenta com acesso a todas as suas funções e capacidades. Lembre-se de alterar “hubspot” para o nome real do seu servidor MCP (por exemplo, “github-mcp”, “weather-api” etc.) e substituir a URL pela do seu próprio servidor MCP.

Visão Geral

Minha avaliação geral para o HubSpot MCP server é:
Embora o servidor seja robusto em suas ferramentas e documentação de configuração, a ausência de templates de prompt explícitos e primitivas de recursos MCP limita sua flexibilidade para fluxos avançados de IA. Suporte a amostragem e roots não são mencionados. É adequado para uso prático em CRM, mas poderia se beneficiar de uma cobertura mais ampla de recursos MCP.

Pontuação MCP

Pontuação da Tabela MCP: 7/10