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:
ChatGPT
Funciona no app do ChatGPT para computador (Mac ou Windows). O ChatGPT no navegador não conversa com programas da sua máquina, então precisa ser o app.
- Abra Configurações e vá em Servidores MCP
- Clique em Adicionar servidor e dê o nome
zerozapp - Em Tipo, escolha STDIO. Em Comando para iniciar, escreva
npx - Em Argumentos, clique em Adicionar argumento duas vezes e preencha
-y e @zerozapp/mcp - Clique em Salvar e depois em Reiniciar
💡 Pra conferir, digite /mcp na caixa de mensagem do ChatGPT: o zerozapp tem que aparecer na lista.
Já usa o Codex? O app usa a mesma configuração dele, então dá pra colar isto no arquivo ~/.codex/config.toml:
[mcp_servers.zerozapp]
command = "npx"
args = ["-y", "@zerozapp/mcp"]
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.