Servidor MCP de HubSpot

Descripción general

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA interactuar con los datos de HubSpot CRM. Este servidor conecta los modelos de IA con tu cuenta de HubSpot, proporcionando acceso directo a contactos, empresas y datos de interacción. Los mecanismos integrados de almacenamiento vectorial y caché ayudan a superar las limitaciones de la API de HubSpot y a mejorar los tiempos de respuesta.

Nuestra implementación prioriza las operaciones de HubSpot más utilizadas y de mayor valor, con un sólido manejo de errores y estabilidad de la API. Cada componente está optimizado para interacciones compatibles con IA, lo que garantiza un rendimiento fiable incluso en flujos de trabajo de CRM complejos y de varios pasos.

Related MCP server: HubSpot MCP

¿Por qué MCP-HubSpot?

• Acceso directo a CRM : conecta a Claude y otros asistentes de IA a tus datos de HubSpot sin pasos intermedios

• Retención de contexto : el almacenamiento vectorial con FAISS permite la búsqueda semántica en interacciones anteriores

• Configuración cero : implementación sencilla de Docker con una configuración mínima

Ejemplos de indicaciones

Create HubSpot contacts and companies from this LinkedIn profile:
[Paste LinkedIn profile text]

What's happening lately with my pipeline?

Herramientas disponibles

El servidor ofrece herramientas para la gestión de HubSpot y la recuperación de datos:

Características de rendimiento

• Almacenamiento vectorial : utiliza FAISS para una búsqueda y recuperación semántica eficiente

• Indexación a nivel de hilo : almacena cada hilo de conversación individualmente para una recuperación precisa

• Incorporación de almacenamiento en caché : utiliza SentenceTransformer con almacenamiento en caché automático

• Almacenamiento persistente : los datos persisten entre sesiones en un directorio de almacenamiento configurable

• Compatibilidad multiplataforma : imágenes Docker optimizadas para diversas arquitecturas

Configuración

Prerrequisitos

Necesitarás un token de acceso de HubSpot con estos alcances:

• crm.objects.contacts (lectura/escritura)

• crm.objects.companies (lectura/escritura)

• correo electrónico de ventas leído

Inicio rápido

# Install via Smithery (recommended)
npx -y @smithery/cli@latest install mcp-hubspot --client claude

# Or pull Docker image directly
docker run -e HUBSPOT_ACCESS_TOKEN=your_token buryhuang/mcp-hubspot:latest

Configuración de Docker

Para la configuración manual en el escritorio de Claude:

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
        "-v", "/path/to/storage:/storage",  # Optional persistent storage
        "buryhuang/mcp-hubspot:latest"
      ]
    }
  }
}

Construyendo una imagen de Docker

Para construir la imagen de Docker localmente:

git clone https://github.com/buryhuang/mcp-hubspot.git
cd mcp-hubspot
docker build -t mcp-hubspot .

Para compilaciones multiplataforma:

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

Desarrollo

pip install -e .

Licencia

Licencia MIT