Servidor MCP de HubSpot

Una potente implementación de servidor de Protocolo de contexto de modelo (MCP) para una integración perfecta con HubSpot CRM, que permite que los asistentes de IA interactúen con sus datos de HubSpot.

Descripción general

Este servidor MCP proporciona un conjunto completo de herramientas para interactuar con la API de HubSpot CRM, lo que permite a los asistentes de IA:

• Crea y administra contactos y empresas en tu CRM de HubSpot
• Recupere el historial detallado de actividades de la empresa y los cronogramas de participación.
• Acceda a datos de interacción recientes en toda su instancia de HubSpot
• Obtenga listas de empresas y contactos recientemente activos
• Realice operaciones de CRM sin salir de la interfaz de su asistente de IA

¿Por qué utilizar este servidor MCP?

• Integración perfecta con IA : conecta tus asistentes de IA directamente a tus datos de HubSpot CRM
• Operaciones de CRM simplificadas : realice tareas comunes de HubSpot mediante comandos de lenguaje natural
• Acceso a datos en tiempo real : obtenga información actualizada de su instancia de HubSpot
• Autenticación segura : utiliza la autenticación de token de API segura de HubSpot
• Diseño extensible : agregue fácilmente más capacidades de API de HubSpot según sea necesario

Instalación

Configuración

El servidor requiere un token de acceso a la API de HubSpot. Puedes obtenerlo de la siguiente manera:

1. Acceder a su cuenta de desarrollador de HubSpot
2. Creación de una aplicación privada con los alcances necesarios (contactos, empresas, compromisos)
3. Copiar el token de acceso generado

Puedes proporcionar el token de dos maneras:

1. Como variable de entorno:
   HUBSPOT_ACCESS_TOKEN=your-access-token
2. Como argumento de línea de comandos:
   npm start -- --access-token=your-access-token

Para el desarrollo, cree un archivo .env en la raíz del proyecto para almacenar sus variables de entorno:

Uso

Iniciando el servidor

Implementación de la autenticación en el servidor SSE

El servidor SSE utiliza el paquete mcp-proxy-auth para la autenticación. Para implementar la autenticación:

1. Instalar el paquete:
   npm install mcp-proxy-auth
2. Establezca la variable de entorno AUTH_SERVER_URL para que apunte al punto final de verificación de su clave API:
   export AUTH_SERVER_URL=https://your-auth-server.com/verify
3. Ejecute el servidor SSE con autenticación:
   npx mcp-proxy-auth node dist/index.js
4. La URL de SSE estará disponible en:
   localhost:8080/sse?apiKey=apikey
   Reemplace apikey con su clave API real para la autenticación.

El paquete mcp-proxy-auth actúa como un proxy que:

• Intercepta solicitudes a su servidor SSE
• Verifica las claves API con su servidor de autenticación
• Solo permite que las solicitudes autenticadas lleguen a su punto final SSE

Integración con asistentes de IA

Este servidor MCP está diseñado para funcionar con asistentes de IA compatibles con el Protocolo de Contexto de Modelo. Una vez en funcionamiento, el servidor expone un conjunto de herramientas que los asistentes de IA compatibles pueden usar para interactuar con los datos de HubSpot CRM.

Herramientas disponibles

El servidor expone las siguientes potentes herramientas de integración de HubSpot:

1. hubspot_crear_contacto
   • Crear un nuevo contacto en HubSpot con verificación de duplicados
   • Parámetros:
     • firstname (cadena, obligatoria): nombre del contacto
     • lastname (cadena, obligatorio): apellido del contacto
     • email (cadena, opcional): dirección de correo electrónico del contacto
     • properties (objeto, opcional): Propiedades de contacto adicionales como empresa, teléfono, etc.
   • Ejemplo:
     { "firstname": "John", "lastname": "Doe", "email": "john.doe@example.com", "properties": { "company": "Acme Inc", "phone": "555-123-4567", "jobtitle": "Software Engineer" } }
2. hubspot_crear_empresa
   • Crea una nueva empresa en HubSpot con verificación de duplicados
   • Parámetros:
     • name (cadena, obligatorio): nombre de la empresa
     • properties (objeto, opcional): Propiedades adicionales de la empresa
   • Ejemplo:
     { "name": "Acme Corporation", "properties": { "domain": "acme.com", "industry": "Technology", "phone": "555-987-6543", "city": "San Francisco", "state": "CA" } }
3. hubspot_obtener_actividad_de_la_empresa
   • Obtenga un historial de actividad completo para una empresa específica
   • Parámetros:
     • company_id (cadena, obligatoria): ID de la empresa de HubSpot
   • Devuelve datos de participación detallados, incluidos correos electrónicos, llamadas, reuniones, notas y tareas.
4. hubspot_obtener_compromisos_recientes
   • Obtenga actividades de participación recientes en todos los contactos y empresas
   • Parámetros:
     • days (número, opcional, predeterminado: 7): Número de días para mirar hacia atrás
     • limit (número, opcional, predeterminado: 50): número máximo de interacciones a devolver
   • Devuelve una lista cronológica de todas las actividades recientes de CRM
5. empresas activas de hubspot
   • Obtenga las empresas activas más recientes de HubSpot
   • Parámetros:
     • limit (número, opcional, predeterminado: 10): Número máximo de empresas a devolver
   • Devuelve empresas ordenadas por fecha de última modificación
6. hubspot_obtener_contactos_activos
   • Obtenga los contactos activos más recientes de HubSpot
   • Parámetros:
     • limit (número, opcional, predeterminado: 10): Número máximo de contactos a devolver
   • Devuelve contactos ordenados por fecha de última modificación

Ampliación del servidor

El servidor está diseñado para ser fácilmente extensible. Para añadir nuevas funciones de la API de HubSpot:

1. Agregue nuevos métodos a la clase HubSpotClient en src/hubspot-client.ts
2. Registra nuevas herramientas en el método setupToolHandlers en src/index.ts
3. Reconstruir el proyecto con npm run build

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Palabras clave

HubSpot, CRM, Protocolo de Contexto de Modelo, MCP, Asistente de IA, TypeScript, Integración de API, API de HubSpot, Integración de CRM, Gestión de contactos, Gestión de empresas, Seguimiento de interacciones, Herramientas de IA