Skip to main content
Organization

MCP Access Control

Applicable plans: Enterprise
MCP Access Control lets administrators manage how non-built-in MCP servers are connected and used across the organization. Administrators can allow all non-built-in MCP servers, restrict access with an allowlist, or block them all to prevent unapproved MCP servers from being enabled in Qoder clients. This control applies both to MCP servers configured or installed by members and to MCP servers deployed centrally by the organization. MCP services built into Qoder clients are not affected.

Use cases

  • Allow members to connect to and use only MCP servers approved by the organization.
  • Apply the same access rules to MCP servers added by members and those deployed centrally by the organization.
  • Block all non-built-in MCP servers across the organization when necessary.

Scope

Qoder clients enforce access control at MCP connection and usage entry points they can identify and block.
Entry pointTypical scenarios
ConfigurationReading or applying MCP configurations, including configurations distributed by the organization
Installation and activationAdding, installing, enabling, or loading an MCP server
Startup and connectionStarting a local process, or establishing or restoring a remote connection
UseDisplaying or registering MCP tools, or making an MCP call
After an MCP server passes an entry-point check, its internal behavior is outside the scope of this control. Examples include running scripts, accessing files, starting other processes, and making network requests. This control also does not block network requests unrelated to MCP.
Note: MCP Access Control governs access at entry points. It is not a runtime security sandbox for MCP servers.

Access modes

Administrators can select one of the following access modes:
Access modeBehavior
Allow allAllows all non-built-in MCP servers in the organization. Existing allowlist rules are retained but cannot be edited.
Rule-based accessAllows only non-built-in MCP servers that match an allowlist rule. Administrators can create, edit, and delete rules. MCP servers that do not match a rule are unavailable.
Block allBlocks access to and use of all non-built-in MCP servers. Existing allowlist rules are retained but cannot be edited.
New organizations use Allow all by default. After an access mode changes, clients usually take about five minutes to retrieve the latest setting. Centrally deployed MCP servers cannot bypass MCP Access Control. They must still follow the current access mode and, under Rule-based access, match an allowlist rule.

Configure allowlist rules

Allowlist rules can be edited only under Rule-based access. Rule-based access requires at least one allowlist rule, and you can configure up to 100 rules. Once Rule-based access is active, you cannot delete the last rule.
  1. In the organization admin console, go to Extensions & Marketplace > MCP Access Control.
  2. Change the access mode to Rule-based access.
  3. If there are no allowlist rules, follow the on-screen guidance to create the first rule.
  4. Enter a rule name, select a match target, enter an expression, and review the rule.
  5. Confirm the combined action to create the first rule and enable Rule-based access.
If allowlist rules already exist, you can confirm the switch immediately after selecting Rule-based access. After the mode changes, you can continue to create, edit, or delete rules in the rule list. If you cancel the initial setup or the submission fails, no rule is created and the current access mode remains unchanged. Allowlist rules support the following match targets:
Match targetExact-match exampleWildcard example
MCP endpoint URLhttps://mcp.example.com/v1https://*.example.com/*
Launch commandnpx -y @modelcontextprotocol/server-sqlitenpx -y @company/mcp-*
URL rules match only MCP endpoint URLs, and launch command rules match only local launch commands. A server is allowed if it matches any allowlist rule. If it matches none, the MCP server is unavailable. Wildcards are supported only in the following positions:
  • MCP endpoint URL: *. at the left edge of a domain, or * at the end of a path. For example, *.example.com matches its subdomains but not the bare domain example.com.
  • Launch command: * at the end of an argument. The executable must match exactly. * cannot be used by itself or span multiple arguments.
Wildcards in other positions, full glob patterns, and regular expressions are not supported. Broader wildcards allow more MCP servers. Before saving a rule, make sure its scope matches your intent.

Processing before matching

Clients identify and match configurations as follows:
  • MCP endpoint URL: Only absolute https URLs are supported. A URL containing user information, query parameters, or a fragment is treated as invalid rather than having those components removed before matching.
  • Launch command: The executable and arguments are matched one by one in order. The argument count and order must be identical. The client does not interpret shell syntax or quoting, search PATH, or expand environment variables.
If an MCP configuration contains neither a valid URL nor a valid launch command, the client treats it as invalid and blocks its use.

Unavailable states in clients

Clients retain the configuration or deployment entry for an unavailable MCP server and display a status that explains why it is unavailable. Actions such as connecting, enabling, and invoking the server are disabled.
StatusDescription
Disabled by organizationAn administrator has set the access mode to Block all.
Not approvedRule-based access is active, and this MCP server does not match an allowlist rule.
Invalid configurationThe client cannot identify a valid MCP endpoint URL or launch command.
Policy unavailableThe client is temporarily unable to retrieve the enterprise MCP policy.
If the client cannot retrieve the latest policy, it uses the most recent valid policy when available. If no valid cached policy is available, the client blocks non-built-in MCP servers by default. MCP services built into Qoder are not affected.

Client version requirements

Only clients that meet the minimum supported version enforce MCP access modes and allowlist rules.
ClientMinimum supported version
Qoder IDE1.15.0
Qoder JetBrains Plugin2026.724.1
Qoder CLI1.1.18
Clients below the minimum supported version do not support this feature and do not enforce the organization's access mode or allowlist rules.

FAQ

Are MCP servers deployed centrally by the organization allowed automatically?

No. MCP Access Control takes precedence over centrally managed deployment. Under Rule-based access, an MCP server deployed centrally by the organization must still match an allowlist rule. Under Block all, the MCP server cannot be loaded or invoked.

Does this feature block network requests made by an MCP server?

No. This feature enforces access control only at MCP connection and usage entry points that the client can identify. After an MCP server passes the check, its scripts, file access, process calls, and network requests are outside the scope of this control.

Why doesn't a setting change appear in the client immediately?

Clients cache enterprise policies. Changes to the access mode or allowlist rules usually take about five minutes to apply.