WACrew

Guia

WhatsApp no Gemini CLI com MCP: configuração no settings.json

Como conectar o WhatsApp ao Gemini CLI do Google com um servidor MCP, o bloco do settings.json, como conferir com /mcp e o que o Gemini consegue fazer com seus grupos e conversas.

Atualizado em 2 min de leitura
Nesta página
  1. Antes de começar
  2. Coloque o servidor no settings.json
  3. Confira
  4. Gemini CLI ou Antigravity?
  5. O que muda em relação ao Claude Code
  6. Perguntas frequentes

O Gemini CLI roda servidores MCP a partir do arquivo de configuração dele, então um MCP de WhatsApp no Gemini CLI está a um bloco de JSON de distância. Com ele no lugar, o Gemini lista seus grupos, lê uma conversa, transcreve áudio e rascunha respostas pelo terminal. Este guia usa o servidor de código aberto do WACrew, o wacrew-mcp.

Antes de começar

Você precisa de um coletor do WACrew segurando a sessão do WhatsApp (numa VPS ou na Railway, com HTTPS na frente do painel; veja o guia do conector) e do Node 20 ou mais novo onde o Gemini CLI roda.

Coloque o servidor no settings.json

O Gemini CLI lê ~/.gemini/settings.json para todos os projetos, ou .gemini/settings.json dentro de um projeto só para ele. Adicione:

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

Se o arquivo já tem outras chaves, coloque mcpServers ao lado delas; JSON não aceita chave repetida.

Confira

Abra o gemini e digite /mcp. O servidor wacrew deve aparecer conectado, com as ferramentas. Depois pergunte "quem está esperando resposta no WhatsApp?" e o Gemini chama a caixa_de_entrada.

Gemini CLI ou Antigravity?

Os dois são do Google e guardam os servidores MCP em lugares diferentes. O Gemini CLI usa o settings.json acima. O Antigravity (o editor e a CLI agy) tem configuração própria e um sistema de plugins, e o WACrew entra lá como plugin, com as skills; veja WhatsApp no Antigravity.

O que muda em relação ao Claude Code

Do lado do WhatsApp, nada: as mesmas 37 ferramentas, o mesmo modo confirmar por chat, a mesma revisão antes de qualquer envio. As instruções do servidor pedem para o modelo carregar a skill de voz do operador antes de escrever; no Gemini CLI essa skill não carrega sozinha, então escreva suas preferências num GEMINI.md ou cole na conversa, e mantenha os chats em confirmar até os rascunhos soarem como você.

Perguntas frequentes

O Gemini CLI aceita servidor MCP por stdio? Aceita, com command e args em mcpServers, que é o que o wacrew-mcp usa.

Dá para ligar dois números de WhatsApp? Dá, um servidor só atende vários painéis com WAC_CONTAS. Veja várias contas.

Onde fica meu histórico do WhatsApp? No seu coletor. O Gemini só vê o que uma ferramenta devolve na sessão.

É a API oficial do WhatsApp? Não, o coletor conecta como aparelho a mais. Use com quem já fala com você.