HubSpot com a ALTARA e a sua IA
A ALTARA lê um pipeline no HubSpot da sua empresa, só com acesso de leitura, e está em implantação com as primeiras empresas. Ela responde a partir dos seus negócios e propõe cada mudança, e você faz a mudança no HubSpot. O servidor MCP do próprio HubSpot, em https://mcp.hubspot.com, deixa a sua IA ler os mesmos registros, então a ALTARA e o seu assistente trabalham com um só pipeline.
Como a ALTARA funciona com o HubSpot
Numa empresa que usa HubSpot, a ALTARA lê um pipeline: negócios, etapas, proprietários, empresas, contatos, notas, tarefas, ligações, reuniões e os e-mails registrados no HubSpot, quando o acesso permite. Ela não grava nada.
- Seus negócios são aqueles em que o proprietário no HubSpot tem o seu nome. Se a ALTARA não souber qual proprietário é você, ela pergunta.
- Mudanças: ela prepara a mudança e pede que você confirme, como faz em tudo. Depois do seu sim, manda a mudança exata, negócio por negócio, com o link do negócio no HubSpot, para você fazer lá. Comandos como
/movere/notanão gravam nada. - Listas curtas: ela mostra cerca de 10 negócios por vez, primeiro os de maior valor, e oferece os próximos.
- No console, a área Contas tem um botão que abre o pipeline no HubSpot.
- Ler o pipeline não custa créditos.
O time da ALTARA conecta o HubSpot da sua empresa com acesso só de leitura. Se a sua empresa usa HubSpot, fale com o time quando começar.
Mensagens para mandar à ALTARA:
- "Quais dos meus negócios estão em Proposta?"
- "Me fale da Pinecrest Engineering antes da reunião."
- "Mova a Pinecrest Engineering para Negociação." (Você recebe a mudança e o link do negócio para fazer no HubSpot.)
Conecte à sua IA
O servidor do HubSpot funciona em todos os planos do HubSpot; o conector do Claude pede um plano pago do Claude (Pro, Max, Team ou Enterprise). Super Admins e usuários com App Marketplace Access conectam na hora; os demais esperam um Super Admin aprovar o conector. A sua IA vê só o que o seu usuário do HubSpot vê. Ela pode ver, criar e atualizar, mas não excluir, e os limites da API do HubSpot valem. Para Claude Code, Codex e Cursor, crie um conector MCP no HubSpot (Development > MCP Connectors > Create MCP connector) para obter um client ID e um secret.
- Abra Customize > Connectors, encontre HubSpot e selecione Connect.
- Entre no HubSpot, escolha a conta e as permissões e selecione Connect app.
- Num chat, selecione + > Connectors e ative o HubSpot.
- Abra Settings > Plugins (versões mais antigas dizem Apps), selecione HubSpot e Connect.
- Entre, escolha a conta e as permissões e selecione Connect App.
- Num chat, digite
@HubSpotou ative o app em +.
Se você entra com a sua conta do claude.ai, o conector do HubSpot que está no Claude aparece em /mcp. Para usar o seu próprio conector MCP, adicione http://localhost:8080/callback como URL de redirecionamento dele e rode o comando abaixo (ele pede o secret):
claude mcp add --transport http --client-id YOUR_CLIENT_ID --client-secret --callback-port 8080 hubspot https://mcp.hubspot.comRode /mcp e entre no HubSpot.
- Adicione o servidor:
codex mcp add hubspot --url https://mcp.hubspot.com --oauth-client-id YOUR_CLIENT_ID --oauth-client-secret "$HUBSPOT_CLIENT_SECRET"- Adicione a URL de callback que o Codex mostra às URLs de redirecionamento do conector (Edit info).
- Rode
codex mcp login hubspot.
- Adicione
http://localhost:8787/callbackcomo URL de redirecionamento no conector. - Adicione isto em
~/.cursor/mcp.json, depois abra Customize, ative hubspot e entre:
{
"mcpServers": {
"hubspot": {
"url": "https://mcp.hubspot.com",
"auth": {
"CLIENT_ID": "${env:HUBSPOT_CLIENT_ID}",
"CLIENT_SECRET": "${env:HUBSPOT_CLIENT_SECRET}"
}
}
}
}Comece só com leitura
Dê primeiro as permissões de leitura do CRM e adicione as de edição depois. O HubSpot recomenda deixar as ferramentas de escrita em Needs Approval no Claude e no ChatGPT, para que cada criação ou atualização espere o seu sim. Deixe Sensitive Data desligado, a menos que você precise. Para revogar o acesso, abra o conector nas configurações do Claude ou em Settings > Plugins no ChatGPT e selecione Disconnect.
Prompts para testar
No HubSpot, liste as notas, tarefas, ligações e reuniões registradas nos meus negócios abertos nos últimos 7 dias, agrupadas por negócio, com a etapa e a próxima tarefa aberta. Só leitura.
Antes da minha ligação com [empresa], leia o registro dela no HubSpot: negócios abertos, os últimos cinco e-mails, reuniões e notas, e as tarefas abertas. Me dê um resumo de cinco linhas e três perguntas para fazer. Só leitura.
Esta é a mudança que a ALTARA me mandou: [cole a mudança e o link do negócio]. Abra esse negócio no HubSpot, me mostre o campo como está e como vai ficar, e espere o meu sim antes de salvar.
No HubSpot, liste os meus negócios abertos que fecham neste trimestre e não têm tarefa aberta. Mostre nome do negócio, etapa, valor, data de fechamento e data da última atividade, ordenados por valor.
Se não funcionar
- "Connector needs approval": um Super Admin aprova o conector ou dá a você App Marketplace Access.
- Permissões novas não aparecem: depois que um Super Admin muda as permissões, cada usuário desconecta e conecta de novo.
- O OAuth falha no Claude Code, no Codex ou no Cursor: a URL de redirecionamento precisa ser exatamente igual a uma das cadastradas no conector, e o cliente precisa usar PKCE.
- Regras de etapa ignoradas no ChatGPT: o HubSpot diz que regras de validação personalizadas, incluindo as validações de etapa, não são aplicadas lá. Confira o registro depois de uma atualização.
- A ALTARA não encontra os seus negócios: ela lê um pipeline e identifica você pelo nome do proprietário no HubSpot. Diga a ela qual proprietário é você.
Fontes
- ALTARA help center: Pipeline and CRM, lido em 20 de novembro de 2026
- ALTARA help center: Integrations, lido em 20 de novembro de 2026
- ALTARA help center: The agent, lido em 20 de novembro de 2026
- ALTARA help center: Talking on WhatsApp, lido em 20 de novembro de 2026
- HubSpot: Remote HubSpot MCP server, lido em 20 de novembro de 2026
- HubSpot: Integrate AI tools with the HubSpot MCP server, lido em 20 de novembro de 2026
- HubSpot Knowledge Base: Set up and use the HubSpot connector for Claude, lido em 20 de novembro de 2026
- HubSpot Knowledge Base: Connect your HubSpot account to ChatGPT, lido em 20 de novembro de 2026
- Claude Help Center: Get started with custom connectors using remote MCP, lido em 20 de novembro de 2026
- Claude Code: Connect Claude Code to tools via MCP, lido em 20 de novembro de 2026
- OpenAI: Codex Model Context Protocol, lido em 20 de novembro de 2026
- Cursor: Model Context Protocol, lido em 20 de novembro de 2026
- OpenAI Help Center: Connected apps in ChatGPT, lido em 20 de novembro de 2026
Coloque para trabalhar com a ALTARA
-
weekly-pipeline-review/SKILL.mdSkill Planejar o diaRevise o pipeline toda segunda-feiraUm plano de segunda em uma tela a partir do CRM: datas que escorregaram, negócios sem próximo passo, parados, concentração e cinco ações. Instalar → -
crm-hygiene-audit/SKILL.mdSkill Manter o CRM em diaAudite e limpe o CRMEncontra duplicados, campos vazios, negócios parados, etapas erradas e contatos sem empresa, e entrega correções por risco. Só altera com aprovação. Instalar → -
meeting-brief/SKILL.mdSkill Preparar cada reuniãoPrepare uma reunião em cinco minutosUm resumo de cinco minutos antes da reunião: a empresa, as pessoas, notícias datadas com fonte, o histórico no CRM e três perguntas. Dados públicosInstalar → -
icp-from-won-deals/SKILL.mdSkill Pesquisar um mercadoDefina seu ICP a partir dos negócios que você ganhouCompara negócios ganhos e perdidos critério por critério e entrega um ICP com a contagem de negócios por trás de cada linha. Dados públicosInstalar → -
Roda na ALTARAPlaybook Planejar o diaFaça a revisão de pipeline de segunda na ALTARAPeça à ALTARA o plano da semana, conte as atividades, ache negócios sem próximo passo e corrija pelo chat. A revisão não usa créditos. 20 minutos toda segundaRodar →
-
Roda na ALTARAPlaybook Manter o CRM em diaMantenha o CRM em dia a partir das suas conversas com a ALTARAA ALTARA lê as conversas com clientes e suas notas de ligação, prepara etapa, nota e próxima tarefa, e grava só depois do seu sim. 5 minutos no fim de cada diaRodar →
-
Roda na ALTARAPlaybook Preparar cada reuniãoPrepare e faça o follow-up de cada reunião com a ALTARAAntes da reunião: histórico do CRM e pesquisa na web com fontes. Depois: o follow-up que você envia, e nota e próxima tarefa gravadas após o seu sim. 5 minutos antes e 5 minutos depois de cada reuniãoRodar →