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.
- Acesse nodejs.org
- Baixe o botão que diz "LTS" (a versão estável)
- 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:
Claude Desktop
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:
- Abra o menu Claude → Settings (ou aperte Cmd + vírgula)
- Vá na aba Developer e clique em Edit Config
- Cole o que você copiou e salve o arquivo
- 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.
Claude Code / Cursor
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.”