Servidor MCP de HubSpot

Descripción general

Este proyecto implementa un servidor de Protocolo de Contexto de Modelo (MCP) que se integra con HubSpot CRM y ahora incluye una función de espacio compartido centralizado. El servidor permite que los modelos de IA interactúen con los datos y las operaciones de HubSpot a través de una interfaz estandarizada, a la vez que permite a los equipos compartir resúmenes de conversaciones clave en tiempo real.

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. En última instancia, el sistema se rige por las herramientas.

Ejemplos de indicaciones

Crea contactos de HubSpot copiando desde una página web de perfil de LinkedIn:

# Example YAML prompt
- 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:

# Example VB.NET prompt
- What's happening latestly with my pipeline?

Ejemplo de espacio compartido:

Después de una reunión, un cuadro de comando de IA solicita: "¿Qué es el resumen de la conversación de la empresa en el espacio compartido? (Sí/No)" Tras la confirmación, el resumen de la conversación se almacena de forma central y es accesible para todos los gerentes autorizados de su empresa.

Herramientas

El servidor ofrece varias herramientas para administrar objetos de HubSpot junto con nuevas herramientas de espacio compartido:

Herramientas de gestión de contactos

hubspot_create_contact
- Crear un nuevo contacto en HubSpot (con verificación de duplicados).
- Entradas:
  - nombre (cadena)
  - apellido (cadena)
  - correo electrónico (cadena, opcional)
  - propiedades (dict, opcional; p. ej., {"teléfono": "123456789", "empresa": "HubSpot"})

Herramientas de gestión empresarial

hubspot_create_company
- Crear una nueva empresa en HubSpot (con verificación de duplicados).
- Entradas:
  - nombre (cadena)
  - propiedades (dict, opcional)
hubspot_get_company_activity
- Recupere el historial de actividad de una empresa específica.
- Aporte:
  - company_id (cadena)

Herramientas de participación

hubspot_get_recent_engagements
- Recuperar actividades de participación recientes.
- Entradas:
  - días (entero, predeterminado 7)
  - límite (entero, predeterminado 50)
hubspot_get_recent_companies
- Recuperar empresas activas más recientemente.
- Aporte:
  - límite (entero, predeterminado 10)
hubspot_get_recent_contacts
- Recuperar los contactos activos más recientes.
- Aporte:
  - límite (entero, predeterminado 10)

Herramientas de espacio compartido

create_shared_summary
- Crea un nuevo resumen de conversación en el espacio compartido.
- Entradas:
  - user_id (cadena, el correo electrónico/ID del usuario)
  - company_id (cadena)
  - resumen (cadena)
get_shared_summaries
- Recupere todos los resúmenes de conversaciones de una empresa determinada.
- Entradas:
  - user_id (cadena)
  - company_id (cadena)

Estas herramientas de espacio compartido permiten a los gerentes autorizados compartir resúmenes de reuniones, lo que posibilita la colaboración del equipo en tiempo real y el acceso centralizado a información clave.

Configuración

Instalación mediante herrería

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

npx -y @smithery/cli install buryhuang/mcp-hubspot --client claude

Prerrequisitos

Necesitarás un token de acceso de HubSpot. Obtén uno creando una aplicación privada en tu cuenta de HubSpot (consulta la Guía de aplicaciones privadas de HubSpot). Mantén tu token seguro.

Instalación de Docker

Opción 1: Extraer desde Docker Hub

docker pull buryhuang/mcp-hubspot:latest

Opción 2: Construir localmente

docker build -t mcp-hubspot .

Ejecute el contenedor:

docker run -e HUBSPOT_ACCESS_TOKEN=your_access_token_here buryhuang/mcp-hubspot:latest

O pasar el token como argumento:

docker run buryhuang/mcp-hubspot:latest --access-token your_access_token_here

Publicación multiplataforma

Crear una nueva instancia de constructor:

docker buildx create --use

Construir y promocionar para múltiples plataformas:

docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t buryhuang/mcp-hubspot:latest --push .

Verificar la imagen:

docker buildx imagetools inspect buryhuang/mcp-hubspot:latest

Uso con Claude Desktop

Instalación mediante herrería

npx -y @smithery/cli@latest install mcp-hubspot --client claude

Uso de Docker

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HUBSPOT_ACCESS_TOKEN=your_access_token_here",
        "buryhuang/mcp-hubspot:latest"
      ]
    }
  }
}

O usando el argumento de la línea de comandos:

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "buryhuang/mcp-hubspot:latest",
        "--access-token",
        "your_access_token_here"
      ]
    }
  }
}

Desarrollo

Para configurar el entorno de desarrollo:

pip install -e .

Integración de espacios compartidos

La funcionalidad de espacio compartido se implementa en un módulo independiente (shared_space.py). Este módulo:

Carga roles de usuario dinámicos (desde un archivo JSON externo o una base de datos).
Implementa puntos finales CRUD (create_summary, get_summaries, update_summary y delete_summary) para resúmenes de conversaciones.
Activa un marcador de notificación en tiempo real (que luego puedes integrar con SSE o WebSockets).

El archivo principal server.py importa estas funciones y las registra como nuevas herramientas MCP (create_shared_summary y get_shared_summaries).

Licencia

Este proyecto está licenciado bajo la licencia MIT.

Este README actualizado ahora refleja la funcionalidad adicional del espacio compartido mediante la integración de HubSpot MCP y explica cómo se estructura y utiliza el sistema.

HubSpot MCP Server

Integrations