Un MCP server afinado para equipos de customer success que usan HubSpot. Expone contacts, companies, tickets y deals como herramientas de Claude, con helpers específicos de CS para queries de fecha de renovación, aging de tickets y lecturas de health-score. El CSM pregunta “qué está en riesgo este mes” y Claude jala los datos reales.

Lo que vas a necesitar

HubSpot Sales Hub Pro o superior, con Service Hub para tickets
Un token de Private App de HubSpot con scopes de lectura para contacts, companies, deals y tickets
Claude Desktop o Claude Code como cliente MCP
Una convención de campo de health-score acordada con tu liderazgo de CS

Setup

Corre el server. La implementación de referencia es Python, estilo FastAPI. Clona, instala, configura HUBSPOT_TOKEN y HUBSPOT_PORTAL_ID. El server arranca en stdio para Claude Desktop local o en HTTP para clientes hosted.
Configura las herramientas helper. Tres helpers específicos de CS vienen por defecto: at_risk_renewals, aging_tickets, accounts_needing_qbr. Cada una mapea a una query parametrizada de HubSpot. Edita las plantillas de query para que coincidan con tus campos.
Agrega al config del cliente MCP. Apunta Claude Desktop al server. Al arrancar deberías ver alrededor de doce herramientas registradas.
Configura el campo de health-score. La mayoría de los equipos usan una propiedad numérica custom. Pasa su nombre interno al server para que los helpers puedan filtrar sobre ella.
Corre “muéstrame las renovaciones en riesgo en los próximos noventa días”. Verifica la salida contra la misma query en la UI de HubSpot.

Cómo funciona

El server es de lectura mayoritaria por diseño. Los workflows de CS son sobre saber qué está pasando, no sobre mutación masiva de registros. La superficie de herramientas por defecto incluye lecturas de objeto, recorrido de asociaciones (contact a company a deals a tickets) y los tres helpers específicos de CS.

Las escrituras se limitan a creación de tickets y notas. Sin cambios de stage de deal, sin merges de contactos, sin updates de propiedades en companies. El principio: Claude puede preguntar, resumir y documentar, pero el CSM sigue manejando los cambios reales hacia el cliente.

Cuídate de

Drift del campo de health-score. Los equipos cambian la fórmula cada trimestre. El server no cachea nada; las queries pegan la propiedad en vivo. Actualiza los docs de los helpers cuando la fórmula cambie para que los prompts sigan siendo precisos.
Volumen de tickets. Las queries de aging-tickets pueden devolver miles de filas en portales activos. El helper pagina y limita a quinientos por defecto. Ajusta para tu volumen.
Joins entre objetos. La API de associations de HubSpot es más lenta que las queries directas. El server agrupa associations pero un recorrido de deal-a-tickets a través de mil deals tarda minutos, no segundos.
Permisos. Los tokens de Private App brincan los permisos a nivel usuario. Cualquiera con acceso al cliente MCP ve toda la data. Documéntalo claro con tu equipo de seguridad.

Stack

HubSpot — fuente de verdad de CRM y ticketing
MCP server — capa de lectura, herramientas helper, superficie ligera de escritura
Claude — interfaz de lenguaje natural para el equipo de CS