Um MCP server afinado pra times de customer success que usam HubSpot. Expõe contacts, companies, tickets e deals como ferramentas do Claude, com helpers específicos de CS pra queries de data de renovação, aging de tickets e leituras de health-score. O CSM pergunta “o que está em risco esse mês” e o Claude puxa os dados reais.

O que você vai precisar

HubSpot Sales Hub Pro ou superior, com Service Hub pra tickets
Um token de Private App do HubSpot com scopes de leitura pra contacts, companies, deals e tickets
Claude Desktop ou Claude Code como cliente MCP
Uma convenção de campo de health-score acordada com sua liderança de CS

Setup

Rode o server. A implementação de referência é Python, estilo FastAPI. Clone, instale, configure HUBSPOT_TOKEN e HUBSPOT_PORTAL_ID. O server sobe em stdio pra Claude Desktop local ou em HTTP pra clientes hosted.
Configure as ferramentas helper. Três helpers específicos de CS vêm por padrão: at_risk_renewals, aging_tickets, accounts_needing_qbr. Cada um mapeia pra uma query parametrizada do HubSpot. Edite os templates de query pra bater com seus campos.
Adicione na config do cliente MCP. Aponte o Claude Desktop pro server. Ao subir você deveria ver cerca de doze ferramentas registradas.
Configure o campo de health-score. A maioria dos times usa uma propriedade numérica custom. Passe o nome interno pro server pra que os helpers consigam filtrar.
Rode “me mostre as renovações em risco nos próximos noventa dias”. Confira a saída contra a mesma query na UI do HubSpot.

Como funciona

O server é majoritariamente de leitura por design. Workflows de CS são sobre saber o que está acontecendo, não sobre mutação massiva de registros. A superfície de ferramentas padrão inclui leituras de objeto, traversal de associations (contact pra company pra deals pra tickets) e os três helpers específicos de CS.

Escritas são limitadas a criação de tickets e notas. Sem mudanças de stage de deal, sem merges de contatos, sem updates de propriedade em companies. O princípio: o Claude pode perguntar, resumir e documentar, mas o CSM ainda dirige as mudanças voltadas ao cliente.

Pontos de atenção

Drift do campo de health-score. Times mudam a fórmula a cada trimestre. O server não cacheia nada; queries batem na propriedade ao vivo. Atualize os docs dos helpers quando a fórmula mudar pra que prompts continuem precisos.
Volume de tickets. Queries de aging-tickets podem retornar milhares de linhas em portais ativos. O helper pagina e limita em quinhentos por padrão. Ajuste pro seu volume.
Joins entre objetos. A API de associations do HubSpot é mais lenta que queries diretas. O server faz batching de associations mas um traversal deal-pra-tickets em cima de mil deals leva minutos, não segundos.
Permissões. Tokens de Private App passam por cima de permissões a nível usuário. Qualquer um com acesso ao cliente MCP enxerga todos os dados. Documente claramente com seu time de segurança.

Stack

HubSpot — fonte de verdade de CRM e ticketing
MCP server — camada de leitura, ferramentas helper, superfície leve de escrita
Claude — interface de linguagem natural pro time de CS