WACrew

Guia

Servidor MCP de WhatsApp no Docker

Como rodar um servidor MCP de WhatsApp no Docker para ficar online 24 horas: WACrew, whatsapp-mcp-extended e whatzmcp, o volume que guarda a sessão e como o cliente MCP se conecta.

Atualizado em 2 min de leitura
Nesta página
  1. O que precisa persistir
  2. WACrew
  3. whatsapp-mcp-extended
  4. whatzmcp
  5. Checklist de segurança
  6. Perguntas frequentes

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ãoSempre onlineExemplo
Contêiner fixo no servidor, MCP conecta de foraSimWACrew, whatsapp-mcp-extended
Contêiner iniciado pelo cliente MCPSó com o cliente abertowhatzmcp

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.