Um servidor MCP de WhatsApp só vê as mensagens que chegam enquanto a sessão está online. No notebook que dorme, o histórico fica com buracos. Docker numa VPS pequena resolve e deixa a instalação reproduzível. Para o lado da hospedagem em geral, veja também como hospedar um bot de WhatsApp 24 horas.
O que precisa persistir
Em qualquer projeto, monte um volume para duas coisas: a sessão do WhatsApp (perdeu, escaneia o QR de novo) e o armazenamento das mensagens e mídias.
WACrew
O repositório tem Dockerfile, docker-compose.yml e imagem pronta em ghcr.io/sumioshi/wacrew.
git clone https://github.com/sumioshi/wacrew && cd wacrew
cp .env.example .env # defina PANEL_USER e PANEL_PASS
docker compose up -d
O contêiner roda o coletor e o painel na porta 3000, com dados num volume em /data. O QR fica em /config. O cliente MCP não roda no Docker: ele executa npx -y wacrew-mcp na sua máquina e fala com o painel por HTTPS com WAC_CLOUD_URL, WAC_CLOUD_USER e WAC_CLOUD_PASS. Sem PANEL_USER e PANEL_PASS o painel fica aberto, o que só serve em localhost. Quem não quer cuidar de servidor tem o template da Railway, que já cria volume, login e senha.
whatsapp-mcp-extended
O FelixIsaac/whatsapp-mcp-extended sobe a ponte em Go (porta 8080), o servidor MCP em Python (8081) e uma interface web (8090) com docker compose. O README cria uma rede Docker externa antes, e o QR aparece em docker-compose logs -f whatsapp-bridge. A configuração do cliente continua apontando o uv para a pasta do servidor.
whatzmcp
O whatzmcp publica ghcr.io/whatzmcp/whatzmcp. Você pareia uma vez de forma interativa e depois usa docker run -i como comando no cliente MCP, que sobe o contêiner por stdio. A máquina fica limpa, mas a sessão só fica online enquanto o cliente está rodando.
| Padrão | Sempre online | Exemplo |
|---|---|---|
| Contêiner fixo no servidor, MCP conecta de fora | Sim | WACrew, whatsapp-mcp-extended |
| Contêiner iniciado pelo cliente MCP | Só com o cliente aberto | whatzmcp |
Checklist de segurança
- HTTPS e login na frente de qualquer painel ou endpoint HTTP.
- Nunca versione a pasta da sessão nem o
.env. - Faça backup do volume: ele guarda suas conversas.
- Controle quem pode receber mensagem do agente. No WACrew, as conversas começam no modo Confirmar; o whatsapp-mcp-extended tem lista de permitidos (
WHATSAPP_ALLOWLIST_JIDS).
Perguntas frequentes
Que servidor eu preciso? Uma VPS pequena dá conta de um número. Transcrição no servidor usa API (TRANSCRIBE_BACKEND=openrouter no WACrew), a não ser que tenha GPU.
E vários números? Cada instalação do WACrew guarda uma sessão; rode um contêiner e um volume por número.
Docker diminui o risco de banimento? Não. O risco depende do uso da conta, não de onde a sessão roda.



