Um conector MCP de WhatsApp tem duas partes: algo que fica conectado ao WhatsApp e guarda as mensagens, e um servidor MCP que o seu cliente de IA consegue iniciar. No WACrew, a primeira é um coletor pequeno que você hospeda, e a segunda é um pacote do npm, o wacrew-mcp, que qualquer cliente MCP roda.
Passo 1: suba o coletor
O coletor é a parte que segura a sessão do WhatsApp 24 horas. Em qualquer VPS com Docker:
git clone https://github.com/sumioshi/wacrew && cd wacrew
PANEL_USER=admin PANEL_PASS=troque-esta-senha docker compose up -d
A Railway também sobe em um clique pelo README. Coloque HTTPS na frente do painel antes de abrir para a internet.
Passo 2: pareie o número
Abra http://<servidor>:3000/config e escaneie o QR em WhatsApp, Aparelhos conectados. A partir daí, todo grupo e conversa fica guardado, áudio incluído.
Passo 3: registre o servidor MCP no seu cliente
O servidor é o mesmo em todo lugar: npx -y wacrew-mcp com três variáveis, WAC_CLOUD_URL (o endereço do painel), WAC_CLOUD_USER e WAC_CLOUD_PASS (o login do painel). Só muda onde você escreve.
| cliente | onde | guia |
|---|---|---|
| Claude Code | claude mcp add wacrew -e WAC_CLOUD_URL=... -e WAC_CLOUD_USER=... -e WAC_CLOUD_PASS=... -- npx -y wacrew-mcp | Claude Code |
| Claude Desktop | claude_desktop_config.json, chave mcpServers | Claude Desktop |
| Codex | ~/.codex/config.toml, tabela [mcp_servers.wacrew] | Codex |
| Cursor | ~/.cursor/mcp.json, chave mcpServers | Cursor |
| Gemini CLI | ~/.gemini/settings.json, chave mcpServers | Gemini CLI |
| Antigravity | agy plugin install https://github.com/sumioshi/wacrew | Antigravity |
Nos clientes que usam JSON, o bloco é o mesmo:
{
"mcpServers": {
"wacrew": {
"command": "npx",
"args": ["-y", "wacrew-mcp"],
"env": {
"WAC_CLOUD_URL": "https://seu-painel.exemplo.com",
"WAC_CLOUD_USER": "admin",
"WAC_CLOUD_PASS": "troque-esta-senha"
}
}
}
}
O Node 20 ou mais novo precisa estar instalado onde o cliente roda, porque é o npx que inicia o servidor.
Teste
Reinicie o cliente e peça: "lista meus grupos de WhatsApp". O agente deve chamar listar_grupos e responder com os seus chats. Depois tente "quem está esperando resposta?", que usa a caixa_de_entrada.
Antes de o agente mandar qualquer coisa
Todo chat começa no modo confirmar: o agente é orientado a mostrar o texto e esperar o seu OK. A resposta passa por uma revisão que recusa texto com cara de robô e sai como um ticket, no ritmo de uma pessoa, que você pode cancelar. Passe um chat para o automático só quando confiar nele ali. A segurança do MCP de WhatsApp tem o resto.
Perguntas frequentes
Preciso do coletor ou o servidor MCP fala com o WhatsApp direto? Algo precisa ficar conectado para receber mensagem enquanto o seu notebook dorme. O coletor faz isso; o servidor MCP só conversa com ele.
Dá para conectar mais de um número? Dá, um servidor só atende vários painéis. Veja várias contas de WhatsApp num servidor MCP.
É a API oficial do WhatsApp? Não. O coletor conecta como aparelho a mais pelo Baileys. Use com quem já fala com você, não para disparo em massa.
Quais clientes têm MCP? Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI, Antigravity, Qwen Code e muitos outros. Qualquer cliente que rode servidor MCP por stdio funciona.



