HubSpot MCP Server

¿Qué es HubSpot MCP Server?

HubSpot MCP Server es una aplicación de servidor ligera que expone las capacidades de HubSpot CRM como herramientas MCP estandarizadas. Con esta integración, los clientes de IA como Claude Desktop, Cursor y otros clientes que son compatibles con el Protocolo de Contexto de Modelo pueden acceder, consultar y modificar datos de HubSpot de forma segura, sin necesidad de integración manual de API o aprender los detalles de la API de HubSpot. Abstrae operaciones complejas de CRM en comandos amigables para flujos de trabajo impulsados por IA y automatización de agentes.

Cómo Configurar HubSpot MCP Server

Instalar Node y NPM: Descarga e instala Node.js y npm desde nodejs.org.
Crear una Aplicación Privada de HubSpot:
- Ve a tu panel de control de HubSpot: Configuración > Integraciones > Aplicaciones Privadas.
- Haz clic en "Crear aplicación privada", dale un nombre, establece los alcances necesarios y copia el token de acceso generado.
Configurar Cliente MCP:
- Para Claude Desktop:
  - Agrega la configuración del servidor de HubSpot con tu token de acceso a tu archivo de configuración de Claude (claude_desktop_config.json) y reinicia la aplicación.
- Para Cursor:
  - Agrega la configuración a .cursor/mcp.json en el directorio de tu proyecto.
- Para otros clientes MCP, sigue sus instrucciones específicas para configurar servidores MCP externos.
Variable de Entorno: Asegúrate de que el PRIVATE_APP_ACCESS_TOKEN esté configurado correctamente en tu configuración.

Cómo Usar HubSpot MCP Server

Después de configurar el servidor, reinicia tu cliente MCP (por ejemplo, Claude Desktop o Cursor).
Ahora puedes acceder a herramientas específicas de HubSpot directamente desde tu cliente de IA. Usa comandos como "Obtén la última actualización sobre Acme Inc." o "Crea un nuevo contacto en mi cuenta de HubSpot".
El agente de IA utilizará herramientas MCP para realizar operaciones del CRM, obtener información y actualizar registros según lo solicitado.
Visita la documentación correspondiente o la página de solución de problemas si encuentras problemas de configuración.

Características Clave

Acceso Unificado: Conéctate a HubSpot desde cualquier cliente compatible con MCP sin manejar manualmente la API.
Amplia Funcionalidad: Realiza una amplia gama de acciones de CRM, desde leer y actualizar registros hasta gestionar asociaciones, flujos de trabajo y compromisos.
Seguro y Flexible: Opera de manera segura utilizando el token de acceso de tu aplicación privada y no requiere exponer credenciales sensibles de HubSpot.
Extensible: Aprovecha un conjunto creciente de herramientas MCP mapeadas a tu flujo de trabajo de HubSpot CRM.
Soporte de Retroalimentación: Genera instantáneamente enlaces de retroalimentación para informar o sugerir mejoras.

Casos de Uso

Información de Datos de CRM: Resume negocios, tickets e interacciones de empresas para inteligencia empresarial instantánea.
Gestión de Contactos y Negocios: Automatiza la creación, actualización y asociación de contactos, empresas, negocios y tickets.
Seguimiento de Actividades: Agrega notas o tareas y realiza un seguimiento de acciones vencidas dentro del CRM.
Análisis de Flujos de Trabajo: Recupera y analiza flujos de trabajo de HubSpot, inscripciones y programación.
Gestión de Propiedades Personalizadas: Lista, crea y actualiza propiedades personalizadas en objetos de CRM programáticamente.

Preguntas Frecuentes

Q1: ¿Qué permisos necesito en mi aplicación privada de HubSpot para usar el servidor MCP?
A: Se recomienda comenzar con alcances de solo lectura para la configuración inicial. A medida que amplíes tu uso, concede solo los alcances necesarios para las operaciones deseadas (por ejemplo, lectura/escritura de objetos CRM, acceso a compromisos, gestión de propiedades).

Q2: ¿Mis datos de HubSpot están seguros cuando uso el servidor MCP?
A: Sí. El servidor MCP opera completamente dentro de tu infraestructura y solo utiliza el token de acceso de tu aplicación privada configurada. No se almacenan ni se exponen credenciales de HubSpot o datos sensibles más allá de tu configuración.

Q3: ¿Puedo usar HubSpot MCP Server con múltiples aplicaciones cliente MCP?
A: Sí, puedes agregar la configuración del servidor a cualquier cliente compatible con MCP, como Claude Desktop o Cursor, y acceder a las herramientas de HubSpot en cada uno.

Q4: ¿Cómo puedo proporcionar retroalimentación o informar un problema con las herramientas MCP?
A: Utiliza la herramienta hubspot-generate-feedback-link para generar una URL de retroalimentación, o usa el comando dedicado en tu cliente MCP.

Q5: ¿Qué tipo de acciones puedo automatizar usando agentes de IA con este servidor?
A: Puedes automatizar todo, desde la creación y actualización de registros en masa hasta la generación de informes, gestión de asociaciones y seguimiento de compromisos, todo a través de comandos en lenguaje natural.

Nombre del Protocolo	Descripción
hubspot-get-user-details	Autentica el token de acceso de la aplicación privada de HubSpot actual y recupera información del usuario, detalles del portal, alcances autorizados y metadatos de la cuenta.
hubspot-list-objects	Recupera una lista paginada de registros de CRM para un tipo de objeto específico (por ejemplo, contactos, empresas, negocios o tickets).
hubspot-search-objects	Realiza búsquedas filtradas en tu CRM de HubSpot utilizando criterios personalizados y filtros basados en propiedades en diferentes tipos de registros.
hubspot-batch-create-objects	Crea múltiples registros de CRM de un tipo de objeto en una sola llamada, agilizando el ingreso masivo y los flujos de trabajo de incorporación.
hubspot-batch-update-objects	Actualiza varios registros de CRM existentes con nuevos valores de propiedades en una sola operación.
hubspot-batch-read-objects	Recupera múltiples registros de CRM por sus IDs en una llamada, optimizando el rendimiento para consultas por lotes.
hubspot-get-schemas	Lista las esquemas de objetos personalizados disponibles, mostrando objectTypeIds y sus definiciones para una personalización avanzada del CRM.
hubspot-list-properties	Lista todas las definiciones de propiedades para cualquier tipo de objeto de HubSpot CRM, brindando información sobre esquemas y campos personalizados.
hubspot-get-property	Obtiene metadatos detallados sobre una definición de propiedad específica del CRM.
hubspot-create-property	Crea una nueva propiedad personalizada para un tipo de objeto de CRM específico.
hubspot-update-property	Actualiza la configuración y los ajustes de una propiedad personalizada existente.
hubspot-create-association	Establece o actualiza relaciones entre registros de CRM (como asociar un contacto con una empresa).
hubspot-list-associations	Recupera todas las asociaciones entre un registro de CRM específico y cualquier registro relacionado.
hubspot-get-association-definitions	Proporciona una lista de tipos y etiquetas de asociación válidos entre tipos de objetos de CRM específicos.
hubspot-create-engagement	Crea un nuevo compromiso, como una nota o tarea, asociándolo con contactos, empresas, negocios o tickets relevantes.
hubspot-get-engagement	Recupera detalles de compromiso para un ID de compromiso específico.
hubspot-update-engagement	Actualiza detalles o propiedades de un compromiso existente.
hubspot-list-workflows	Recupera y lista los flujos de trabajo disponibles configurados en tu cuenta de HubSpot.
hubspot-get-workflow	Obtiene información detallada sobre un flujo de trabajo específico, incluidos triggers, acciones y programación inscritos.
hubspot-generate-feedback-link	Genera una URL de retroalimentación para informar problemas, sugerir nuevas características de herramientas o proporcionar comentarios sobre las herramientas MCP.
hubspot-get-link	Genera una URL directa de la IU de HubSpot para ver registros específicos de CRM en tu portal.