{"meta":{"title":"MCP 프라이빗 레지스트리 적용","intro":"프라이빗 레지스트리 서버를 사용하는 MCP 프라이빗 레지스트리 적용의 논리 및 제한 사항을 이해합니다.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ko/copilot","title":"GitHub Copilot"},{"href":"/ko/copilot/reference","title":"참조"},{"href":"/ko/copilot/reference/enterprise-administrators","title":"엔터프라이즈 관리자"},{"href":"/ko/copilot/reference/enterprise-administrators/mcp-private-registry-enforcement","title":"MCP 프라이빗 레지스트리 적용"}],"documentType":"article"},"body":"# MCP 프라이빗 레지스트리 적용\n\n프라이빗 레지스트리 서버를 사용하는 MCP 프라이빗 레지스트리 적용의 논리 및 제한 사항을 이해합니다.\n\n> \\[!IMPORTANT] 이 기능은 공개 미리 보기 MCP 서버에 대한 액세스를 제한하는 데 권장되지 않으며 권장되지 않습니다. 보다 안전하고 일반적으로 사용할 수 있는 방법은 엔터프라이즈 `managed-settings.json` 파일에서 설정을 정의하는 것입니다.\n> [엔터프라이즈에 대한 MCP 서버 허용 목록 구성](/ko/copilot/how-tos/administer-copilot/manage-mcp-usage/configure-enterprise-allowlist)을(를) 참조하세요.\n\n## 지원되는 표면\n\n다음 표에서는 MCP 프라이빗 레지스트리 기능이 지원되는 위치를 나열합니다.\n\n| 표면                                                                                                                                                                                                                                                                                                                                   |                                                                                                                                                                                                               레지스트리 표시                                                                                                                                                                                                              |                                                                                                                                                                                                               허용 목록 적용                                                                                                                                                                                                              |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |\n| 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>                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                     |\n| <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> v1.0.11 이상  |                                                                                                                                                                                                                                                                                                                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                     |\n| Copilot cloud agent                                                                                                                                                                                                                                                                                                                  | <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-x\" aria-label=\"Not supported\" role=\"img\"><path d=\"M3.72 3.72a.75.75 0 0 1 1.06 0L8 6.94l3.22-3.22a.749.749 0 0 1 1.275.326.749.749 0 0 1-.215.734L9.06 8l3.22 3.22a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215L8 9.06l-3.22 3.22a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042L6.94 8 3.72 4.78a.75.75 0 0 1 0-1.06Z\"></path></svg> | <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-x\" aria-label=\"Not supported\" role=\"img\"><path d=\"M3.72 3.72a.75.75 0 0 1 1.06 0L8 6.94l3.22-3.22a.749.749 0 0 1 1.275.326.749.749 0 0 1-.215.734L9.06 8l3.22 3.22a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215L8 9.06l-3.22 3.22a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042L6.94 8 3.72 4.78a.75.75 0 0 1 0-1.06Z\"></path></svg> |\n| Eclipse                                                                                                                                                                                                                                                                                                                              |                                                       <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>                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                     |\n| <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> v4.38+      |                                                                                                                                                                                                                                                                                                                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                     |\n| JetBrains                                                                                                                                                                                                                                                                                                                            |                                                       <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>                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                     |\n| <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> v1.5.64 이상  |                                                                                                                                                                                                                                                                                                                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                     |\n| 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>                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                     |\n| <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> v18.4.0 이상  |                                                                                                                                                                                                                                                                                                                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                     |\n| 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>                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                     |\n| <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> v1.109.3 이상 |                                                                                                                                                                                                                                                                                                                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                     |\n| Xcode                                                                                                                                                                                                                                                                                                                                |                                                       <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>                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                     |\n| <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> v0.47.0 이상  |                                                                                                                                                                                                                                                                                                                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                     |\n\n> \\[!NOTE]\n> Eclipse, JetBrains 및 Xcode의 Copilot경우 MCP 관리 기능은 시험판 버전에서 지원됩니다.\n\n## 현재 적용 제한 사항\n\nMCP 프라이빗 레지스트리 적용에는 현재 다음과 같은 제한 사항이 있습니다.\n\n* 적용은 구성 파일을 편집하여 무시할 수 있는 서버 이름/ID 일치만을 기반으로 합니다.\n* 레지스트리가 아닌 서버의 설치를 방지하는 엄격한 적용은 아직 사용할 수 없습니다. 사용자가 로컬에서 재정의할 수 없는 더 엄격한 URL 기반 적용은 [엔터프라이즈에 대한 MCP 서버 허용 목록 구성](/ko/copilot/how-tos/administer-copilot/manage-mcp-usage/configure-enterprise-allowlist)을 참조하세요.\n\n## 로컬 서버에 대한 적용\n\nMCP 프라이빗 레지스트리 적용은 원격 및 로컬 MCP 서버 모두에 적용됩니다. \"레지스트리만\"을 구성한 경우 로컬 서버는 올바른 서버 ID를 사용하여 레지스트리에 포함되어야 합니다. 이 ID는 설치된 서버 ID와 정확히 일치해야 합니다. 서버의 정식 ID는 종종 설명서 또는 매니페스트에 정의됩니다.\n\n## 여러 라이선스를 보유한 사용자의 정책 해결\n\nMCP 프라이빗 레지스트리 적용은 항상 좌석을 할당하는 조직 또는 기업에 연결됩니다 GitHub Copilot . 사용자에게 여러 개의 사용자가 GitHub 있는 경우 충돌을 자동으로 해결하고 단일 활성 정책 및 레지스트리를 적용합니다.\n\n해결 논리는 다음과 같습니다.\n\n1. **Scope**: 상위 엔터프라이즈에서 설정한 정책은 조직 내 개별 정책보다 우선하여 적용됩니다. 엔터프라이즈 정책은 해당 엔터프라이즈 내의 모든 조직과 구성원에게 적용됩니다.\n2. **적용 엄격성**: `Registry only` 보다 `Allow all`제한적이므로 항상 우선합니다.\n3. **레지스트리 업로드 변경**: 두 정책이 동일한 범위와 엄격성을 갖는 경우 가장 최근에 업로드된 레지스트리가 적용됩니다."}