WACrew

Guia

WhatsApp no Codex com MCP

Como ligar o WhatsApp ao Codex da OpenAI com um servidor MCP: o bloco do config.toml, as variáveis de ambiente, um teste rápido e um fluxo que combina com o Codex.

Atualizado em 2 min de leitura
Nesta página
  1. Antes de começar
  2. Adicione o servidor no config.toml
  3. Teste
  4. Um fluxo que combina com o Codex
  5. O envio continua com você
  6. Perguntas frequentes

O Codex CLI da OpenAI fala MCP, então consegue ler e responder o WhatsApp com o mesmo tipo de servidor que o Claude Code usa. A maioria dos READMEs de MCP de WhatsApp só mostra o JSON do Claude Desktop e do Cursor. O Codex usa TOML, e é aí que muita gente trava. Este guia usa o servidor do WACrew, publicado no npm como wacrew-mcp.

Antes de começar

Você precisa de Node 20+ onde o Codex roda e de um coletor do WACrew segurando a sessão do WhatsApp. Numa VPS:

git clone https://github.com/sumioshi/wacrew && cd wacrew
PANEL_USER=admin PANEL_PASS=troque-isto docker compose up -d

Abra http://<ip-do-servidor>:3000/config, escaneie o QR em WhatsApp, Aparelhos conectados, e coloque HTTPS na frente do painel (Caddy, um túnel ou o proxy do provedor) antes de expor.

Adicione o servidor no config.toml

O Codex lê os servidores MCP de ~/.codex/config.toml. Acrescente:

[mcp_servers.wacrew]
command = "npx"
args = ["-y", "wacrew-mcp"]
env = { WAC_CLOUD_URL = "https://seu-painel.exemplo.com", WAC_CLOUD_USER = "admin", WAC_CLOUD_PASS = "troque-isto" }

Reinicie o Codex. Versões recentes também têm o subcomando codex mcp para adicionar e listar servidores pelo terminal; o resultado é o mesmo bloco no config.toml. Coletor na mesma máquina? Troque as três variáveis por WAC_DATA_DIR = "/caminho/para/wacrew/data".

Teste

  • "Lista minhas conversas do WhatsApp e diz qual cliente está esperando há mais tempo."
  • "Procura no WhatsApp a última vez que alguém falou da URL de homologação."
  • "Lê o PDF que o cliente mandou no grupo da Acme e lista os pedidos de mudança."

O Codex escolhe listar_grupos, caixa_de_entrada, buscar e ler_documento pela descrição. Todas estão em as 36 ferramentas.

Um fluxo que combina com o Codex

O Codex costuma estar aberto num repositório. O cliente relata um bug no WhatsApp com gravação de tela, o Codex assiste com assistir_video, acha a causa no código, corrige e prepara uma resposta para você aprovar. Quando a correção sobe, registrar_feature conta a entrega para aquele cliente no painel.

O envio continua com você

Toda conversa começa no modo Confirmar: o agente mostra a mensagem antes de mandar. Depois do OK, a entrega tem ticket e sai no ritmo de gente, e cancelar_envio interrompe. As aprovações do próprio Codex valem por cima.

Perguntas frequentes

O Codex precisa do painel do WACrew? O painel é onde o coletor roda e onde você escaneia o QR. O Codex só conversa com o servidor MCP.

Dá para usar outro servidor MCP de WhatsApp? Dá. Qualquer servidor stdio usa o mesmo formato de TOML.

É a API oficial? Não. O WACrew conecta como aparelho a mais via Baileys. Use com quem já fala com você, nunca para disparo em massa.