Integración del Servidor MCP de HubSpot

¿Qué hace el Servidor MCP de “HubSpot”?

El Servidor MCP (Model Context Protocol) de HubSpot está diseñado para permitir que los asistentes de IA interactúen directamente con los datos de HubSpot CRM. Actuando como puente entre modelos de IA y tu cuenta de HubSpot, este servidor permite acceso fluido a contactos, empresas y métricas de interacción. Incorpora almacenamiento vectorial integrado (utilizando FAISS) para búsqueda semántica y mecanismos de caché que ayudan a superar las limitaciones de la API de HubSpot, asegurando respuestas más rápidas y fiables. El enfoque está en operaciones CRM de alto valor y uso frecuente, con manejo de errores robusto y optimización amigable para IA. Esto hace que los flujos de trabajo CRM complejos y de varios pasos sean más eficientes y mejora las capacidades de los flujos de desarrollo de IA al proporcionar acceso directo y rico en contexto a datos empresariales.

Lista de Prompts

• (No se encontraron plantillas de prompt explícitas en el repositorio. La sección “Example Prompts” en el README contiene solo ejemplos de prompts de usuario, no plantillas reutilizables.)

Lista de Recursos

(No se describen recursos explícitos en el repositorio ni la documentación. No se listan primitivos de recursos MCP.)

Lista de Herramientas

• hubspot_create_contact
  Crea contactos en HubSpot con lógica de prevención de duplicados.

• hubspot_create_company
  Crea empresas en HubSpot con lógica de prevención de duplicados.

• hubspot_get_company_activity
  Recupera la actividad de empresas específicas.

• hubspot_get_active_companies
  Recupera las empresas más recientemente activas.

• hubspot_get_active_contacts
  Recupera los contactos más recientemente activos.

• hubspot_get_recent_conversations
  Recupera hilos de conversación recientes con mensajes.

• hubspot_search_data
  Búsqueda semántica sobre datos previamente recuperados de HubSpot.

Casos de Uso de este Servidor MCP

• Creación Automática de Contactos
  Permite a los asistentes de IA crear nuevos contactos en HubSpot directamente desde conversaciones, correos electrónicos o textos de perfiles de LinkedIn, agilizando la captación de leads y reduciendo la entrada manual de datos.

• Gestión de Datos de Empresas
  Simplifica el proceso de creación y actualización de perfiles de empresas en HubSpot mediante flujos impulsados por IA, asegurando registros CRM precisos y actualizados.

• Monitoreo de Actividad e Interacción
  Recupera la actividad más reciente de empresas y contactos, permitiendo que equipos de ventas y agentes de IA monitoreen tendencias de interacción y realicen seguimientos de manera más efectiva.

• Análisis de Conversaciones
  Accede y analiza hilos de conversación recientes, permitiendo que la IA resuma interacciones o identifique oportunidades de seguimiento.

• Búsqueda Semántica en CRM
  Usa el almacenamiento vectorial integrado para realizar búsquedas semánticas sobre datos de HubSpot, facilitando que la IA encuentre información relevante en interacciones pasadas y registros CRM.

Cómo configurarlo

Windsurf

1. Asegúrate de tener Docker instalado.
2. Obtén tu token de acceso de HubSpot con los permisos necesarios.
3. En la configuración de Windsurf, localiza la sección para servidores MCP.
4. Añade el servidor MCP de HubSpot utilizando el siguiente fragmento 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. Guarda tu configuración y reinicia Windsurf.
6. Verifica la configuración consultando tus datos de HubSpot vía Windsurf.

Claude

1. Instala Node.js si no está presente.
2. Obtén tu token de acceso de HubSpot.
3. Edita la configuración de Claude para incluir el servidor MCP.
4. Inserta el servidor MCP de HubSpot con:

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

5. Guarda y reinicia Claude.
6. Confirma que el servidor MCP esté listado y respondiendo.

Cursor

1. Instala Docker y Node.js.
2. Obtén el token de acceso de HubSpot.
3. Abre el archivo de configuración de Cursor.
4. Añade esto bajo 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. Guarda los cambios y reinicia Cursor.

Cline

1. Asegúrate de que Docker esté instalado.
2. Obtén el token de acceso de HubSpot.
3. En tu entorno Cline, abre el archivo de configuración correspondiente.
4. Añade:

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

5. Guarda y reinicia Cline.

Protección de Claves API
Es una buena práctica proteger tu token de acceso de HubSpot usando variables de entorno en vez de valores codificados. Ejemplo:

{
  "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"
      }
    }
  }
}

Cómo usar este MCP dentro de los flujos

Uso de MCP en FlowHunt

Para integrar servidores MCP en tu flujo de trabajo en FlowHunt, comienza añadiendo el componente MCP a tu flujo y conectándolo a tu agente de IA:

Haz clic en el componente MCP para abrir el panel de configuración. En la sección de configuración MCP del sistema, inserta los detalles de tu servidor MCP usando este formato JSON:

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

Una vez configurado, el agente de IA podrá usar este MCP como herramienta con acceso a todas sus funciones y capacidades. Recuerda cambiar “hubspot” por el nombre real de tu servidor MCP (por ejemplo, “github-mcp”, “weather-api”, etc.) y reemplazar la URL por la de tu propio servidor MCP.

Resumen

Mi valoración general para el servidor MCP de HubSpot es:
Si bien el servidor es robusto en sus herramientas y documentación para la configuración, la ausencia de plantillas de prompt explícitas y primitivos de recursos MCP limita su flexibilidad para flujos de trabajo de IA avanzados. No se mencionan soporte de sampling ni roots. Es adecuado para uso práctico en CRM, pero se beneficiaría de una mayor cobertura de características MCP.

Puntuación MCP

Puntuación en la tabla MCP: 7/10