Skip to main content

MCP private registry enforcement

Understand the logic and limitations of MCP private registry enforcement using a private registry server.

重要

This feature is in パブリック プレビュー and is not the recommended method for restricting access to MCP servers. The more secure, generally available method is to define settings in your enterprise's managed-settings.json file. See Configuring an MCP server allowlist for your enterprise.

Supported surfaces

The following table lists where MCP private registry features are supported.

SurfaceRegistry displayAllowlist enforcement
Copilot CLI (コパイロット CLI) v1.0.11+
Copilot クラウドエージェント
Eclipse v4.38+
JetBrains v1.5.64+
Visual Studio v18.4.0+
VS Code v1.109.3+
Xcode v0.47.0+

メモ

For Eclipse, JetBrains, and Xcode, MCP management features are supported in the pre-release versions of Copilot.

Current enforcement limitations

MCP private registry enforcement currently has the following limitations:

  • Enforcement is based only on server name/ID matching, which can be bypassed by editing configuration files.
  • Strict enforcement that prevents installation of non-registry servers is not yet available. For stricter URL-based enforcement that users cannot override locally, see Configuring an MCP server allowlist for your enterprise.

Enforcement for local servers

MCP private registry enforcement applies to both remote and local MCP servers. When "Registry only" is configured, local servers must be included in your registry with the correct server ID, which must exactly match the installed server ID. A server's canonical ID is often defined in its documentation or manifest.

Policy resolution for users with multiple seats

MCP private registry enforcement is always tied to the organization or enterprise that assigns the GitHub Copilot seat. If a user has multiple seats, GitHub automatically resolves conflicts and applies a single active policy and registry.

The resolution logic is:

  1. Scope: Policies set by a parent enterprise override those set by an organization. Enterprise policies trickle down to all organizations and members within that enterprise.
  2. Enforcement strictness: Since Registry only is more restrictive than Allow all, it will always take precedence.
  3. Recency of registry upload: If two policies have the same scope and strictness, the most recently uploaded registry will be applied.