Integraciones

VS Code (GitHub Copilot)

Configura zn-gate en VS Code con el modo agente de GitHub Copilot en dos minutos: añádelo como servidor MCP y lo que zn-gate todavía no cubre ahí.

Ver .md

Inicio rápido (sin necesidad de programar)

  1. Comprueba que Node.js está instalado. Abre una terminal (en la mayoría de editores: menú Terminal → Nueva terminal; o la aplicación Terminal de tu ordenador), escribe node --version y pulsa Enter. Si ves un número de versión (18 o posterior), continúa. Si ves "command not found", instala la versión LTS desde nodejs.org y reinicia VS Code.

  2. Abre la Paleta de comandos (Ctrl+Shift+P, o Cmd+Shift+P en un Mac), escribe MCP: Open User Configuration y pulsa Enter. VS Code abre un archivo llamado mcp.json.

  3. Pega esto:

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

    Si el archivo ya tiene una sección "servers", añade solo la parte "zn-gate": {...} dentro de ella.

  4. Guarda el archivo y haz clic en Start en los pequeños enlaces que aparecen encima de la entrada zn-gate (o ejecuta MCP: List Servers desde la Paleta de comandos).

Estado: estos pasos siguen la documentación de VS Code; todavía no los hemos verificado nosotros en VS Code.

Lo que zn-gate protege en VS Code, y lo que no

En VS Code, zn-gate funciona como servidor MCP: el agente puede pedirle que revise un prompt, una llamada a herramienta o un resultado de herramienta (analyze_prompt, check_tool_call, check_tool_result). Es el agente quien decide cuándo llamar a estas herramientas, así que por sí solo esto no es una protección automática.

En VS Code
Comprobaciones de zn-gate disponibles para el agente (MCP) Sí
Tus otros servidores MCP revisados en busca de prompt injection y secretos Sí, si los envuelves (abajo)
Bloquea las lecturas de .env y de archivos de credenciales No
Elimina secretos de la salida de la shell y del contenido de los archivos No
Bloquea un secreto pegado en el chat No

VS Code tiene hooks de agente en vista previa (PreToolUse, PostToolUse y otros, en .github/hooks/*.json), pero zn-gate todavía no instala hooks para VS Code y no hemos comprobado si los hooks de VS Code ven las llamadas a herramientas MCP. Por tanto, en VS Code zn-gate no bloquea las lecturas de tu .env ni de tus archivos de credenciales, y no elimina secretos de la salida de la shell ni del contenido de los archivos. Si necesitas eso hoy, usa zn-gate con Claude Code, Codex CLI, Cursor u OpenCode: consulta compat.md.

Referencia técnica

Dónde vive la configuración

Usuario: MCP: Open User Configuration. Un proyecto: .mcp.json en la raíz del proyecto (clave de nivel superior mcpServers), que VS Code recomienda ahora; .vscode/mcp.json (clave de nivel superior servers) sigue funcionando.

Revisa la salida de tus otros servidores MCP

Para revisar la salida de los otros servidores MCP que usas en VS Code, inicia cada servidor local a través de zn-gate: sustituye su comando por npx y coloca -y zn-gate shield -- delante de su comando y argumentos originales. Por ejemplo, un servidor iniciado con uvx mcp-server-fetch queda así:

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

Cada resultado de ese servidor se revisa entonces en busca de prompt injection, y los secretos que zn-gate reconoce se eliminan, antes de que el agente lo vea. zn-gate init, que hace esto automáticamente para Claude Desktop, Claude Code, Cursor, Codex y OpenCode, no edita la configuración de VS Code.

Documentación de VS Code