Intégrations

VS Code (GitHub Copilot)

Configurer zn-gate dans VS Code avec le mode agent de GitHub Copilot en deux minutes : l'ajouter comme serveur MCP, et ce que zn-gate ne couvre pas encore là-bas.

Voir le .md

Démarrage rapide (sans programmation)

  1. Vérifiez que Node.js est installé. Ouvrez un terminal (dans la plupart des éditeurs : menu Terminal → Nouveau terminal ; ou l'application Terminal de votre ordinateur), tapez node --version et appuyez sur Entrée. Si vous voyez un numéro de version (18 ou plus récent), passez à la suite. Si vous voyez « command not found », installez la version LTS depuis nodejs.org puis redémarrez VS Code.

  2. Ouvrez la Palette de commandes (Ctrl+Shift+P, ou Cmd+Shift+P sur Mac), tapez MCP: Open User Configuration et appuyez sur Entrée. VS Code ouvre un fichier nommé mcp.json.

  3. Collez ceci :

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

    Si le fichier contient déjà une section "servers", ajoutez uniquement la partie "zn-gate": {...} à l'intérieur.

  4. Enregistrez le fichier, puis cliquez sur Start dans les petits liens affichés au-dessus de l'entrée zn-gate (ou exécutez MCP: List Servers depuis la Palette de commandes).

Statut : ces étapes suivent la documentation de VS Code ; nous ne les avons pas encore vérifiées nous-mêmes dans VS Code.

Ce que zn-gate protège dans VS Code, et ce qu'il ne protège pas

Dans VS Code, zn-gate fonctionne comme un serveur MCP : l'agent peut lui demander de vérifier un prompt, un appel d'outil ou un résultat d'outil (analyze_prompt, check_tool_call, check_tool_result). C'est l'agent qui décide quand appeler ces outils, donc à lui seul, ceci n'est pas une protection automatique.

Dans VS Code
Contrôles de zn-gate disponibles pour l'agent (MCP) Oui
Vos autres serveurs MCP contrôlés pour l'injection de prompt et les secrets Oui, si vous les encapsulez (voir ci-dessous)
Bloque la lecture de .env et des fichiers d'identifiants Non
Supprime les secrets de la sortie du shell et du contenu des fichiers Non
Bloque un secret collé dans le chat Non

VS Code dispose de hooks d'agent en préversion (PreToolUse, PostToolUse et d'autres, dans .github/hooks/*.json), mais zn-gate n'installe pas encore de hooks pour VS Code, et nous n'avons pas vérifié si les hooks VS Code voient les appels d'outils MCP. Ainsi, dans VS Code, zn-gate ne bloque pas la lecture de votre .env ou de vos fichiers d'identifiants et ne supprime pas les secrets de la sortie du shell ou du contenu des fichiers. Si vous en avez besoin dès aujourd'hui, utilisez zn-gate avec Claude Code, Codex CLI, Cursor ou OpenCode : voir compat.md.

Référence technique

Où se trouve la configuration

Utilisateur : MCP: Open User Configuration. Pour un projet : .mcp.json à la racine du projet (clé de premier niveau mcpServers), que VS Code recommande désormais ; .vscode/mcp.json (clé de premier niveau servers) fonctionne toujours.

Vérifier la sortie de vos autres serveurs MCP

Pour vérifier la sortie des autres serveurs MCP que vous utilisez dans VS Code, lancez chaque serveur local via zn-gate : remplacez sa commande par npx et placez -y zn-gate shield -- devant sa commande et ses arguments d'origine. Par exemple, un serveur lancé avec uvx mcp-server-fetch devient :

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

Chaque résultat de ce serveur est alors contrôlé pour l'injection de prompt, et les secrets reconnus par zn-gate sont supprimés, avant que l'agent ne le voie. zn-gate init, qui effectue cette opération automatiquement pour Claude Desktop, Claude Code, Cursor, Codex et OpenCode, ne modifie pas les paramètres de VS Code.

Documentation VS Code