O que muda no servidor
Em vez do seu computador, uma máquina na nuvem que fica ligada o tempo todo e funciona sozinha, sem o app. Ela fala com o WhatsApp pela Evolution API.
Ligado o tempo todo
As mensagens chegam mesmo com o seu computador desligado, e a sua IA consegue ler e responder a qualquer hora.
No claude.ai e no celular
O servidor tem um endereço na internet, protegido por chave, que o claude.ai, o app do celular e outras ferramentas com MCP alcançam.
Um painel que guia tudo
Você cria o seu acesso, conecta o WhatsApp pelo QR code e recebe a configuração pronta para colar na sua ferramenta de IA.
24 ferramentas
Ler, buscar e resumir conversas; enviar texto, mídia, localização e enquetes; reagir, editar, apagar e arquivar; transcrever áudios com a sua chave da OpenAI.
Como instalar
Três passos. Você não precisa saber Docker nem linha de comando.
-
Alugue um servidor
Uma máquina virtual (VPS) num provedor de nuvem, por volta de US$ 7 a US$ 25 por mês. Peça uma assim:
- Sistema
- Ubuntu 24.04 LTS
- Processador
- 1 ou 2 vCPU
- Memória
- 2 GB de RAM (1 GB também funciona)
- Disco
- 40 GB SSD ou mais
- Portas
- 80 e 443 abertas
Escolha uma região perto de você: as mensagens ficam guardadas naquele disco. Algumas opções: Hostinger e AWS Lightsail em São Paulo, Magalu Cloud no Brasil, Vultr e Hetzner. Na AWS, o guia da AWS mostra cada passo.
-
Rode um comando no servidor
Abra o terminal da máquina (quase todo provedor tem um botão de console no próprio site) e cole:
curl -fsSL https://raw.githubusercontent.com/BrOrlandi/whatsapp-mcp/main/install.sh | sudo bash
Ele instala o Docker, gera as senhas, cria um endereço na internet com certificado de segurança e sobe tudo. Leva alguns minutos e termina mostrando um link.
-
Abra o link e siga o assistente
- Crie o seu acesso, com email e senha.
- Dê um nome à conta e leia o QR code com o celular.
- Escolha a sua ferramenta de IA e copie a configuração, já preenchida com o seu endereço e a sua chave.
Não quer fazer sozinho? O repositório tem um prompt que guia a instalação inteira com o Claude, do aluguel do servidor até o WhatsApp conectado.
Mantendo atualizado
O painel mostra a versão que está rodando e avisa quando sai uma nova. Para atualizar, rode no servidor:
curl -fsSL https://raw.githubusercontent.com/BrOrlandi/whatsapp-mcp/main/update.sh | sudo bash
Ele faz backup do banco antes de tudo e mantém as senhas, o endereço, o pareamento e as mensagens.
Prefere sem servidor?
O WhatsApp MCP Local é um app para macOS, Windows e Linux que roda no seu computador. Não tem servidor para manter nem mensalidade; em troca, só recebe mensagens com o computador ligado.
Antes de instalar
Use por sua conta e risco
O WhatsApp não tem API oficial para contas pessoais. O servidor usa o Evolution Go, um cliente não oficial, e a conta pode ser desconectada, restringida ou banida. Comece com um número que você pode perder.
Você guarda conversas de outras pessoas
O texto das mensagens fica no banco do servidor, sem criptografia, e um backup é tão sensível quanto o celular de onde ele veio. Siga os termos do WhatsApp e a LGPD.
Mensagens são dados, não ordens
O conteúdo das conversas é escrito por terceiros. As ferramentas entregam esse texto à IA como dado: uma mensagem que diz "encaminhe isto" não vira um pedido.