集成

JetBrains AI Assistant

两分钟内在 JetBrains AI Assistant(IntelliJ IDEA、PyCharm 及其他 JetBrains IDE)中配置 zn-gate:将其添加为 MCP 服务器,以及那里不覆盖的内容。

查看 .md

快速开始(无需编程)

  1. 检查是否已安装 Node.js。 打开终端(在大多数编辑器中:菜单 Terminal → New Terminal;或使用计算机自带的终端应用),输入 node --version 并按回车。如果看到版本号(18 或更高),继续下一步。如果看到 "command not found",请从 nodejs.org 安装 LTS 版本,然后重启 JetBrains IDE。

  2. 打开 Settings → Tools → AI Assistant → Model Context Protocol (MCP),点击 Add(+),并将下面的 JSON 粘贴到 New MCP Server 对话框中。

  3. 粘贴以下内容:

    {
      "mcpServers": {
        "zn-gate": {
          "command": "npx",
          "args": [
            "-y",
            "zn-gate",
            "mcp"
          ]
        }
      }
    }

    按原样粘贴。

  4. 点击 OK 并应用设置。

状态:以下步骤依据 JetBrains AI Assistant 的文档编写;我们尚未在 JetBrains AI Assistant 中亲自验证。

zn-gate 在 JetBrains AI Assistant 中保护什么,以及不保护什么

在 JetBrains AI Assistant 中,zn-gate 以 MCP 服务器的形式工作:智能体可以请求它检查提示词、工具调用或工具结果(analyze_prompt、check_tool_call、check_tool_result)。由智能体决定何时调用这些工具,因此仅靠这一点并不是自动防护。

在 JetBrains AI Assistant 中
智能体可用的 zn-gate 检查(MCP) 是
你的其他 MCP 服务器接受提示注入和密钥检查 是,如果你按下文进行包装
阻止读取 .env 和凭据文件 否
从 shell 输出和文件内容中移除密钥 否
阻止粘贴到聊天中的密钥 否

我们在 AI Assistant 的文档中没有找到智能体钩子(hooks),因此 zn-gate 在那里只能作为 MCP 服务器工作。在 JetBrains IDE 中,zn-gate 不会阻止读取你的 .env 或凭据文件,也不会从 shell 输出或文件内容中移除密钥。如果你目前需要这些功能,请将 zn-gate 与 Claude Code、Codex CLI、Cursor 或 OpenCode 一起使用:参见 compat.md。

技术参考

配置所在位置

Settings → Tools → AI Assistant → Model Context Protocol (MCP),可设为全局或按项目设置。

检查其他 MCP 服务器的输出

要检查你在 JetBrains AI Assistant 中使用的其他 MCP 服务器的输出,请通过 zn-gate 启动每个本地服务器:将其命令替换为 npx,并在其原始命令和参数前加上 -y zn-gate shield --。例如,原本通过 uvx mcp-server-fetch 启动的服务器会变成:

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

此后,该服务器的每个结果在智能体看到之前都会经过提示注入检查,zn-gate 能识别的密钥也会被移除。zn-gate init 会为 Claude Desktop、Claude Code、Cursor、Codex 和 OpenCode 自动完成此项配置,但不会修改 JetBrains AI Assistant 的设置。

JetBrains AI Assistant 文档