WACrew

Guia

Conector MCP de WhatsApp: como ligar o WhatsApp a qualquer cliente MCP

Como conectar o WhatsApp ao MCP em três passos, rodar o coletor, parear o número e registrar um servidor, com a configuração exata para Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI e Antigravity.

Atualizado em 2 min de leitura
Nesta página
  1. Passo 1: suba o coletor
  2. Passo 2: pareie o número
  3. Passo 3: registre o servidor MCP no seu cliente
  4. Teste
  5. Antes de o agente mandar qualquer coisa
  6. Perguntas frequentes

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.

clienteondeguia
Claude Codeclaude mcp add wacrew -e WAC_CLOUD_URL=... -e WAC_CLOUD_USER=... -e WAC_CLOUD_PASS=... -- npx -y wacrew-mcpClaude Code
Claude Desktopclaude_desktop_config.json, chave mcpServersClaude Desktop
Codex~/.codex/config.toml, tabela [mcp_servers.wacrew]Codex
Cursor~/.cursor/mcp.json, chave mcpServersCursor
Gemini CLI~/.gemini/settings.json, chave mcpServersGemini CLI
Antigravityagy plugin install https://github.com/sumioshi/wacrewAntigravity

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.