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.

누가 이 기능을 사용할 수 있나요?

Enterprise owners and organization owners

Copilot Enterprise or 코파일럿 사업

이 기사에서

중요

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.

Prerequisites

Before you can fully configure MCP server access for your company, you need to create an MCP registry. See 조직 또는 엔터프라이즈에 대한 MCP 레지스트리 구성.

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. 귀하의 기업으로 이동하세요. 예를 들어 GitHub.com의 Enterprises 페이지에서.

  2. 페이지 맨 위에서 AI 컨트롤을 클릭합니다.

  3. 사이드바에서 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.

    참고

    Azure API 센터를 사용하여 MCP 레지스트리를 설정하는 경우 작업 영역 경로를 포함하여 API 센터의 기본 URL을 형식으로 입력합니다.

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

    다음은 그 예입니다.

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

    다음과 같은 /v0.1/servers 추가 경로 접미사를 포함하면 MCP v0.1 경로가 자동으로 추가되므로 레지스트리 오류가 발생 GitHub Copilot 합니다.

  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. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your organizations를 클릭합니다.

  2. 조직을 클릭하여 선택합니다.

  3. 조직 이름에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

    조직 프로필에 있는 여러 탭의 스크린샷. "설정" 탭이 진한 주황색으로 표시됩니다.

  4. 사이드바의 "코드, 계획 및 자동화"에서 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.

    참고

    Azure API 센터를 사용하여 MCP 레지스트리를 설정하는 경우 작업 영역 경로를 포함하여 API 센터의 기본 URL을 형식으로 입력합니다.

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

    다음은 그 예입니다.

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

    다음과 같은 /v0.1/servers 추가 경로 접미사를 포함하면 MCP v0.1 경로가 자동으로 추가되므로 레지스트리 오류가 발생 GitHub Copilot 합니다.

  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