HubSpot MCP Server

Servidor MCP de HubSpot

Descripción general

Una implementación de servidor del Protocolo de Contexto de Modelo (MCP) que proporciona integración con HubSpot CRM. Este servidor permite que los modelos de IA interactúen con los datos y las operaciones de HubSpot a través de una interfaz estandarizada.

Para obtener más información sobre el Protocolo de contexto de modelo y cómo funciona, consulte la documentación MCP de Anthropic .

Componentes

Recursos

El servidor expone los siguientes recursos:

• hubspot://hubspot_contacts : un recurso dinámico que proporciona acceso a los contactos de HubSpot
• hubspot://hubspot_companies : Un recurso dinámico que brinda acceso a las empresas de HubSpot
• hubspot://hubspot_recent_engagements : un recurso dinámico que brinda acceso a las interacciones de HubSpot de los últimos 3 días

Todos los recursos se actualizan automáticamente a medida que se modifican sus respectivos objetos en HubSpot.

Ejemplos de indicaciones

• Crea contactos de Hubspot copiando desde la página web del perfil de LinkedIn:
  Create HubSpot contacts and companies from following: John Doe Software Engineer at Tech Corp San Francisco Bay Area • 500+ connections Experience Tech Corp Software Engineer Jan 2020 - Present · 4 yrs San Francisco, California Previous Company Inc. Senior Developer 2018 - 2020 · 2 yrs Education University of California, Berkeley Computer Science, BS 2014 - 2018
• Conozca las últimas actividades de su empresa:
  What's happening latestly with my pipeline?

Herramientas

El servidor ofrece varias herramientas para administrar objetos de HubSpot:

Herramientas de gestión de contactos

• hubspot_get_contacts
  • Recuperar contactos de HubSpot
  • No se requiere entrada
  • Devuelve: Matriz de objetos de contacto
• hubspot_create_contact
  • Crear un nuevo contacto en HubSpot (verifica si hay duplicados antes de la creación)
  • Aporte:
    • firstname (cadena): Nombre del contacto
    • lastname (cadena): apellido del contacto
    • email (cadena, opcional): dirección de correo electrónico del contacto
    • properties (dict, opcional): Propiedades de contacto adicionales
      • Ejemplo: {"phone": "123456789", "company": "HubSpot"}
  • Comportamiento:
    • Comprueba si existen contactos con el mismo nombre y apellido
    • Si se proporciona company en las propiedades, también se verifican coincidencias con la misma empresa
    • Devuelve los detalles de contacto existentes si se encuentra una coincidencia
    • Crea un nuevo contacto solo si no se encuentra ninguna coincidencia

Herramientas de gestión empresarial

• hubspot_get_companies
  • Recuperar empresas de HubSpot
  • No se requiere entrada
  • Devuelve: Matriz de objetos de la empresa
• hubspot_create_company
  • Crear una nueva empresa en HubSpot (verifica si hay duplicados antes de la creación)
  • Aporte:
    • name (cadena): nombre de la empresa
    • properties (dict, opcional): Propiedades adicionales de la empresa
      • Ejemplo: {"domain": "example.com", "industry": "Technology"}
  • Comportamiento:
    • Comprueba si existen empresas con el mismo nombre
    • Devuelve los detalles de la empresa existente si se encuentra una coincidencia
    • Crea una nueva empresa solo si no se encuentra ninguna coincidencia
• hubspot_get_company_activity
  • Obtener el historial de actividad de una empresa específica
  • Aporte:
    • company_id (cadena): ID de la empresa de HubSpot
  • Devuelve: Matriz de objetos de actividad

Herramientas de participación

• hubspot_get_recent_engagements
  • Obtenga las interacciones de HubSpot de todas las empresas y contactos de los últimos 3 días
  • No se requiere entrada
  • Devoluciones: Matriz de objetos de interacción con metadatos completos

Soporte multiusuario

Este servidor MCP está diseñado para funcionar con varios usuarios de HubSpot, cada uno con su propio token de acceso. El servidor no utiliza una variable de entorno global para el token de acceso.

En su lugar, cada solicitud al servidor MCP debe incluir el token de acceso específico del usuario de una de las siguientes maneras:

1. En el encabezado de la solicitud: X-HubSpot-Access-Token: your-token-here
2. En el cuerpo de la solicitud como accessToken : {"accessToken": "your-token-here"}
3. En el cuerpo de la solicitud como hubspotAccessToken : {"hubspotAccessToken": "your-token-here"}

Este diseño le permite almacenar tokens de usuario en su propio backend (por ejemplo, Supabase) y pasarlos junto con cada solicitud.

Ejemplo de integración multiusuario

Configuración

Prerrequisitos

Necesitarás un token de acceso de HubSpot para cada usuario. Puedes obtenerlo de la siguiente manera:

1. Cómo crear una aplicación privada en tu cuenta de HubSpot: sigue la Guía de aplicaciones privadas de HubSpot
   • Ve a la configuración de tu cuenta de HubSpot
   • Vaya a Integraciones > Aplicaciones privadas
   • Haga clic en "Crear aplicación privada".
   • Complete la información básica:
     • Ponle nombre a tu aplicación
     • Añadir descripción
     • Subir logotipo (opcional)
   • Definir los alcances requeridos:
     • oauth (obligatorio)
   • Ámbitos opcionales:
     • crm.dealsplits.lectura_escritura
     • crm.objects.companies.read
     • crm.objects.companies.write
     • crm.objects.contacts.read
     • crm.objects.contacts.write
     • crm.objects.deals.read
   • Revisar y crear la aplicación
   • Copiar el token de acceso generado

Nota: mantenga su token de acceso seguro y nunca lo comprometa con el control de versiones.

Instalación de Docker

Puedes crear la imagen localmente o descargarla de Docker Hub. La imagen está diseñada para la plataforma Linux.

Plataformas compatibles

• Linux/amd64
• Linux/arm64
• Linux/arm/v7

Opción 1: Extraer desde Docker Hub

Opción 2: Construir localmente

Ejecute el contenedor:

Publicación multiplataforma

Para publicar la imagen de Docker en varias plataformas, puede usar el comando docker buildx . Siga estos pasos:

1. Cree una nueva instancia de constructor (si aún no lo ha hecho):
   docker buildx create --use
2. Construya y envíe la imagen para múltiples plataformas :
   docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t buryhuang/mcp-hubspot:latest --push .
3. Verifique que la imagen esté disponible para las plataformas especificadas :
   docker buildx imagetools inspect buryhuang/mcp-hubspot:latest

Uso con Claude Desktop

Instalación mediante herrería

Para instalar mcp-hubspot para Claude Desktop automáticamente a través de Smithery :

Uso de Docker

Desarrollo

Para configurar el entorno de desarrollo:

Licencia

Este proyecto está licenciado bajo la licencia MIT.