Conectei um CRM de WhatsApp grátis ao Claude via MCP

Organizar leads somente dentro do WhatsApp fica difícil quando o volume de contatos começa a crescer. Conversas se misturam, follow-ups são esquecidos e informações importantes ficam espalhadas entre mensagens e áudios.

Neste tutorial, você vai conhecer um CRM de WhatsApp open source, entender como instalá-lo, conectar o banco de dados Supabase e utilizar o MCP para permitir que o Claude analise contatos, conversas e etapas comerciais.

O projeto utilizado é o WACRM, uma base que pode ser hospedada, personalizada e adaptada para diferentes negócios.

O que é o WACRM?

O WACRM é um template de CRM self-hosted para WhatsApp. Isso significa que você pode criar um fork, hospedar a aplicação e controlar o código e os dados do projeto.

Entre os recursos disponíveis estão:

• caixa de entrada compartilhada;
• contatos, etiquetas e campos personalizados;
• pipelines de vendas;
• campanhas com modelos aprovados pela Meta;
• automações visuais;
• assistente de respostas com IA;
• painel com indicadores;
• contas de equipe e níveis de acesso;
• API REST com chaves revogáveis;
• servidor MCP para clientes como Claude e Cursor.

O repositório utiliza Next.js, React, TypeScript, Tailwind CSS e Supabase.

O CRM é realmente 100% gratuito?

O código do WACRM possui licença MIT e pode ser utilizado e modificado gratuitamente. Isso não significa que toda a operação terá custo zero.

Dependendo do uso, você poderá pagar por:

• hospedagem Node.js ou VPS;
• domínio;
• banco de dados quando ultrapassar o plano gratuito;
• armazenamento e backups;
• serviços de transcrição;
• uso de APIs de inteligência artificial;
• cobrança da plataforma oficial do WhatsApp;
• manutenção e monitoramento.

A forma mais correta de apresentar o projeto é: CRM open source e gratuito para instalar, com possíveis custos de infraestrutura e serviços externos.

O que mudou no projeto desde a gravação do vídeo?

No vídeo, o WACRM foi usado como base e recebeu personalizações, incluindo uma integração com Evolution API e transcrição de áudios.

O repositório atual já possui recursos que podem não aparecer na gravação:

• integração com a API oficial do WhatsApp Business;
• MCP com acesso somente leitura por padrão;
• ações de escrita ativadas separadamente;
• API pública com escopos;
• automações;
• assistente de IA;
• controles de acesso;
• proteção de tokens;
• políticas RLS no Supabase.

Antes de modificar o código, verifique a documentação e teste o que já existe. Isso evita recriar uma funcionalidade que o projeto passou a oferecer nativamente.

Por que conectar um CRM ao Claude via MCP?

MCP significa Model Context Protocol. Ele permite que uma inteligência artificial se conecte a ferramentas externas por meio de ações estruturadas.

Com o CRM conectado, o Claude pode ajudar a:

• localizar uma conversa;
• resumir o histórico de um lead;
• identificar a etapa comercial;
• apontar informações que ainda precisam ser confirmadas;
• sugerir um próximo contato;
• analisar transcrições de áudio;
• organizar follow-ups;
• preparar relatórios comerciais.

A IA não deve enviar mensagens automaticamente sem supervisão. O uso mais seguro é começar com leitura e análise. Depois, ações de escrita podem ser habilitadas apenas quando realmente forem necessárias.

O que você precisa para instalar o projeto?

Prepare:

• conta no GitHub;
• Git instalado;
• Node.js compatível com o projeto;
• npm;
• conta no Supabase;
• editor como Visual Studio Code;
• cliente compatível com MCP;
• hospedagem Node.js ou VPS para produção;
• domínio com HTTPS para webhooks;
• conhecimento básico de terminal e variáveis de ambiente.

O WACRM é uma aplicação completa. Embora a IA ajude no processo, você continua responsável por segurança, deploy, banco de dados, backups e atualizações.

Como criar um fork e instalar o WACRM?

Acesse o repositório do WACRM, clique em Fork e crie uma cópia na sua conta.

Depois, clone o seu fork:

git clone https://github.com/SEU-USUARIO/wacrm.git
cd wacrm
npm install
cp .env.local.example .env.local
npm run dev

Acesse http://localhost:3000 para abrir a aplicação local.

Use a URL do seu próprio fork no comando. Assim, as personalizações podem ser registradas no seu repositório sem alterar o projeto original.

Como pedir ao Claude Code para analisar o projeto?

Antes de editar qualquer arquivo, peça uma auditoria inicial.

Analise este projeto WACRM sem fazer alterações.

Leia o README, AGENTS.md, CLAUDE.md, package.json, a pasta de documentação, as migrations do Supabase e a implementação do servidor MCP.

Informe:

1. a arquitetura atual;
2. as versões e dependências principais;
3. as variáveis de ambiente necessárias;
4. os comandos para desenvolvimento e build;
5. os recursos que já existem;
6. os cuidados de segurança;
7. as etapas recomendadas para executar o projeto localmente.

Não exiba valores de credenciais e não modifique arquivos.

Essa etapa é importante porque o projeto pode ter mudado desde a publicação do vídeo.

Para que serve o arquivo CLAUDE.md?

O arquivo CLAUDE.md fornece contexto permanente ao Claude Code. Ele pode registrar:

• arquitetura do CRM;
• comandos importantes;
• convenções;
• limites de alteração;
• regras de segurança;
• arquivos que não devem ser modificados;
• processo de testes.

O comando /init pode ajudar a analisar um projeto sem documentação própria. Porém, o WACRM atual já possui arquivos de contexto e instruções. Antes de gerar novos conteúdos, verifique o que existe e evite substituir regras mantidas pelo projeto.

Como configurar o Supabase?

O Supabase fornece Postgres, autenticação, armazenamento e políticas de segurança.

Crie um projeto no painel e copie somente os valores solicitados pelo arquivo .env.local.example. Preencha o arquivo .env.local no seu computador.

Nunca:

• envie o arquivo .env.local ao GitHub;
• exponha a chave de serviço no frontend;
• mostre credenciais em vídeos;
• cole senhas do banco em conversas;
• reutilize credenciais de produção no ambiente local.

A documentação do Supabase recomenda armazenar segredos em variáveis de ambiente. Confirme também que o .gitignore protege o arquivo antes de fazer qualquer commit.

Como executar as migrations com segurança?

As migrations criam tabelas, índices, funções e políticas necessárias ao CRM. Elas devem ser aplicadas na ordem documentada pelo projeto.

Você pode utilizar o Supabase CLI ou o procedimento indicado na documentação do WACRM.

Analise as migrations existentes neste projeto e apresente o plano para aplicá-las ao Supabase.

Não solicite que eu cole senhas ou tokens nesta conversa.

Use as credenciais já configuradas no ambiente local ou o login seguro do Supabase CLI.

Antes de executar:

1. liste as migrations na ordem correta;
2. confirme o projeto Supabase de destino;
3. informe se alguma migration é destrutiva;
4. verifique políticas RLS;
5. explique como validar o resultado;
6. aguarde minha autorização.

Depois da execução, informe quais migrations foram aplicadas e quais tabelas foram criadas.

Não utilize execução automática sem permissões em um banco com dados reais. Migrations podem alterar ou remover estruturas.

Como testar o CRM localmente?

Depois de instalar dependências, configurar variáveis e aplicar migrations:

npm run dev

Crie uma conta de teste e valide:

• login e confirmação de e-mail;
• dashboard;
• contatos;
• caixa de entrada;
• pipelines;
• automações;
• configurações;
• criação e revogação de chaves;
• isolamento dos dados;
• comportamento das políticas RLS.

Antes do deploy, execute também os comandos de verificação definidos pelo projeto, como testes, lint, typecheck e build.

Como conectar o WhatsApp ao CRM?

O WACRM atual documenta a integração com a API oficial do WhatsApp Business da Meta. Essa é a alternativa recomendada para uso comercial e para recursos como campanhas com modelos aprovados.

A API oficial exige configuração de:

• conta empresarial;
• aplicativo na Meta;
• número autorizado;
• token;
• identificador do telefone;
• webhook HTTPS;
• verificação do webhook;
• modelos de mensagem quando aplicável.

Para campanhas, envie mensagens somente para contatos com autorização adequada e respeite as regras da Meta e a LGPD.

E a integração com Evolution API mostrada no vídeo?

No vídeo, a Evolution API foi adicionada como um segundo provedor porque o objetivo principal era receber conversas em um ambiente personalizado.

Essa integração não é a API oficial do WhatsApp. Ela pode apresentar riscos de estabilidade, compatibilidade e restrição do número. Para produção, campanhas ou operação crítica, prefira a API oficial.

O prompt criado para estudar essa personalização está disponível no repositório Evolution CRM Integration Prompt.

Use-o como referência técnica e revise o código gerado. Não trate uma integração não oficial como garantia contra bloqueios ou mudanças na plataforma.

Como configurar o MCP do WACRM?

O WACRM possui servidor MCP no próprio repositório. O procedimento exato depende da versão e do cliente utilizado.

O fluxo geral é:

1. publique o CRM em um endereço HTTPS;
2. crie uma chave de API com os menores escopos possíveis;
3. mantenha inicialmente somente operações de leitura;
4. copie a configuração MCP indicada pela documentação;
5. adicione ao Claude Desktop ou outro cliente;
6. reinicie o cliente;
7. teste a conexão;
8. revogue a chave se ela for exposta.

Ajude a configurar o servidor MCP deste projeto no Claude Desktop.

Antes de modificar qualquer configuração:

1. leia docs/mcp.md;
2. identifique a URL correta do servidor;
3. liste as variáveis necessárias;
4. confirme que a chave possui somente escopos de leitura;
5. mostre o arquivo que será alterado;
6. não revele o valor da chave na resposta;
7. faça uma cópia de segurança da configuração existente;
8. aguarde minha autorização.

Depois, teste apenas uma operação de leitura e apresente o resultado.

Evite habilitar envio, exclusão ou alteração de contatos durante o primeiro teste.

Como usar o Claude para analisar um lead?

Depois de confirmar a conexão, você pode pedir uma análise comercial.

Localize a conversa mais recente do lead informado e analise todo o histórico disponível, incluindo transcrições de áudio.

Não envie mensagens e não altere o CRM.

Apresente:

- resumo da necessidade;
- serviço ou produto de interesse;
- etapa atual da negociação;
- informações já confirmadas;
- dúvidas que ainda bloqueiam o avanço;
- sinais positivos e objeções;
- risco de o contato parecer insistente;
- próximo passo mais natural;
- uma sugestão curta de mensagem, somente como rascunho.

Não invente informações que não estejam no histórico.

A mensagem deve permanecer como rascunho até ser revisada. A análise da IA pode ignorar contexto, interpretar incorretamente o tom ou sugerir um follow-up desnecessário.

Como trabalhar com áudios do WhatsApp?

O CRM precisa armazenar uma transcrição para que a IA analise o conteúdo falado. No projeto personalizado do vídeo, foi adicionada uma etapa para:

1. receber o áudio;
2. gerar a transcrição;
3. salvar o texto associado à mensagem;
4. incluir esse texto na análise da conversa.

Informe ao usuário quando áudio e mensagens forem processados por IA. Defina prazos de retenção, controle de acesso e base legal adequada. Dados de clientes não devem ser utilizados sem necessidade ou autorização.

MCP elimina completamente o custo da IA?

Não necessariamente.

No fluxo mostrado, o Claude acessa o CRM pelo MCP e utiliza o limite do plano do usuário, sem exigir que o WACRM faça cada análise por uma chave de API separada.

Mesmo assim:

• o plano possui limites de uso;
• recursos e regras podem mudar;
• automações em segundo plano normalmente exigem uma API;
• grandes volumes podem precisar de arquitetura própria;
• outros serviços de IA ou transcrição podem cobrar por consumo.

MCP é um protocolo de conexão. Ele não transforma processamento de IA em um serviço ilimitado e gratuito.

Quais cuidados são essenciais com dados de clientes?

Um CRM de WhatsApp armazena dados pessoais e conversas. Antes de utilizá-lo:

• defina quem pode acessar;
• aplique menor privilégio;
• ative RLS;
• proteja tokens e chaves;
• use HTTPS;
• mantenha logs;
• faça backups;
• atualize dependências;
• estabeleça retenção e exclusão;
• informe o tratamento de dados;
• respeite solicitações dos titulares;
• não envie campanhas sem autorização;
• não compartilhe conversas reais em vídeos ou prompts públicos;
• revise a LGPD com apoio profissional quando necessário.

Uma ferramenta self-hosted oferece controle, mas também transfere para você a responsabilidade pela segurança.

Vale a pena usar o WACRM como base?

Sim, principalmente quando o objetivo é aprender, personalizar o processo comercial ou criar uma solução sob medida.

Em vez de desenvolver autenticação, painel, contatos, pipelines e automações do zero, você parte de uma base funcional e concentra o trabalho nas necessidades específicas do negócio.

O WACRM pode ser usado para:

• organizar leads do WhatsApp;
• centralizar conversas;
• acompanhar negociações;
• preparar follow-ups;
• analisar histórico com IA;
• criar recursos próprios;
• integrar campanhas;
• gerar relatórios comerciais.

O melhor caminho é começar com a versão atual do repositório, manter a API oficial como padrão e adicionar personalizações somente depois de entender segurança, custos e manutenção.

Assista ao vídeo incorporado no início deste artigo para acompanhar o projeto original e entender como o CRM foi conectado ao Claude via MCP.