WACrew

Guia

WhatsApp no Claude Desktop com MCP, passo a passo

Como colocar um servidor MCP de WhatsApp no Claude Desktop pelo claude_desktop_config.json, no macOS e no Windows, conferir se as ferramentas carregaram e perguntar ao Claude sobre seus grupos e conversas.

Atualizado em 2 min de leitura
Nesta página
  1. O que você precisa
  2. Edite o claude_desktop_config.json
  3. O que pedir
  4. O envio continua cuidadoso
  5. Se as ferramentas não aparecerem
  6. Perguntas frequentes

O Claude Desktop é o jeito mais amigável de testar um servidor MCP de WhatsApp no Claude: nada de terminal aberto, e o Claude resume um grupo ou rascunha uma resposta numa janela de conversa normal. A configuração é um arquivo JSON. Este guia usa o servidor de código aberto do WACrew, o wacrew-mcp.

O que você precisa

  • Um coletor do WACrew segurando a sessão do WhatsApp, numa VPS ou na Railway, com HTTPS na frente do painel. O guia do conector resolve isso em dois comandos.
  • Node 20 ou mais novo no computador que roda o Claude Desktop, porque o servidor sobe pelo npx.

Edite o claude_desktop_config.json

No Claude Desktop, abra Configurações, Desenvolvedor, Editar configuração. Ele abre o arquivo:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Coloque o servidor dentro de mcpServers (mantenha os que já estiverem lá):

{
  "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"
      }
    }
  }
}

Feche o Claude Desktop de vez e abra de novo. O servidor aparece no menu de ferramentas da caixa de mensagem, com 37 ferramentas.

O que pedir

  • "Quem está esperando resposta no WhatsApp?" (caixa_de_entrada)
  • "Resume o dia no grupo do projeto Acme." (resumo_do_dia)
  • "Transcreve o último áudio da Ana." (transcrever)
  • "Rascunha uma resposta para a última mensagem desse grupo e me mostra antes de mandar." (preparar_resposta e, depois do seu OK, responder)

O Claude pede permissão antes de chamar uma ferramenta, a menos que você libere para a conversa. Deixe isso ligado para as ferramentas de envio no começo.

O envio continua cuidadoso

Todo chat começa no modo confirmar, então as instruções mandam o Claude mostrar o texto antes. O responder passa por uma revisão que recusa texto com cara de robô (tratamento errado, confissão de culpa, abertura repetida) e devolve um ticket: a mensagem sai depois, no ritmo de uma pessoa, e o cancelar_envio para tudo.

Se as ferramentas não aparecerem

Abra Configurações, Desenvolvedor: o Claude Desktop mostra o estado do servidor e um link para o log. As causas comuns são JSON inválido (vírgula faltando), Node fora do PATH que o Claude Desktop enxerga, ou endereço ou senha do painel errados. Mais em problemas comuns.

Perguntas frequentes

O Claude Desktop mantém o WhatsApp conectado? Não, quem faz isso é o coletor. O Claude Desktop só inicia o servidor MCP enquanto está aberto, e o servidor lê do coletor.

Dá para usar o mesmo servidor no Claude Code? Dá. O Claude Code usa claude mcp add, com as mesmas variáveis; veja o guia do Claude Code.

O Claude vai mandar mensagem sozinho? Não no modo confirmar, que é o padrão. Mesmo no automático, todo envio passa pela revisão e pode ser cancelado.

Meus dados do WhatsApp vão para a Anthropic? Só o que as ferramentas devolvem na conversa que você está tendo, como em qualquer servidor MCP. O histórico fica no seu coletor.