🤖 Novo na v0.5.0

Conecte o WhatsApp à sua IA

Deixe o Claude (ou outro assistente) ler suas mensagens, responder e transcrever áudios direto no WhatsApp. Sem saber programar: é só seguir os passos abaixo. Tudo roda na sua máquina, nada passa por servidor externo.

Antes de tudo: tenha a extensão ZeroZapp instalada e o WhatsApp Web aberto e logado no navegador. O resto é o passo a passo abaixo, do zero.
1

Instale o Node.js

Por que isso? O servidor do ZeroZapp é um programinha em JavaScript, e o Node.js é o motor que faz ele rodar na sua máquina. É grátis, você instala uma vez e esquece.

  1. 1. Acesse nodejs.org
  2. 2. Baixe o botão que diz "LTS" (a versão estável)
  3. 3. Abra o arquivo baixado e vá clicando em continuar até terminar

Quer confirmar que deu certo? Abra o app Terminal (no Mac, busque por "Terminal" no Spotlight) e cole isto:

node --version

Aperte Enter. Se aparecer um número como v20.11.0, está tudo certo.

2

Conecte ao seu cliente de IA

Escolha o programa que você usa:

Copie esta configuração (é o endereço que diz pro Claude como achar o ZeroZapp):

{
  "mcpServers": {
    "zerozapp": {
      "command": "npx",
      "args": ["-y", "@zerozapp/mcp"]
    }
  }
}

Agora cole no Claude Desktop:

  1. 1. Abra o menu Claude → Settings (ou aperte Cmd + vírgula)
  2. 2. Vá na aba Developer e clique em Edit Config
  3. 3. Cole o que você copiou e salve o arquivo
  4. 4. Feche o Claude por completo e abra de novo

💡 Se o arquivo já tiver outros servidores, cole só o bloco "zerozapp" dentro de "mcpServers". O arquivo fica em ~/Library/Application Support/Claude/claude_desktop_config.json.

Esses programas editam arquivos sozinhos, então o jeito mais fácil é pedir pra eles. Cole este prompt no próprio assistente:

Adicione um servidor MCP chamado "zerozapp" no meu config, com command "npx" e args ["-y", "@zerozapp/mcp"]. Depois me diga como reiniciar pra ativar.

Prefere na mão? No Claude Code, um comando no terminal resolve:

claude mcp add zerozapp -- npx -y @zerozapp/mcp

No Cursor, cole a mesma configuração da aba "Claude Desktop" no arquivo ~/.cursor/mcp.json. Depois reinicie o cliente.

3

Ative a ponte na extensão

Abra a extensão ZeroZapp, vá em Settings → MCP e ligue o Enable MCP bridge. Quando conectar, o selo fica Connected e sua conta aparece na lista.

🔒 Se a máquina for compartilhada, defina um token: adicione "env": { "ZEROZAPP_MCP_TOKEN": "seu-segredo" } na configuração do passo 2 e coloque o mesmo token na extensão.

4

Pronto! Peça algo pra sua IA

Com o WhatsApp Web aberto e a ponte conectada, é só pedir coisas como:

  • 💬 "Lista minhas conversas não lidas no WhatsApp."
  • 💬 "Manda "já estou indo" pro 5511999999999."
  • 💬 "Acha o número do André e manda o PDF que está em /tmp/relatorio.pdf."
  • 💬 "Transcreve o último áudio que a Maria me mandou."

O que a IA consegue fazer

São 16 ferramentas expostas, organizadas em três grupos:

🔍 Descoberta

list_accounts Lista as contas de WhatsApp conectadas
list_chats Conversas recentes com contagem de não lidas
get_recent_messages Última mensagem de cada conversa, pra triagem rápida
find_contact Busca contatos e conversas por nome ou telefone
list_group_participants Lista os participantes de um grupo

📖 Leitura

get_messages Lê mensagens com filtros (remetente, busca, mídia, etc)
transcribe_audio Transcreve nota de voz ou áudio (Whisper)
get_image Baixa imagem ou sticker
get_document Baixa documento (PDF, DOCX, ZIP...)
get_video Baixa vídeo

✉️ Envio e ações

send_message Envia mensagem de texto
send_image Envia imagem com legenda opcional
send_document Envia documento (PDF, DOCX, ZIP...)
react_to_message Reage a uma mensagem com emoji
open_chat Abre uma conversa na interface do WhatsApp
archive_chat Arquiva ou desarquiva uma conversa

O parâmetro account é a parte do número no ID do WhatsApp (ex: 5511999999999). Só é necessário quando você tem mais de uma conta conectada.

Como funciona por dentro

O servidor MCP roda localmente na sua máquina e fala com a extensão por WebSocket. Seu cliente de IA conversa com esse servidor, que repassa os comandos pro WhatsApp Web aberto no navegador.

Cliente de IA  ──stdio──▶  servidor @zerozapp/mcp  ──WebSocket──▶  extensão ZeroZapp
                                                                      │
                                                                      ▼
                                                                 WhatsApp Web

Aquela linha npx -y @zerozapp/mcp da configuração é o que baixa e liga o servidor automaticamente (o npx vem junto com o Node). Você pode mudar a porta com ZEROZAPP_MCP_PORT (padrão 9223); a URL do WebSocket na extensão é ws://127.0.0.1:9223.

Deu algum problema?

Nenhuma conta conectada

Confira se o WhatsApp Web está aberto e logado, e se a ponte está ativada em Settings → MCP.

A extensão fica reconectando

Confirme que a porta bate e que o token é idêntico nos dois lados. O log fica em zerozapp-mcp-daemon.log (na pasta temporária do sistema).

auth_required e desconecta

O token da extensão e o do servidor estão diferentes. Deixe os dois iguais.

A ferramenta dá timeout

O Window.Store do WhatsApp pode não estar pronto. Recarregue o WhatsApp Web e tente de novo.

Privacidade e segurança

  • 🔒 O servidor escuta só em 127.0.0.1, nunca fica acessível pela rede
  • 🔒 A ponte vem desativada por padrão: só liga quando você ativa
  • 🔒 Defina um token sempre que a máquina for compartilhada, e trate ele como senha
  • 🔒 A ponte consegue ler todas as suas mensagens e enviar mensagens em seu nome

Ainda não tem o ZeroZapp?

Instale a extensão e ative a ponte MCP em poucos minutos.

Instalar da Chrome Web Store