集成
JetBrains AI Assistant
两分钟内在 JetBrains AI Assistant(IntelliJ IDEA、PyCharm 及其他 JetBrains IDE)中配置 zn-gate:将其添加为 MCP 服务器,以及那里不覆盖的内容。
快速开始(无需编程)
-
检查是否已安装 Node.js。 打开终端(在大多数编辑器中:菜单 Terminal → New Terminal;或使用计算机自带的终端应用),输入
node --version并按回车。如果看到版本号(18 或更高),继续下一步。如果看到 "command not found",请从 nodejs.org 安装 LTS 版本,然后重启 JetBrains IDE。 -
打开 Settings → Tools → AI Assistant → Model Context Protocol (MCP),点击 Add(+),并将下面的 JSON 粘贴到 New MCP Server 对话框中。
-
粘贴以下内容:
{ "mcpServers": { "zn-gate": { "command": "npx", "args": [ "-y", "zn-gate", "mcp" ] } } }按原样粘贴。
-
点击 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 文档
- AI Assistant 中的 MCP:https://www.jetbrains.com/help/ai-assistant/mcp.html