Integrações

VS Code (GitHub Copilot)

Configure o zn-gate no VS Code com o modo agente do GitHub Copilot em dois minutos: adicione-o como servidor MCP e veja o que o zn-gate ainda não cobre ali.

Ver .md

Início rápido (sem precisar programar)

  1. Verifique se o Node.js está instalado. Abra um terminal (na maioria dos editores: menu Terminal → New Terminal; ou o aplicativo Terminal do seu computador), digite node --version e pressione Enter. Se aparecer um número de versão (18 ou superior), continue. Se aparecer "command not found", instale a versão LTS em nodejs.org e reinicie o VS Code.

  2. Abra a Command Palette (Ctrl+Shift+P, ou Cmd+Shift+P em um Mac), digite MCP: Open User Configuration e pressione Enter. O VS Code abre um arquivo chamado mcp.json.

  3. Cole isto:

    {
  "servers": {
    "zn-gate": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "zn-gate",
        "mcp"
      ]
    }
  }
}

    Se o arquivo já tiver uma seção "servers", adicione apenas a parte "zn-gate": {...} dentro dela.

  4. Salve o arquivo e clique em Start nos pequenos links exibidos acima da entrada zn-gate (ou execute MCP: List Servers na Command Palette).

Status: estas etapas seguem a documentação do VS Code; ainda não foram verificadas por nós no VS Code.

O que o zn-gate protege no VS Code, e o que não protege

No VS Code, o zn-gate funciona como um servidor MCP: o agente pode pedir a ele que verifique um prompt, uma chamada de ferramenta ou um resultado de ferramenta (analyze_prompt, check_tool_call, check_tool_result). O agente decide quando chamar essas ferramentas, então, por si só, isso não é uma proteção automática.

No VS Code
Verificações do zn-gate disponíveis para o agente (MCP) Sim
Seus outros servidores MCP verificados quanto a prompt injection e segredos Sim, se você os envolver (abaixo)
Bloqueia leituras de .env e arquivos de credenciais Não
Remove segredos da saída do shell e do conteúdo de arquivos Não
Bloqueia um segredo colado no chat Não

O VS Code tem hooks de agente em preview (PreToolUse, PostToolUse e outros, em .github/hooks/*.json), mas o zn-gate ainda não instala hooks para o VS Code, e não verificamos se os hooks do VS Code enxergam chamadas de ferramentas MCP. Portanto, no VS Code o zn-gate não bloqueia leituras do seu .env ou de arquivos de credenciais e não remove segredos da saída do shell ou do conteúdo de arquivos. Se você precisa disso hoje, use o zn-gate com Claude Code, Codex CLI, Cursor ou OpenCode: veja compat.md.

Referência técnica

Onde fica a configuração

Usuário: MCP: Open User Configuration. Um projeto: .mcp.json na raiz do projeto (chave de nível superior mcpServers), que o VS Code agora recomenda; .vscode/mcp.json (chave de nível superior servers) ainda funciona.

Verifique a saída dos seus outros servidores MCP

Para verificar a saída dos outros servidores MCP que você usa no VS Code, inicie cada servidor local por meio do zn-gate: substitua o comando dele por npx e coloque -y zn-gate shield -- antes do comando e dos argumentos originais. Por exemplo, um servidor iniciado com uvx mcp-server-fetch fica assim:

{
  "servers": {
    "fetch": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "zn-gate",
        "shield",
        "--",
        "uvx",
        "mcp-server-fetch"
      ]
    }
  }
}

Cada resultado desse servidor passa a ser verificado quanto a prompt injection, e os segredos que o zn-gate reconhece são removidos, antes que o agente o veja. O zn-gate init, que faz isso automaticamente para Claude Desktop, Claude Code, Cursor, Codex e OpenCode, não edita as configurações do VS Code.

Documentação do VS Code