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 CLI de Copilot.

¿Quién puede utilizar esta característica?

Enterprise owners and organization owners

Copilot Enterprise or Copilot Business

En este artículo

Importante

This feature is in versión preliminar pública 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 Configuración de un registro MCP para su organización o empresa.

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. Vaya a su empresa. Por ejemplo, desde la página Empresas en GitHub.com.

  2. En la parte superior de la página, haga clic en controles de IA.

  3. En la barra lateral, haga clic en 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.

    Nota:

    Si configura el registro de MCP mediante Azure API Center, escriba la dirección URL base del Centro de API, incluida la ruta de acceso del área de trabajo, en el formato :

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

    Por ejemplo:

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

    La inclusión de sufijos de ruta adicionales como /v0.1/servers hará que se produzca un error en el registro, ya que GitHub Copilot anexa automáticamente la ruta de acceso de 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. En la esquina superior derecha de GitHub, haz clic en la foto del perfil y luego en Your organizations.

  2. Seleccione una organización haciendo clic en ella.

  3. Debajo del nombre de la organización, haz clic en Settings. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

    Captura de pantalla de las pestañas en el perfil de una organización. La pestaña "Configuración" se destaca en naranja oscuro.

  4. En la barra lateral, en "Código, planeamiento y automatización", 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.

    Nota:

    Si configura el registro de MCP mediante Azure API Center, escriba la dirección URL base del Centro de API, incluida la ruta de acceso del área de trabajo, en el formato :

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

    Por ejemplo:

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

    La inclusión de sufijos de ruta adicionales como /v0.1/servers hará que se produzca un error en el registro, ya que GitHub Copilot anexa automáticamente la ruta de acceso de 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