HubSpot MCP Server

Integre com o HubSpot CRM para gerenciar contatos, negócios e empresas.

GitHubExperimente este MCPPatrocinado

Documentação

🚀 Guia de Início Rápido

Bem-vindo ao HubSpot MCP Server! Este guia vai colocá-lo em funcionamento em apenas alguns minutos.

📋 Pré-requisitos

  • Python 3.8+ instalado no seu sistema
  • Claude Desktop aplicativo instalado
  • Conta de Desenvolvedor HubSpot (gratuita)
  • Integração Nango configurada (para autenticação segura)

⚡ Configuração em 5 Minutos

Passo 1: Obter Token de Acesso do HubSpot

  1. Visite Portal do Desenvolvedor HubSpot
  2. Entre com sua conta HubSpot
  3. Crie um novo aplicativo ou selecione um existente
  4. Vá para a aba "Auth" → "Scopes"
  5. Habilite esses escopos: 
    ✅ crm.objects.companies.read
✅ crm.objects.companies.write  
✅ crm.objects.contacts.read
✅ crm.objects.contacts.write
✅ crm.lists.read
✅ crm.lists.write
  6. Copie seu token de acesso da aba "Auth"

Passo 2: Configurar Integração Nango

Obtenha suas credenciais Nango:

  • NANGO_BASE_URL: URL base da sua instância Nango
  • NANGO_SECRET_KEY: Sua chave secreta Nango
  • NANGO_CONNECTION_ID: Seu identificador de conexão
  • NANGO_INTEGRATION_ID: Seu identificador de integração

Passo 3: Configurar Claude Desktop

Adicione esta configuração ao arquivo de configuração do Claude Desktop:

macOS:

Localização: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

Localização: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hubspot": {
      "command": "uvx",
      "args": ["git+https://github.com/Shameerpc5029/hubspot-mcp.git"],
      "env": {
        "NANGO_BASE_URL": "enter_your_nango_base_url_here",
        "NANGO_SECRET_KEY": "enter_your_nango_secret_key_here",
        "NANGO_CONNECTION_ID": "enter_your_nango_connection_id_here",
        "NANGO_INTEGRATION_ID": "enter_your_nango_integration_id_here"
      }
    }
  }
}

Importante: Substitua os valores de exemplo pelas suas credenciais Nango reais:

  • Substitua enter_your_nango_base_url_here pela sua URL base Nango
  • Substitua enter_your_nango_secret_key_here pela sua chave secreta
  • Substitua enter_your_nango_connection_id_here pelo seu ID de conexão
  • Substitua enter_your_nango_integration_id_here pelo seu ID de integração

Passo 4: Reiniciar Claude Desktop

Feche e reabra o Claude Desktop para carregar a nova configuração.

✅ Testando Sua Configuração

No Claude, tente estes comandos:

  1. Teste de conexão: "Liste todas as empresas no meu HubSpot"
  2. Crie uma empresa de teste: "Crie uma empresa chamada Test Corp com domínio test.com"
  3. Pesquise contatos: "Encontre todos os contatos com endereços de e-mail gmail"

🎯 O Que Você Pode Fazer Agora

Gerenciamento de Empresas

  • Criar, atualizar, excluir empresas
  • Pesquisar por domínio ou outros critérios
  • Obter atividade recente da empresa
  • Operações em massa com filtros

Gerenciamento de Contatos

  • Criar, atualizar, excluir contatos
  • Pesquisar por e-mail, nome, telefone
  • Gerenciar associações de listas
  • Rastrear atividade recente de contatos

Exemplos de Linguagem Natural

  • "Crie uma empresa para a Acme Corp com o site acme.com"
  • "Encontre o contato john@example.com e atualize o número de telefone dele"
  • "Mostre-me todas as empresas criadas este mês"
  • "Adicione o contato ID 12345 à minha lista de clientes VIP"

🔧 Solução de Problemas

Problemas Comuns

❌ Erros de "Ferramenta não encontrada"

  • Reinicie o Claude Desktop após alterações de configuração
  • Verifique se suas credenciais Nango estão corretas
  • Verifique se uvx está instalado no seu sistema

❌ Falhas de autenticação

  • Verifique novamente suas credenciais Nango na configuração
  • Garanta que todos os escopos necessários estejam habilitados no seu aplicativo HubSpot
  • Verifique se sua integração Nango está configurada corretamente

❌ Comando uvx não encontrado

  • Instale uvx: pip install uvx ou pipx install uvx
  • Garanta que uvx esteja no PATH do seu sistema

Teste de Conexão

Você pode testar sua configuração fazendo perguntas simples ao Claude, como:

"Can you connect to my HubSpot account?"
"Show me my recent contacts"
"List my companies"

Modo de Depuração

Se você encontrar problemas, verifique os logs do Claude Desktop ou o console para mensagens de erro.

📞 Obtendo Ajuda

🎉 Você Está Pronto!

Agora você tem o HubSpot CRM integrado ao Claude! Comece com comandos simples e explore as poderosas possibilidades de automação.

Recursos principais disponíveis:

  • 🏢 Gerenciamento completo de empresas
  • 👥 Criação e atualização de contatos
  • 📋 Gerenciamento de listas
  • 🔍 Capacidades avançadas de pesquisa
  • 📊 Rastreamento de atividade recente

Feliz automação! 🚀