Restrict MCP server access to a custom registry

You can configure an MCP registry URL and access control policy to determine which MCP servers developers can discover and use in supported IDEs and Copilot pour CLI.

Qui peut utiliser cette fonctionnalité ?

Enterprise owners and organization owners

Copilot Entreprise or Copilot Business

Dans cet article

Important

This feature is in préversion publique 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.

Prerequisites

Before you can fully configure MCP server access for your company, you need to create an MCP registry. See Configurer un registre MCP pour votre organisation ou entreprise.

Configuring the MCP allowlist policy for an enterprise

To ensure uniform access, you can set and maintain your MCP registry URL and allowlist policy at the enterprise level. Otherwise, if your teams have different needs, you should configure separate policies for each organization.

  1. Accédez à votre entreprise. Par exemple, depuis la page Entreprises sur GitHub.com.

  2. En haut de la page, cliquez sur AI controls.

  3. Dans la barre latérale, cliquez sur MCP.

  4. Ensure MCP servers in Copilot is set to Enabled everywhere.

  5. In the MCP Registry URL section, enter the URL of your registry, then click Save.

    Remarque

    Si vous configurez votre registre MCP à l’aide de Azure Centre d’API, entrez l’URL de base de votre Centre d’API, y compris le chemin d’accès de l’espace de travail, au format suivant :

    https://SERVICE-NAME.data.REGION.azure-apicenter.ms/workspaces/WORKSPACE-NAME

    Par exemple:

    https://contoso-apic.data.eastus.azure-apicenter.ms/workspaces/default

    L’inclusion de suffixes de route supplémentaires comme /v0.1/servers provoquera une erreur du registre, car GitHub Copilot ajoute automatiquement le chemin MCP v0.1.

  6. In the Restrict MCP access to registry servers section, select the dropdown menu, then click one of the following options:

    • Allow all: No restrictions. All MCP servers can be used.
    • Registry only: Only servers from the registry may run.

    Your chosen policy will immediately apply to developers in your enterprise.

Configuring the MCP allowlist policy for an organization

  1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

  2. Sélectionnez une organisation en cliquant dessus.

  3. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran des onglets dans le profil d’une organisation. L’onglet « Paramètres » est présenté en orange foncé.

  4. Dans la barre latérale, sous « Code, planification et automatisation », click Copilot, then click Policies.

  5. In the "Features" section, ensure MCP servers in Copilot is set to Enabled.

  6. In the MCP Registry URL (optional) field, enter the URL of your registry, then click Save.

    Remarque

    Si vous configurez votre registre MCP à l’aide de Azure Centre d’API, entrez l’URL de base de votre Centre d’API, y compris le chemin d’accès de l’espace de travail, au format suivant :

    https://SERVICE-NAME.data.REGION.azure-apicenter.ms/workspaces/WORKSPACE-NAME

    Par exemple:

    https://contoso-apic.data.eastus.azure-apicenter.ms/workspaces/default

    L’inclusion de suffixes de route supplémentaires comme /v0.1/servers provoquera une erreur du registre, car GitHub Copilot ajoute automatiquement le chemin MCP v0.1.

  7. In the Restrict MCP access to registry servers section, select the dropdown menu, then click one of the following options:

    • Allow all: No restrictions. All MCP servers can be used.
    • Registry only: Only servers from the registry may run.

    Your chosen policy will immediately apply to developers in your organization.

Next steps

For detailed information on MCP allowlist enforcement and limitations, see MCP private registry enforcement.

Further reading