# Conecte HubSpot à sua IA

> A ALTARA lê um pipeline do HubSpot, sem gravar nada, e manda cada mudança com o link do negócio. Sua IA lê os mesmos registros pelo MCP do HubSpot.

Canonical: https://www.altaratech.com/pt/kit/connections/hubspot
English: https://www.altaratech.com/toolkit/connections/hubspot
Shelf: Connection · Job: Keep the CRM current
Official MCP server: yes · URL: https://mcp.hubspot.com · Auth: OAuth com o seu login do HubSpot (PKCE obrigatório)
With ALTARA: Lê (em implantação). A ALTARA lê um pipeline do HubSpot e propõe cada mudança para você fazer no HubSpot; ela não grava nada. Em implantação com as primeiras empresas.

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 `/mover` e `/nota` nã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.

### Claude

1. Abra **Customize > Connectors**, encontre **HubSpot** e selecione **Connect**.
2. Entre no HubSpot, escolha a conta e as permissões e selecione **Connect app**.
3. Num chat, selecione **+ > Connectors** e ative o HubSpot.

### ChatGPT

1. Abra **Settings > Plugins** (versões mais antigas dizem **Apps**), selecione **HubSpot** e **Connect**.
2. Entre, escolha a conta e as permissões e selecione **Connect App**.
3. Num chat, digite `@HubSpot` ou ative o app em **+**.

### Claude Code

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):

```bash
claude mcp add --transport http --client-id YOUR_CLIENT_ID --client-secret --callback-port 8080 hubspot https://mcp.hubspot.com
```

Rode `/mcp` e entre no HubSpot.

### Codex

1. Adicione o servidor:

```bash
codex mcp add hubspot --url https://mcp.hubspot.com --oauth-client-id YOUR_CLIENT_ID --oauth-client-secret "$HUBSPOT_CLIENT_SECRET"
```

2. Adicione a URL de callback que o Codex mostra às URLs de redirecionamento do conector (**Edit info**).
3. Rode `codex mcp login hubspot`.

### Cursor

1. Adicione `http://localhost:8787/callback` como URL de redirecionamento no conector.
2. Adicione isto em `~/.cursor/mcp.json`, depois abra **Customize**, ative hubspot e entre:

```json
{
  "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

```text
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.
```

```text
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.
```

```text
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.
```

```text
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](https://docs.altaratech.com/en/docs/agent/pipeline-and-crm), lido em 2026-11-20
- [ALTARA help center: Integrations](https://docs.altaratech.com/en/docs/console/integrations), lido em 2026-11-20
- [ALTARA help center: The agent](https://docs.altaratech.com/en/docs/agent), lido em 2026-11-20
- [ALTARA help center: Talking on WhatsApp](https://docs.altaratech.com/en/docs/agent/whatsapp), lido em 2026-11-20
- [HubSpot: Remote HubSpot MCP server](https://developers.hubspot.com/docs/build-with-ai/remote-mcp-server), lido em 2026-11-20
- [HubSpot: Integrate AI tools with the HubSpot MCP server](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server), lido em 2026-11-20
- [HubSpot Knowledge Base: Set up and use the HubSpot connector for Claude](https://knowledge.hubspot.com/integrations/set-up-and-use-the-hubspot-connector-for-claude), lido em 2026-11-20
- [HubSpot Knowledge Base: Connect your HubSpot account to ChatGPT](https://knowledge.hubspot.com/integrations/connect-your-hubspot-account-to-chatgpt), lido em 2026-11-20
- [Claude Help Center: Get started with custom connectors using remote MCP](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp), lido em 2026-11-20
- [Claude Code: Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp), lido em 2026-11-20
- [OpenAI: Codex Model Context Protocol](https://learn.chatgpt.com/docs/extend/mcp?surface=cli), lido em 2026-11-20
- [Cursor: Model Context Protocol](https://cursor.com/docs/mcp), lido em 2026-11-20
- [OpenAI Help Center: Connected apps in ChatGPT](https://help.openai.com/en/articles/11487775-connected-apps-in-chatgpt), lido em 2026-11-20
