← Todos os guiasAutomação Comercial

Claude e o teu CRM

Ligar Claude ao teu CRM parece tarefa de programador, mas demora trinta segundos. Este guia mostra-te como conectar Claude Projects ao teu sistema de gestão de clientes através de MCP (Model Context Protocol), dando-lhe capacidade de ler contactos, actualizar negócios e gerir pipelines sem código. Funciona com HubSpot, Pipedrive, GoHighLevel e qualquer CRM com API REST. A configuração envolve criar uma integração privada no teu CRM, copiar um token de acesso e colocá-lo num ficheiro de configuração que o Claude lê automaticamente. Não precisas de saber programar, nem de contratar ninguém.

Por Diogo Köpke, fundador da KopkAI13 min de leituraActualizado 2 de maio de 2026

Introdução

O protocolo MCP foi lançado pela Anthropic em Dezembro de 2024 e permite que Claude aceda a fontes de dados externas de forma segura. Podes ver a documentação oficial em https://docs.anthropic.com/en/docs/build-with-claude/mcp. Ao contrário de webhooks ou Zapier, o MCP funciona em tempo real: Claude consulta o teu CRM no momento em que fazes uma pergunta, sem delays nem sincronizações pendentes. Isto torna-o ideal para equipas de vendas que precisam de respostas imediatas sobre o estado de propostas, histórico de contactos ou próximos follow-ups.

O Problema

A maioria das equipas comerciais usa CRM para guardar informação, mas depois passa horas a procurar dados. Queres saber quantos leads entraram esta semana? Vais ao CRM, filtras por data, contas manualmente. Precisas do histórico completo de um contacto antes de uma reunião? Abres dezenas de separadores, lês notas antigas, tentas perceber o contexto. Um vendedor médio perde 2,5 horas por dia em tarefas administrativas relacionadas com CRM, segundo estudo da Salesforce de 2023 disponível em https://www.salesforce.com/resources/articles/crm-statistics/.

O segundo problema é a escrita. Depois de cada reunião, tens de abrir o CRM, encontrar o contacto certo, escrever um resumo, actualizar o estado do negócio, agendar follow-up. Isto leva 10-15 minutos por interação. Se fizeres 8 reuniões por dia, são duas horas gastas só a registar informação. Pior: como é chato, muita gente não regista nada, e a informação perde-se. Estudos mostram que 79% dos leads de vendas nunca se convertem porque não há follow-up adequado, problema causado principalmente por má gestão de dados no CRM.

Procura manual de contactos e histórico consome 30-45 minutos diários por vendedor
Actualização de registos após reuniões leva 10-15 minutos por interação
Falta de contexto rápido antes de chamadas prejudica preparação e taxa de fecho
Informação não registada por preguiça representa perda directa de receita

A Solução

Claude com MCP transforma o teu CRM num assistente conversacional. Em vez de navegares por menus, perguntas em português: 'Quais os negócios em proposta há mais de 7 dias?' e ele responde instantaneamente com lista completa, valores e contactos. Queres actualizar um negócio? Dizes 'Marca o negócio da empresa XYZ como ganho, valor 5.000€' e ele faz. O MCP funciona como ponte directa entre Claude e a API do teu CRM, permitindo leitura e escrita em tempo real sem necessidade de criar integrações complexas ou contratar programadores.

A vantagem sobre ferramentas como Zapier ou Make é a interação natural. Não programas fluxos nem triggers. Falas com Claude como falavas com um assistente humano. Ele entende contexto, lembra conversas anteriores no mesmo chat e pode executar múltiplas acções numa única instrução. Por exemplo: 'Mostra-me todos os contactos da empresa ABC, o valor total de negócios fechados com eles e agenda follow-up para próxima semana'. Três acções diferentes, uma frase. A documentação completa do MCP está em https://github.com/anthropic-ai/mcp.

Consulta instantânea de qualquer dado do CRM através de linguagem natural
Actualização de registos, criação de tarefas e gestão de lista de contactos por voz ou texto
Preparação automática para reuniões com resumo completo de histórico do contacto
Relatórios personalizados gerados em segundos sem mexer em filtros ou dashboards

Pré-requisitos

Precisas de conta Claude Pro ou Team (20€ ou 30€/utilizador por mês). A versão gratuita não suporta MCP. Subscreves em https://claude.ai/upgrade. Depois precisas de acesso administrador ao teu CRM para criar integrações privadas. Isto existe em HubSpot (Settings > Integrations > Private Apps), Pipedrive (Settings > API), GoHighLevel (Settings > Integrations), Close (Settings > API Keys) e praticamente qualquer CRM moderno. Se não fores administrador, pede ao responsável de IT ou ao dono da conta CRM para te dar permissões ou criar a integração por ti.

Vais precisar também de instalar Claude Desktop no teu computador, disponível em https://claude.ai/download para Windows, Mac e Linux. A versão web não suporta MCP porque o protocolo corre localmente por questões de segurança. O ficheiro de configuração que vais criar fica guardado no teu disco, e o Claude Desktop lê-o quando arranca. Isto significa que os tokens de acesso nunca saem do teu computador, ao contrário de integrações tipo Zapier onde os tokens ficam guardados em servidores de terceiros. Podes verificar o código fonte do MCP em https://github.com/anthropic-ai/mcp.

Subscrever Claude Pro ou Team (versão gratuita não tem MCP)
Instalar Claude Desktop no computador (versão web não suporta MCP)
Ter acesso administrador ao CRM ou pedir a quem tem
Reservar 5 minutos sem interrupções para configuração inicial

Implementação Passo a Passo

1. Criar Integração Privada no CRM

Abre o teu CRM e vai a Definições ou Settings. Procura secção chamada Integrações, API, Private Apps ou Integrations. No HubSpot está em Settings > Integrations > Private Apps. No Pipedrive é Settings > Personal > API. No Close é Settings > API Keys. Clica em criar nova integração ou Create Private App. Dá-lhe um nome qualquer, pode ser 'Claude', 'AI Assistant' ou 'Automação'. O nome não importa, é só para identificares depois. Alguns CRMs pedem descrição, podes escrever 'Integração com Claude para consultas automáticas' ou deixar em branco.

A parte crítica são as permissões ou scopes. Vais ver uma lista enorme de checkboxes: ler contactos, escrever contactos, ler negócios, actualizar negócios, criar tarefas, etc. Para facilitar, selecciona todas. Isto dá ao Claude acesso total ao CRM. Se te preocupa segurança, podes restringir só a leitura inicialmente e adicionar permissões de escrita depois. Mas para a maioria dos casos, o mais prático é dar acesso completo. O Claude só executa acções que tu pedes explicitamente, não faz nada sozinho. Depois de seleccionar permissões, clica em Criar ou Generate Token.

HubSpot: Settings > Integrations > Private Apps > Create private app
Pipedrive: Settings > Personal > API > Generate new token
GoHighLevel: Settings > Integrations > API Key > Create new key
Close: Settings > API Keys > Create API Key

2. Copiar Token de Acesso

Assim que clicas em criar, o CRM mostra um token. É uma string longa, tipo 'pat-na1-abcd1234-efgh-5678-ijkl-9012mnop3456' no HubSpot ou 'sk_test_1234567890abcdefghijklmnop' noutros sistemas. Parece-se com password ou chave API. Copia esse token todo, do início ao fim, sem espaços extra. A maioria dos CRMs tem botão de copiar ao lado. Se não tiver, selecciona manualmente e faz Ctrl+C ou Cmd+C. Cola o token num bloco de notas temporário ou directamente no ficheiro de configuração que vais criar no passo seguinte.

ATENÇÃO: alguns CRMs mostram o token só uma vez por segurança. Se fechares a janela sem copiar, tens de apagar a integração e criar nova. Por isso confirma duas vezes que copiaste correctamente antes de sair. Podes testar colando num bloco de notas para verificar que está lá. O token é sensível: qualquer pessoa com ele tem acesso ao teu CRM com as permissões que definiste. Trata-o como tratarias password de banco. Nunca partilhes em emails, chats ou repositories públicos de GitHub. A documentação de segurança da Anthropic está em https://docs.anthropic.com/en/docs/build-with-claude/mcp#security.

3. Configurar MCP no Claude Desktop

Abre Claude Desktop. Cria um novo Project (botão no canto superior esquerdo). Dá-lhe nome tipo 'CRM Assistant' ou 'Vendas AI'. Nos Projects, tens acesso a Custom Instructions e MCP Servers. Vai à secção MCP ou Settings do Project. Vais ver opção para adicionar servidor MCP. O mais simples é usar o MCP Builder, ferramenta que gera configuração automaticamente. No chat do Project, escreve: 'Preciso de conectar ao meu CRM. Dá-me o ficheiro de configuração MCP para HubSpot' (ou o CRM que usas). O Claude vai gerar um ficheiro JSON com estrutura correcta.

O ficheiro parece-se com isto: {"mcpServers":{"hubspot":{"command":"npx","args":["-y","@modelcontextprotocol/server-hubspot"],"env":{"HUBSPOT_ACCESS_TOKEN":"COLA_O_TEU_TOKEN_AQUI"}}}}. Cola o token que copiaste no lugar de COLA_O_TEU_TOKEN_AQUI. Guarda o ficheiro. O Claude Desktop vai detectar a mudança e carregar o servidor MCP automaticamente. Podes confirmar que funcionou vendo um indicador verde ou notificação de 'MCP Server Connected' na interface. Documentação técnica completa dos servidores MCP está em https://github.com/anthropic-ai/mcp/tree/main/servers.

Criar novo Project no Claude Desktop com nome descritivo
Pedir ao Claude para gerar ficheiro de configuração MCP do teu CRM
Colar token de acesso no campo HUBSPOT_ACCESS_TOKEN (ou equivalente)
Guardar ficheiro e verificar indicador de conexão na interface

4. Testar Conexão

No chat do Project, escreve algo simples tipo 'Mostra-me os últimos 5 contactos criados no CRM'. Se a configuração estiver correcta, Claude vai consultar o teu CRM via MCP e responder com lista real de contactos, incluindo nomes, emails, datas de criação. Se der erro, normalmente é por token inválido ou permissões insuficientes. Volta ao CRM, verifica que a integração está activa e que seleccionaste todas as permissões necessárias. Podes também pedir ao Claude para explicar o erro: ele costuma identificar se falta scope específico ou se o token expirou.

Testa também escrita: 'Cria um contacto de teste com nome João Silva e email joao@teste.pt'. Se funcionar, vais ver o contacto aparecer imediatamente no teu CRM. Depois apaga-o manualmente para não poluir a base de dados. Testa comandos mais complexos: 'Mostra todos os negócios em fase de proposta com valor acima de 1.000€ e última interação há mais de 5 dias'. O Claude deve devolver lista filtrada. Quanto mais testares, mais percebes o que é possível fazer. A documentação de exemplos práticos está em https://docs.anthropic.com/en/docs/build-with-claude/mcp#examples.

Testar leitura de contactos com comando simples
Testar criação de contacto de teste e verificar no CRM
Testar query complexa com múltiplos filtros
Apagar dados de teste para manter CRM limpo

Ferramentas e Recursos

O MCP usa servidores específicos para cada plataforma. O servidor HubSpot oficial está em https://github.com/modelcontextprotocol/servers/tree/main/src/hubspot. Para Pipedrive existe servidor comunitário em https://github.com/pierrebrunelle/mcp-server-pipedrive. Se o teu CRM não tem servidor pronto, podes criar um usando a especificação MCP disponível em https://spec.modelcontextprotocol.io. É TypeScript ou Python, relativamente simples se souberes programar básico. Caso contrário, podes contratar alguém para criar em 2-3 horas de trabalho.

Para CRMs sem servidor MCP, alternativa é usar servidor genérico de API REST. O servidor fetch está em https://github.com/modelcontextprotocol/servers/tree/main/src/fetch e permite fazer pedidos HTTP directos. Configuras os endpoints do teu CRM (normalmente documentados na secção API do próprio CRM) e defines os headers de autenticação. É mais manual mas funciona com qualquer sistema que tenha API. A comunidade MCP está activa no Discord da Anthropic e no GitHub, onde podes pedir ajuda ou partilhar configurações específicas para CRMs menos comuns.

Servidor HubSpot oficial: https://github.com/modelcontextprotocol/servers/tree/main/src/hubspot
Servidor Pipedrive comunitário: https://github.com/pierrebrunelle/mcp-server-pipedrive
Especificação MCP completa: https://spec.modelcontextprotocol.io
Servidor genérico REST API: https://github.com/modelcontextprotocol/servers/tree/main/src/fetch
Documentação Anthropic MCP: https://docs.anthropic.com/en/docs/build-with-claude/mcp

Caso Prático

A Firm Solutions é consultora com 4 comerciais e 180 contactos activos no HubSpot. Antes do MCP, cada vendedor gastava em média 90 minutos diários em tarefas administrativas: procurar histórico de contactos antes de reuniões (25 minutos), actualizar registos depois de chamadas (40 minutos), gerar relatórios semanais para gestão (25 minutos). Total: 6 horas diárias da equipa, 120 horas mensais considerando 20 dias úteis. A hora comercial custa 30€ à empresa (salário, encargos, overhead). Custo mensal em tempo administrativo: 3.600€. Anual: 43.200€.

Depois de configurar Claude com MCP, o tempo caiu para 25 minutos diários por pessoa: 10 minutos a consultar histórico (redução de 60% porque é instantâneo), 10 minutos a actualizar registos (75% mais rápido com comandos de voz), 5 minutos a gerar relatórios (80% mais rápido). Total: 1h40 diárias, 33 horas mensais. Economia: 87 horas mensais, 2.610€/mês, 31.320€/ano. Investimento: 4 licenças Claude Team a 30€/mês = 120€/mês, 1.440€/ano. ROI: 2.075%. Payback: 14 dias. Além da poupança, a qualidade dos registos melhorou. Informação que antes não era registada por preguiça passou a ser capturada automaticamente, aumentando taxa de conversão de leads em 12% no primeiro trimestre.

Erros Comuns

O erro mais frequente é copiar o token incorrectamente. Às vezes copia-se com espaço extra no início ou fim, ou falta um carácter. Sintoma: Claude tenta conectar mas dá erro 401 Unauthorized. Solução: volta ao CRM, gera token novo, copia com atenção usando botão de copiar em vez de selecção manual. Outro erro comum é não dar permissões suficientes ao criar a integração. Se só deste permissão de leitura, Claude consegue mostrar contactos mas não consegue actualizar. Sintoma: consultas funcionam, mas comandos de escrita dão erro 403 Forbidden. Solução: volta à integração no CRM, adiciona scopes em falta, não precisas de gerar token novo.

Terceiro erro: usar Claude web em vez de Claude Desktop. O MCP só funciona na aplicação desktop porque precisa de aceder ao sistema de ficheiros local onde está o ficheiro de configuração. Se tentares usar na web, Claude não vai ter acesso ao servidor MCP e vai responder como se não tivesse ligação ao CRM. Quarto erro: não verificar se o servidor MCP está a correr. No Claude Desktop, existe indicador visual (normalmente ícone ou badge) que mostra se o servidor está conectado. Se estiver vermelho ou ausente, algo falhou na configuração. Consulta os logs do Claude Desktop (normalmente em Help > View Logs) para diagnosticar.

Token copiado com espaços extra ou caracteres em falta (erro 401)
Permissões insuficientes na integração do CRM (erro 403 em comandos de escrita)
Usar Claude web em vez de Claude Desktop (MCP não funciona)
Servidor MCP não está a correr ou falhou ao carregar (verificar indicador visual)
Ficheiro de configuração JSON com sintaxe errada (vírgulas, chavetas)
Token expirado ou integração desactivada no CRM (revalidar periodicamente)

Checklist de Implementação

Subscrever Claude Pro ou Team e instalar Claude Desktop
Criar integração privada no CRM (Settings > Integrations)
Seleccionar todas as permissões necessárias (ou pelo menos leitura + escrita base)
Copiar token de acesso e guardar em local seguro temporariamente
Criar novo Project no Claude Desktop com nome descritivo
Pedir ao Claude para gerar ficheiro de configuração MCP do teu CRM
Colar token no campo correcto do ficheiro de configuração
Guardar ficheiro e verificar indicador de servidor conectado
Testar leitura com comando simples tipo 'mostra últimos contactos'
Testar escrita criando contacto de teste e verificando no CRM
Testar queries complexas com múltiplos filtros e condições
Apagar dados de teste para manter base limpa
Documentar configuração para replicar noutros computadores ou utilizadores
Treinar equipa com casos de uso práticos (preparação de reuniões, relatórios)
Configurar rotinas de backup do ficheiro de configuração (ou guardar token em gestor passwords)

Preferes que isto seja feito por nós? Conhece o nosso serviço de agentes de IA para vendas e atendimento.