JetBrains-Copilot-企业管控-MCP白名单-插件策略与权限模式

JetBrains Copilot 企业管理员可统一控制插件、MCP Server、Telemetry 与 Agent 权限，本文给出四层治理架构和部署检查。

摘要： GitHub Copilot for JetBrains 已支持企业托管设置，管理员可以统一治理 Copilot 插件及 Marketplace、MCP Server 访问、OpenTelemetry 和 Agent Permission Mode。本文依据 GitHub 官方 2026 年 8 月更新，解释 enabledPlugins、extraKnownMarketplaces、strictKnownMarketplaces、allowedMcpServers、deniedMcpServers 与 permissions.disableBypassPermissionsMode 的作用，并给出“全局 MCP 开关—私有 Registry—JetBrains 客户端 Allow/Deny—运行时审批”的四层治理方案。适合 GitHub Copilot Business/Enterprise、IntelliJ IDEA、PyCharm、WebStorm 等 JetBrains IDE 管理员与安全团队。

核心结论

JetBrains Copilot 企业管控不能只靠开发者本地 mcp.json。可靠方案需要同时控制插件来源、MCP Server 身份、可调用工具和 Agent 权限模式：企业先在 GitHub AI Controls 启用或关闭 MCP，再用私有 Registry 或 JetBrains allowedMcpServers / deniedMcpServers 限制 Server，最后禁止 Bypass Approvals 与 Autopilot 绕过人工确认。

MCP 默认应拒绝。 GitHub 的 Business/Enterprise “MCP servers in Copilot”策略默认关闭，只有经过审批的组织才应开启。
Allowlist 优先于自由安装。 生产环境用私有 Registry 或 allowedMcpServers；deniedMcpServers 用于紧急封禁和例外修补。
本地 MCP 也要纳管。 Registry-only Enforcement 同样适用于本地 Server，Server ID 必须与 Registry 中登记 ID 精确匹配。
插件策略与 MCP 策略是两层。 限制 JetBrains Plugin Marketplace 不能自动阻止手工添加 MCP；两者都要配置。
权限模式必须保守。 将 permissions.disableBypassPermissionsMode 设为 disable，阻止 Agent 使用 Bypass Approvals 或 Autopilot。

2026 年 JetBrains Copilot 企业设置更新了什么

GitHub 2026 年 8 月 18 日宣布，Copilot for JetBrains 支持企业托管设置，覆盖四个方向：插件治理、MCP Server Allowlist、Managed OpenTelemetry 和组织控制的 Permission Modes。管理员可以把一致策略应用到企业 Copilot Plan 用户，减少每台 IDE 单独配置造成的漂移。

控制字段	用途	建议基线
`enabledPlugins`	强制插件启用或禁用	只启用批准版本
`extraKnownMarketplaces`	添加批准的插件源	指向企业镜像或审核源
`strictKnownMarketplaces`	仅允许已知 Marketplace	生产开发终端启用严格模式
`allowedMcpServers`	允许连接的 MCP Server	明确列举、默认拒绝
`deniedMcpServers`	明确禁止 MCP Server	用于撤销、高风险与事件响应
OpenTelemetry 设置	统一遥测出口与观测	脱敏并接企业 Collector
`permissions.disableBypassPermissionsMode`	禁止绕过审批/Autopilot	设置为 `disable`

字段的最终 JSON Schema、层级与分发位置应以 GitHub 当前 Enterprise Managed Settings Reference 为准。下面配置是治理示意，不应直接冒充完整官方文件。

四层管控架构

第一层：GitHub Copilot 企业总开关

Enterprise Owner 在 GitHub Enterprise 的 AI Controls 中决定是否允许 “MCP servers in Copilot”。该策略只约束由配置该策略的 Organization/Enterprise 分配 Copilot Business 或 Enterprise Seat 的用户；Copilot Free、Pro、Pro+、Max 不受该企业策略治理。企业设备不应混用个人 Seat，否则会形成策略绕行。

第二层：MCP Private Registry

企业可设置 MCP Registry URL，并选择：

Allow all： Registry 仅用于发现，不限制其他 Server；
Registry only： 只有 Registry 中的 Server 可以运行。

Registry 应实现 MCP Registry v0.1 所需路径。使用 Azure API Center 时，GitHub 要求填写包含 Workspace 的 Base URL，不要自行追加 /v0.1/servers，因为 Copilot 会自动追加。

第三层：JetBrains Allow/Deny

JetBrains Managed Settings 用 allowedMcpServers 和 deniedMcpServers 控制具体 Server。推荐处理顺序：企业总开关 → Registry Enforcement → Allowlist → Denylist Emergency Override → Server 内 Tool Policy。

第四层：运行时权限与审批

Server 被允许连接不等于所有 Tool 都能自动执行。文件写入、Shell、网络、Issue/PR、部署和数据库工具仍需最小权限与人工审批。禁用 Bypass Permissions Mode 和 Autopilot，是避免 Agent 自行跳过批准的关键底线。

GitHub Policy、Registry、Client Allowlist 与 Runtime Approval 分层执行。

插件治理：防止未经审核的执行入口

JetBrains Plugin 可以读取工程、注册 IDE Action、访问网络并扩展 Agent 能力。企业应把 Copilot 插件治理纳入软件供应链管理：

用 enabledPlugins 固定允许或禁止的插件。
用 extraKnownMarketplaces 添加经过审核的企业 Marketplace。
用 strictKnownMarketplaces 限制安装来源。
对插件版本、Publisher、签名、权限、更新日志和 SBOM 进行审查。
建立紧急撤销流程，发现风险时从 Allowlist 移除并禁用插件。

概念配置：

{
  "enabledPlugins": {
    "com.github.copilot": true,
    "UNAPPROVED_PLUGIN_ID": false
  },
  "extraKnownMarketplaces": [
    "https://plugins.example.com/jetbrains/updatePlugins.xml"
  ],
  "strictKnownMarketplaces": true,
  "allowedMcpServers": [
    "com.example.mcp.github-readonly",
    "com.example.mcp.docs"
  ],
  "deniedMcpServers": [
    "com.example.mcp.legacy-admin"
  ],
  "permissions": {
    "disableBypassPermissionsMode": "disable"
  }
}

真实键值格式必须从当前 Reference 复制。Secret、PAT 和 OAuth Token 不得写入 Managed Settings；通过系统 Keychain、环境注入或企业身份系统提供。

MCP 白名单如何设计

不要只登记一个易混淆名称。每个 MCP Server 条目至少维护：

字段	说明
Canonical Server ID	Registry 与安装配置一致的唯一 ID
Owner	业务与技术责任人
Transport	Local stdio 或 Remote HTTP
Publisher/Artifact	来源、签名、镜像 Digest、版本
Tools	可用工具及读写风险
Authentication	OAuth、PAT、Workload Identity
Data Classes	可能读取或发送的数据类型
Network Destinations	允许访问的域名与服务
Approval Policy	哪些调用必须人工批准
Expiry	审批复核日期

Registry-only 模式也约束本地 Server。本地 Server ID 必须精确匹配 Registry 条目；仅仅把可执行文件放在开发机上，不应获得运行资格。对 Remote Server 还要核查 TLS、OAuth Audience、Redirect URI 与 Tenant 边界。

Permission Mode 怎么选

模式	风险	企业建议
每次审批	低，交互较多	高风险仓库默认
受限自动执行	中	仅只读工具、Sandbox 与明确目录
Bypass Approvals	高	企业禁用
Autopilot	高，连续自主操作	企业禁用或仅隔离实验环境

GitHub 更新明确说明，把 permissions.disableBypassPermissionsMode 设置为 disable 可阻止 JetBrains 中的 Copilot Agent 使用 Bypass Approvals 或 Autopilot。字段命名看似双重否定，部署前必须在测试设备确认实际效果。

权限批准应该绑定 Tool、参数摘要、Workspace、有效期和会话，而不是“一次允许后永久允许”。付款、删除、发布、发信、权限修改、生产数据库和部署必须保留人工审批。

OpenTelemetry 与审计

统一 OpenTelemetry 有利于观察 Agent Session、MCP 连接、Tool Call、延迟和错误，但不能采集完整 Prompt、Response、源码、Token 或 Secret。推荐字段包括 User/Seat、IDE、Plugin Version、Server ID、Tool Name、Decision、Duration、Error Class 和 Trace ID。

日志应能回答：谁在什么 IDE 使用哪个 MCP Server，调用哪个 Tool，是否批准，修改了哪些资源，最终结果是什么。审计保留与访问权限应按数据分类设置。

常见故障排查

已开启 MCP 但 JetBrains 仍无法连接

检查用户 Seat 来源、企业/组织 MCP Policy、Registry-only、Server ID 精确匹配、Allowlist/Denylist 冲突、Copilot Plugin 版本和 IDE 重启。

本地 MCP 绕过 Registry

确认企业已启用 Registry-only，而不是 Allow all；本地 Server 必须登记 Canonical ID。检查用户是否改用个人 Copilot Seat。

禁用 Bypass 后仍看到高权限选项

核对 Managed Settings 是否下发、键名和值是否正确、Plugin 是否支持该版本，并以实际 Tool Call 是否被阻止作为验证，不能只看 UI 文案。

Plugin Marketplace 限制生效但 MCP 仍可添加

这是不同控制面。Marketplace 策略约束插件来源，MCP Allowlist/Registry 约束 Server；必须同时设置。

风险与边界

企业 MCP Policy 只约束相应 Business/Enterprise Seat，个人 Seat 可能形成治理缺口。
Allowlist 证明“获准连接”，不证明 Server 永远安全；需要版本、制品和 Tool 复审。
本地 Server 可访问开发机文件与进程，风险不低于 Remote Server。
Denylist 适合应急，长期应采用默认拒绝 Allowlist。
Telemetry 可能泄露源码和 Prompt，必须脱敏。
Agent 仍可能受 Prompt Injection 影响，权限控制和人工审批不可省略。

更多基础配置可查看 AI Stack Nav 的 GitHub Copilot MCP 教程，企业治理可参考 MCP 权限与安全专题。

事实依据与来源

GitHub 官方已确认： JetBrains Managed Settings 覆盖 Plugin Governance、MCP Allowlist、OpenTelemetry 与 Permission Modes。
GitHub 官方已确认： allowedMcpServers、deniedMcpServers 可集中控制 MCP Server。
GitHub 官方已确认： permissions.disableBypassPermissionsMode=disable 可阻止 Bypass Approvals 与 Autopilot。
GitHub 官方已确认： MCP 企业策略默认关闭，Registry-only 同时约束本地和远程 Server。
实施建议： 四层架构、配置样例、审计字段和十步灰度方案需结合当前 Managed Settings Reference 验证。

FAQ

JetBrains Copilot 现在支持企业托管 MCP 吗？

支持。GitHub 于 2026 年 8 月宣布 JetBrains 企业托管设置，允许集中管理 MCP Server Allowlist、插件、Telemetry 和 Permission Mode。

`allowedMcpServers` 与 Registry-only 有什么区别？

Registry-only 在 GitHub 企业控制面限制 Server 必须来自私有 Registry；allowedMcpServers 是 JetBrains 托管设置中的客户端允许列表。两层叠加更稳妥。

本地 stdio MCP 也会被限制吗？

会。GitHub 文档说明 Private Registry Enforcement 同样适用于本地 Server，Server ID 必须与 Registry 记录精确匹配。

`deniedMcpServers` 应该代替 Allowlist 吗？

不应该。Denylist 无法覆盖未知 Server，适合应急封禁；企业基线应是默认拒绝的 Allowlist。

限制 Plugin Marketplace 是否就能限制 MCP？

不能。插件与 MCP 是不同入口，必须分别配置 Marketplace/Plugin Policy 和 MCP Registry/Allowlist。

为什么要禁用 Autopilot？

Autopilot 会减少逐步审批，扩大错误或 Prompt Injection 的影响。企业生产仓库应由管理员禁止，隔离实验环境另行评估。

个人 Copilot 账号受企业 MCP 策略约束吗？

GitHub 文档说明，Free、Pro、Pro+、Max 不受 Business/Enterprise MCP Policy 管控。企业应治理账号与 Seat 混用。

Telemetry 可以记录 Prompt 吗？

技术上某些链路可能采集丰富内容，但企业不应记录完整 Prompt、Response、源码或 Secret，只保留必要元数据和策略结果。

生产上线前最重要的测试是什么？

同时测试允许 Server 可用、未知 Server 被拒、本地 Server 被 Registry-only 拦截、Bypass/Autopilot 被禁止，以及日志不包含敏感内容。

参考来源

安装部署教程

环境配置与 Docker 工作流

适合阅读安装部署、本地配置、服务器搭建和自动化流程类文章后继续转化。

环境配置资料包 包含 Windows / Mac / Linux 常见环境配置、依赖安装和报错排查清单。 查看资料包 Docker 工作流包 整理 Docker 部署模板、compose 示例和常用服务编排流程。 查看资料包

AI Stack Nav

JetBrains-Copilot-企业管控-MCP白名单-插件策略与权限模式

核心结论

2026 年 JetBrains Copilot 企业设置更新了什么