# 조직 또는 엔터프라이즈에 대한 MCP 레지스트리 구성

개발자가 access 수 있는 MCP 서버 목록을 만들고 호스트합니다.

> \[!IMPORTANT] 이 기능은 공개 미리 보기 MCP 서버에 대한 액세스를 제한하는 데 권장되지 않으며 권장되지 않습니다. 보다 안전하고 일반적으로 사용할 수 있는 방법은 엔터프라이즈 `managed-settings.json` 파일에서 설정을 정의하는 것입니다.
> [엔터프라이즈에 대한 MCP 서버 허용 목록 구성](/ko/copilot/how-tos/administer-copilot/manage-mcp-usage/configure-enterprise-allowlist)을(를) 참조하세요.

## 필수 조건

MCP(모델 컨텍스트 프로토콜) 레지스트리를 만들기 전에 회사의 MCP 관리 기능과 이점을 이해해야 합니다.
[회사의 MCP 서버 사용량](/ko/copilot/concepts/mcp-management)을(를) 참조하세요.

## 옵션 1: MCP 레지스트리 자체 호스팅

MCP 레지스트리의 핵심은 포함된 MCP 서버에 대한 세부 정보를 제공하는 HTTPS 엔드포인트 집합입니다. 다음 옵션 중 원하는 옵션을 사용하여 레지스트리를 만들 수 있습니다.

* 오픈 소스 MCP 레지스트리를 포크하고 자체 호스팅합니다. 시작하려면 [](https://github.com/modelcontextprotocol/registry/tree/main?tab=readme-ov-file#quick-start)에서 `modelcontextprotocol/registry`을 참조하세요.
* Docker를 사용하여 로컬로 오픈 소스 레지스트리를 실행합니다.
* 사용자 고유의 사용자 지정 구현을 게시합니다.

> \[!NOTE]
> 개발자가 로컬 MCP 서버에 access 하려면 해당 서버를 레지스트리에 올바른 서버 ID로 포함합니다. 자세한 내용은 [MCP 프라이빗 레지스트리 적용](/ko/copilot/reference/enterprise-administrators/mcp-private-registry-enforcement)을(를) 참조하세요.

연결할 수 있는 유효한 MCP 레지스트리 GitHub Copilot를 만들려면 레지스트리가 다음 요구 사항을 충족해야 합니다.

* [엔드포인트 및 사양 요구 사항](#endpoint-and-specification-requirements)
* [원본 간 리소스 공유 요구 사항](#cross-origin-resource-sharing-requirements)

### 엔드포인트 및 사양 요구 사항

유효한 레지스트리는 URL 라우팅을 지원하고 다음 엔드포인트를 포함하여 v0.1 MCP 레지스트리 사양을 따라야 합니다.

* `GET /v0.1/servers`: 포함된 모든 MCP 서버 목록을 반환합니다.
* `GET /v0.1/servers/{serverName}/versions/latest`: 특정 서버의 최신 버전을 반환합니다.
* `GET /v0.1/servers/{serverName}/versions/{version}`: 서버의 특정 버전에 대한 세부 정보를 반환합니다.

요청에 대한 자세한 내용 및 예제 JSON 응답은 [공식 MCP 레지스트리 설명서를 참조하세요](https://registry.modelcontextprotocol.io/docs).

#### v0.1 사양 지원

MCP 레지스트리가 v0 사양을 사용하여 시작하는 동안 해당 버전은 이제 불안정한 것으로 간주되며 구현해서는 안 됩니다. 대신 다음 화면에서 지원되는 v0.1 사양에 따라 레지스트리를 만듭니다.

| 표면            | v0.1 지원                                                                                                                                                                                                                                                                                                                  |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| VS Code 인사이더  | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-check" aria-label="Supported" role="img"><path d="M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z"></path></svg> |
| VS Code       | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-check" aria-label="Supported" role="img"><path d="M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z"></path></svg> |
| Visual Studio | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-check" aria-label="Supported" role="img"><path d="M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z"></path></svg> |
| 이클립스          | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-check" aria-label="Supported" role="img"><path d="M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z"></path></svg> |
| JetBrains IDE | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-check" aria-label="Supported" role="img"><path d="M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z"></path></svg> |
| 엑스코드          | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-check" aria-label="Supported" role="img"><path d="M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z"></path></svg> |
| Copilot CLI   | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-check" aria-label="Supported" role="img"><path d="M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z"></path></svg> |

### 원본 간 리소스 공유 요구 사항

Copilot 레지스트리를 가져올 때 원본 간 요청을 성공적으로 수행하려면 레지스트리 또는 역방향 프록시에 CORS(원본 간 리소스 공유) 헤더가 포함되어야 합니다. 모든 `/v0.1/servers` 엔드포인트에 다음 헤더를 추가합니다.

```http copy
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, OPTIONS
Access-Control-Allow-Headers: Authorization, Content-Type
```

## 옵션 2: Azure API 센터를 MCP 레지스트리로 사용

Azure API 센터는 자동 CORS 구성, 기본 제공 거버넌스 기능 및 추가 웹 서버 설정이 없는 완전 관리형 MCP 레지스트리를 제공합니다.

1. 레지스트리에 대한 초기 설정을 완료하려면 Azure 설명서에서 [API 인벤토리에서 원격 MCP 서버 등록 및 검색](https://learn.microsoft.com/azure/api-center/register-discover-mcp-server)을 참조하세요.
2. 개발자가 로컬 MCP 서버에 access 하려면 해당 서버를 레지스트리에 올바른 서버 ID로 포함합니다. 자세한 내용은 [MCP 프라이빗 레지스트리 적용](/ko/copilot/reference/enterprise-administrators/mcp-private-registry-enforcement)을(를) 참조하세요.
3. 레지스트리를 가져올 수 있도록 GitHub Copilot API 센터의 표시 유형 설정에서 익명 액세스를 허용합니다.
4. API 센터 엔드포인트 URL을 복사합니다. 다음 문서에서는 이 URL을 사용하여 회사 전체에서 레지스트리를 사용할 수 있도록 합니다.

### 가격 책정 및 제한

Azure API Center는 MCP 레지스트리 관리를 포함하여 기본 API 카탈로그 및 검색을 위한 **프레 계층**을 제공합니다. 무료 계층에 포함된 제한보다 높은 제한이 필요한 경우 표준 플랜으로 업그레이드할 수 있습니다. 자세한 제한 및 가격은 Azure 설명서의 [Azure API 센터 제한](https://learn.microsoft.com/azure/azure-resource-manager/management/azure-subscription-service-limits#azure-api-center-limits)을 참조하세요.

## 다음 단계

MCP 레지스트리를 만들었으므로 이제 회사에 대한 MCP 정책을 설정할 수 있습니다.
[사용자 지정 레지스트리에 대한 MCP 서버 액세스 제한](/ko/copilot/how-tos/administer-copilot/manage-mcp-usage/restrict-based-on-registry)을(를) 참조하세요.