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

No se implementan recursos. Al final, solo necesitamos herramientas.

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_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_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 actividades de participación recientes en todos los contactos y empresas
  • Aporte:
    • days (entero, opcional): Número de días para mirar atrás (predeterminado: 7)
    • limit (entero, opcional): número máximo de interacciones a devolver (valor predeterminado: 50)
  • Devoluciones: Matriz de objetos de interacción con metadatos completos
• hubspot_get_recent_companies
  • Obtenga las empresas activas más recientes de HubSpot
  • Aporte:
    • limit (entero, opcional): número máximo de empresas a devolver (predeterminado: 10)
  • Devuelve: Matriz de objetos de la empresa con metadatos completos
• hubspot_get_recent_contacts
  • Obtenga los contactos activos más recientes de HubSpot
  • Aporte:
    • limit (entero, opcional): número máximo de contactos a devolver (predeterminado: 10)
  • Devuelve: Matriz de objetos de contacto con metadatos completos

Configuración

Instalación mediante herrería

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

Prerrequisitos

Necesitarás un token de acceso de HubSpot. 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:
     • entradas
     • crm.objects.contacts.write
     • crm.objetos.contactos.sensibles.leer
     • crm.objects.empresas.sensibles.leer
     • correo electrónico de ventas leído
     • crm.objects.deals.sensible.read
     • crm.objects.companies.write
     • crm.objects.companies.read
     • crm.objects.deals.read
     • crm.objects.deals.write
     • crm.objects.contacts.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:

También puedes pasar el token de acceso directamente como un argumento de línea de comando:

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

También puede utilizar el argumento de la línea de comandos:

Desarrollo

Para configurar el entorno de desarrollo:

Licencia

Este proyecto está licenciado bajo la licencia MIT.