Servidor MCP de HubSpot

Servidor MCP para la API de HubSpot, que permite a Claude interactuar con HubSpot CRM para realizar análisis y obtener información de ventas.

Descargo de responsabilidad

Este proyecto de código abierto no está afiliado ni respaldado por HubSpot. Es una implementación independiente que interactúa con la API de HubSpot.

Herramientas

Herramientas principales de CRM

1. hubspot_search_contacts
   • Buscar contactos en HubSpot usando una cadena de consulta
   • Entradas requeridas:
     • query (cadena): cadena de consulta de búsqueda (correo electrónico, nombre, etc.)
   • Entradas opcionales:
     • count (número, predeterminado: 10): Número máximo de contactos a devolver
     • propertyList (matriz): Lista de propiedades que se incluirán en los resultados
   • Devuelve: Lista de contactos coincidentes con sus propiedades
2. hubspot_get_contact
   • Obtener un contacto específico por ID
   • Entradas requeridas:
     • contactId (cadena): El ID del contacto a recuperar
   • Entradas opcionales:
     • properties (matriz): Lista de propiedades que se incluirán en los resultados
   • Devoluciones: Datos de contacto con propiedades específicas
3. hubspot_create_contact
   • Crear un nuevo contacto en HubSpot
   • Entradas requeridas:
     • properties (objeto): Propiedades de contacto con al menos un campo email
   • Devoluciones: Datos de contacto creados
4. hubspot_update_contact
   • Actualizar un contacto existente en HubSpot
   • Entradas requeridas:
     • contactId (cadena): El ID del contacto a actualizar
     • properties (objeto): Contacte con propiedades para actualizar
   • Devoluciones: Confirmación de contacto actualizada
5. hubspot_list_deals
   • Listar ofertas en HubSpot con paginación
   • Entradas opcionales:
     • limit (número, predeterminado: 10, máximo: 100): Número máximo de ofertas a devolver
     • after (cadena): cursor de paginación para la página siguiente
     • properties (matriz): Lista de propiedades que se incluirán en los resultados
   • Devoluciones: Listado de ofertas con sus detalles
6. hubspot_get_deal
   • Obtenga una oferta específica por identificación
   • Entradas requeridas:
     • dealId (cadena): El ID del acuerdo a recuperar
   • Entradas opcionales:
     • properties (matriz): Lista de propiedades que se incluirán en los resultados
   • Devoluciones: Detalles del trato con propiedades específicas
7. hubspot_create_deal
   • Crear un nuevo trato en HubSpot
   • Entradas requeridas:
     • properties (objeto): Tratar propiedades con al menos el campo dealname
   • Devoluciones: Detalles de la oferta creada
8. hubspot_update_deal
   • Actualizar un trato existente en HubSpot
   • Entradas requeridas:
     • dealId (cadena): El ID del acuerdo que se actualizará
     • properties (objeto): Tratar propiedades para actualizar
   • Devoluciones: Confirmación de oferta actualizada
9. hubspot_list_companies
   • Listar empresas en HubSpot con paginación
   • Entradas opcionales:
     • limit (número, predeterminado: 10, máximo: 100): Número máximo de empresas a devolver
     • after (cadena): cursor de paginación para la página siguiente
     • properties (matriz): Lista de propiedades que se incluirán en los resultados
   • Devoluciones: Listado de empresas con sus datos
10. hubspot_get_company

• Obtener una empresa específica por ID
• Entradas requeridas:
  • companyId (cadena): El ID de la empresa a recuperar
• Entradas opcionales:
  • properties (matriz): Lista de propiedades que se incluirán en los resultados
• Devoluciones: Detalles de la empresa con propiedades específicas

Herramientas de análisis de ventas

11. hubspot_get_sales_analytics

• Obtenga datos analíticos de ventas agregados para períodos de tiempo específicos
• Entradas requeridas:
  • period (cadena): período de tiempo para agrupar los datos analíticos (diario, semanal, mensual, trimestral, anual)
  • startDate (cadena): Fecha de inicio del análisis en formato ISO (AAAA-MM-DD)
• Entradas opcionales:
  • endDate (cadena): Fecha de finalización del análisis en formato ISO
  • pipeline (cadena): ID de pipeline por el que filtrar
  • dealStage (cadena): ID de la etapa del acuerdo por el que filtrar
  • dealOwner (cadena): ID del propietario del acuerdo por el que filtrar
• Devoluciones: Métricas de ventas agregadas agrupadas por período de tiempo

12. hubspot_get_deal_history

• Obtenga el historial completo de cambios en un acuerdo
• Entradas requeridas:
  • dealId (cadena): El ID del trato del que se obtendrá el historial
• Devoluciones: Historial de cambios en el acuerdo con marcas de tiempo y propiedades modificadas

13. hubspot_get_deal_notes

• Obtener notas asociadas con un acuerdo específico
• Entradas requeridas:
  • dealId (cadena): El ID del trato para el que se obtendrán notas
• Entradas opcionales:
  • limit (número, predeterminado: 20): número máximo de notas a devolver
  • after (cadena): cursor de paginación para la siguiente página de resultados
• Devuelve: Lista de notas con su contenido y marcas de tiempo de creación

14. hubspot_get_engagements_by_deal

• Obtenga todas las actividades de participación asociadas con un acuerdo
• Entradas requeridas:
  • dealId (cadena): El ID del acuerdo para el que se obtendrán interacciones
• Entradas opcionales:
  • types (matriz): tipos de compromisos a incluir (LLAMADA, CORREO ELECTRÓNICO, REUNIÓN, TAREA, NOTA)
  • limit (número, predeterminado: 20): número máximo de interacciones a devolver
  • after (cadena): cursor de paginación para la siguiente página de resultados
• Devoluciones: Listado de compromisos con sus detalles e información de tipo

15. hubspot_get_sales_performance

• Obtenga métricas de rendimiento de los representantes de ventas durante un período de tiempo específico
• Entradas requeridas:
  • period (cadena): período de tiempo para agrupar los datos de rendimiento por (diario, semanal, mensual, trimestral, anual)
  • startDate (cadena): Fecha de inicio del análisis en formato ISO (AAAA-MM-DD)
• Entradas opcionales:
  • endDate (cadena): Fecha de finalización del análisis en formato ISO
  • ownerIds (matriz): lista de ID de propietarios que se incluirán en el análisis
  • pipeline (cadena): ID de pipeline por el que filtrar
• Devoluciones: métricas de rendimiento para cada representante de ventas, incluidos recuentos de acuerdos, ingresos y tasas de ganancia

16. hubspot_get_pipeline_analytics

• Obtenga análisis de un canal de ventas específico, incluidas las tasas de conversión entre etapas
• Entradas requeridas:
  • pipelineId (cadena): El ID de la tubería a analizar
  • period (cadena): período de tiempo para agrupar los datos analíticos (diario, semanal, mensual, trimestral, anual)
  • startDate (cadena): Fecha de inicio del análisis en formato ISO (AAAA-MM-DD)
• Entradas opcionales:
  • endDate (cadena): Fecha de finalización del análisis en formato ISO
• Devoluciones: métricas de la etapa del pipeline que incluyen recuentos de transacciones, valores, tasas de conversión y tiempo en la etapa

17. hubspot_get_forecast_analytics

• Obtenga datos de ventas pronosticados según el flujo de trabajo actual y el rendimiento histórico
• Entradas requeridas:
  • period (cadena): período de tiempo para agrupar los datos de pronóstico por (mensual, trimestral, anual)
• Entradas opcionales:
  • numberOfPeriods (número, predeterminado: 3): Número de períodos futuros a pronosticar
  • pipeline (cadena): ID de pipeline por el que filtrar
• Devoluciones: Métricas de ventas previstas para períodos futuros basadas en datos históricos y el pipeline actual

Configuración

1. Crear una aplicación privada de HubSpot:
   • Ve a tu cuenta de HubSpot
   • Vaya a Configuración → Configuración de cuenta → Integraciones → Aplicaciones privadas
   • Haga clic en "Crear aplicación privada".
   • Ponle un nombre a tu aplicación y establece los alcances apropiados (contactos, ofertas y empresas)
   • Crea la aplicación y copia tu token de aplicación privada
2. Alcances requeridos:
   • crm.objects.contacts.read
   • crm.objects.contacts.write
   • crm.objects.deals.read
   • crm.objects.deals.write
   • crm.objects.companies.read
   • crm.objects.companies.write
   • crm.objects.owners.read
   • crm.objects.quotes.read
   • crm.objects.line_items.read
   • crm.objects.custom.read
   • crm.schemas.deals.read
   • crm.schemas.contacts.read
   • crm.schemas.companies.read
   • crm.schemas.custom.read

Uso con Claude Desktop

Agregue lo siguiente a su claude_desktop_config.json :

npx

estibador

Solución de problemas

Si encuentra errores, verifique que:

1. Todos los alcances necesarios se agregan a su aplicación privada de HubSpot
2. La clave API se ha copiado correctamente en su configuración
3. Tu plan de HubSpot incluye acceso a las API que intentas usar

Construir

Compilación de Docker:

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.