{"meta":{"title":"GitHub Enterprise용 GitHub MCP 서버 구성","intro":"GitHub Enterprise Server 또는 데이터 보존 기능을 갖춘 GitHub Enterprise Cloud 사용하도록 GITHUB MCP(모델 컨텍스트 프로토콜) 서버를 구성하는 방법에 대해 알아봅니다.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ko/copilot","title":"GitHub Copilot"},{"href":"/ko/copilot/how-tos","title":"방법"},{"href":"/ko/copilot/how-tos/provide-context","title":"컨텍스트 제공"},{"href":"/ko/copilot/how-tos/provide-context/use-mcp-in-your-ide","title":"IDE에서 MCP 사용"},{"href":"/ko/copilot/how-tos/provide-context/use-mcp-in-your-ide/enterprise-configuration","title":"엔터프라이즈 구성"}],"documentType":"article"},"body":"# GitHub Enterprise용 GitHub MCP 서버 구성\n\nGitHub Enterprise Server 또는 데이터 보존 기능을 갖춘 GitHub Enterprise Cloud 사용하도록 GITHUB MCP(모델 컨텍스트 프로토콜) 서버를 구성하는 방법에 대해 알아봅니다.\n\nMCP 서버는 GitHub 및 GitHub Enterprise Server와 함께 작동하도록 구성할 수 있습니다. 구성 단계는 원격 또는 로컬 MCP 서버를 사용하는지 여부에 따라 다릅니다.\n\n## 엔터프라이즈 MCP 서버 구성 정보\n\nMCP 서버는 GitHub 다음 두 가지 엔터프라이즈 배포 유형을 지원합니다.\n\n* **[데이터 보존 기능을 갖춘 GitHub Enterprise Cloud](#configuring-the-remote-mcp-server-for-github-enterprise-cloud-with-data-residency)**: 원격 및 로컬 MCP 서버 구성을 모두 지원합니다.\n* **[GitHub Enterprise Server](#configuring-the-local-mcp-server-for-enterprise)**: **로컬 MCP 서버 구성만** 지원합니다.\n\n> \\[!IMPORTANT]\n> GitHub Enterprise Server 는 원격 MCP 서버 호스팅을 지원하지 **않습니다** . 사용하는 GitHub Enterprise Server경우 엔터프라이즈용 로컬 MCP 서버 구성에 설명된 **로컬 MCP 서버 구성을** 사용해야 [합니다](#configuring-the-local-mcp-server-for-enterprise). 아래의 원격 MCP 서버 구성 섹션을 건너뜁니다.\n\n## 사전 요구 사항\n\n* GitHub Enterprise Server를 사용하는 GitHub Enterprise Cloud 인스턴스 또는 데이터의 저장 위치\n 계정\n* GitHub 편집기에서 구성된 MCP 서버입니다.\n [GitHub MCP 서버 설정](/ko/copilot/how-tos/provide-context/use-mcp-in-your-ide/set-up-the-github-mcp-server)을(를) 참조하세요.\n\n## 데이터 보존 기능을 갖춘 GitHub Enterprise Cloud에 대한 원격 MCP 서버 구성하기\n\n> \\[!NOTE]\n> 이 섹션은 **오직**데이터 보존 기능을 갖춘 GitHub Enterprise Cloud에 적용됩니다.\n> GitHub Enterprise Server를 사용 중인 경우, [엔터프라이즈용 로컬 MCP 서버 구성](#configuring-the-local-mcp-server-for-enterprise) 단계로 건너뜁니다.\n\n\n\n데이터 보존 기능을 갖춘 GitHub Enterprise Cloud 는 원격 MCP 서버를 사용할 수 있습니다. 구성하려면 MCP 서버 URL을 GitHub Enterprise Cloud 인스턴스를 가리키도록 업데이트해야 합니다.\n\n예를 들어, GitHub Enterprise Cloud 인스턴스가 `https://octocorp.ghe.com`인 경우, MCP 서버 URL은 `https://copilot-api.octocorp.ghe.com/mcp`입니다.\n\n1. Visual Studio Code Ctrl+Shift+P (Windows/Linux)를 눌러 명령 팔레트를 엽니다. / Command+Shift+P (Mac)를 눌러 명령 팔레트를 엽니다.\n\n2. **MCP를 입력하고 선택합니다. 사용자 구성을 엽니다**.\n\n3. 설정 파일에서 섹션을 찾습니다 `servers` . 이미 MCP 서버를 구성했다면 GitHub 항목이 표시됩니다.\n\n4. `url` 필드를 업데이트하여 GitHub Enterprise Cloud 인스턴스를 가리키도록 합니다.\n\n**옵션 A: PAT 인증 사용**\n\n```json copy\n{\n \"servers\": {\n \"github\": {\n \"type\": \"http\",\n \"url\": \"https://copilot-api.SUBDOMAIN.ghe.com/mcp\",\n \"headers\": {\n \"Authorization\": \"Bearer ${input:github_mcp_pat}\"\n }\n }\n },\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"github_mcp_pat\",\n \"description\": \"GitHub PAT\",\n \"password\": true\n }\n ]\n}\n```\n\n**옵션 B: OAuth 인증 사용**\n\n```json copy\n{\n \"servers\": {\n \"github\": {\n \"type\": \"http\",\n \"url\": \"https://copilot-api.SUBDOMAIN.ghe.com/mcp\"\n }\n }\n}\n```\n\n귀하의 `SUBDOMAIN.ghe.com` 하위 도메인으로 GHE.com을(를) 대체하십시오.\n\n1. 파일을 저장합니다.\n\n2. OAuth를 데이터 보존 기능을 갖춘 GitHub Enterprise Cloud과 함께 사용하는 경우, VS Code 인스턴스를 가리키도록 GitHub Enterprise Cloud 설정을 구성합니다. 사용자 설정에 다음을 추가합니다[VS Code](https://code.visualstudio.com/docs/configure/settings#_user-settings).\n\n ```json\n {\n \"github-enterprise.uri\": \"https://copilot-api.SUBDOMAIN.ghe.com/mcp\"\n }\n ```\n\n3. 변경 내용을 적용하려면 창을 다시 시작 Visual Studio Code 하거나 다시 로드합니다.\n\n
\n\n\n\nGitHub Enterprise Cloud 데이터 상주가 있는 경우 원격 MCP 서버를 사용할 수 있습니다. 구성하려면 MCP 서버 URL을 GitHub Enterprise Cloud 인스턴스를 가리키도록 업데이트해야 합니다.\n\n예를 들어, GitHub Enterprise Cloud 인스턴스가 `https://octocorp.ghe.com`인 경우, MCP 서버 URL은 `https://copilot-api.octocorp.ghe.com/mcp`입니다.\n\n1. 메뉴 모음에서 Visual Studio**보기를** 클릭한 다음 을 클릭합니다 **GitHub Copilot Chat**.\n2. 채팅 패널 아래쪽의 모드 드롭다운에서 **Agent**를 선택합니다.\n3. 창에서 Copilot Chat 도구 아이콘을 클릭한 다음 도구 선택 창에서 더하기 아이콘을 클릭합니다.\n4. \"Configure MCP server\" 팝업창에서 필드를 채웁니다.\n 1. \"서버 ID\"에 `github` 입력합니다.\n 2. \"유형\"의 경우, 드롭다운에서 \"HTTP/SSE\"를 선택합니다.\n 3. \"URL\"의 경우, `https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp`을(를) `YOURSUBDOMAIN` 하위 도메인으로 바꿔서 GitHub Enterprise Cloud을(를) 입력합니다.\n 4. \"Headers\" 아래에 \"Authorization\"이라는 새 헤더를 추가하고 값을 `Bearer YOUR_GITHUB_PAT`으로 설정하며, \"YOUR\\_GITHUB\\_PAT\"를 사용자의 personal access token으로 바꾸세요.\n5. **저장**을 클릭합니다.\n\n
\n\n\n\n\n\nGitHub Enterprise Cloud 데이터 상주가 있는 경우 원격 MCP 서버를 사용할 수 있습니다. 구성하려면 MCP 서버 URL을 GitHub Enterprise Cloud 인스턴스를 가리키도록 업데이트해야 합니다.\n\n예를 들어, GitHub Enterprise Cloud 인스턴스가 `https://octocorp.ghe.com`인 경우, MCP 서버 URL은 `https://copilot-api.octocorp.ghe.com/mcp`입니다.\n\n1. Xcode용 GitHub Copilot 확장을 열고 \"Settings\"로 이동합니다.\n * 또는, 활성 Xcode 작업 영역의 메뉴 모음에서 **Editor**를 클릭하고 **GitHub Copilot** 을 선택한 다음, **Open GitHub Copilot for Xcode Settings**를 클릭하여 설정을 찾을 수 있습니다.\n2. **MCP** 탭을 선택한 다음, **Edit Config**를 클릭합니다.\n3. `YOURSUBDOMAIN`을 GitHub Enterprise Cloud 하위 도메인으로, `YOUR_GITHUB_PAT`을 personal access token으로 바꿔 아래 구성을 추가하십시오.\n\n ```json copy\n {\n \"servers\": {\n \"github\": {\n \"url\": \"https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp\",\n \"requestInit\": {\n \"headers\": {\n \"Authorization\": \"Bearer YOUR_GITHUB_PAT\"\n }\n }\n }\n }\n }\n ```\n\n
\n\n\n\n## 엔터프라이즈용 로컬 MCP 서버 구성\n\nGitHub Enterprise Server와 GitHub Enterprise Cloud 모두 데이터 상주 기능을 갖춘 로컬 MCP 서버를 지원합니다. 환경 변수 또는 `GITHUB_HOST` 명령줄 플래그를 `--gh-host` 사용하여 로컬 서버를 구성할 수 있습니다.\n\n### 중요 고려 사항\n\n* **에 대한 경우GitHub Enterprise Server**: 호스트 이름 앞에 `https://` URI 스킘을 지정하십시오. 그렇지 않으면 기본적으로 `http://`으로 설정되며 이는 GitHub Enterprise Server에서 지원되지 않습니다.\n* **데이터 보존의 경우GitHub Enterprise Cloud**: 호스트 이름으로 사용합니다`https://YOURSUBDOMAIN.ghe.com`.\n\n### Docker를 사용하여 구성\n\n\n\nDocker Visual Studio Code를 사용하여 로컬 MCP 서버를 구성하려면:\n\n1. Visual Studio Code Ctrl+Shift+P (Windows/Linux)를 눌러 명령 팔레트를 엽니다. / Command+Shift+P (Mac)를 눌러 명령 팔레트를 엽니다.\n\n2. **MCP를 입력하고 선택합니다. 사용자 구성을 엽니다**.\n\n3. 설정 파일에서 해당 섹션 `servers`을 찾거나 존재하지 않는 경우에는 만듭니다.\n\n4. 다음 구성을 추가합니다.\n\n**의 경우 GitHub Enterprise Server:**\n\n```json copy\n{\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"github_token\",\n \"description\": \"GitHub PAT\",\n \"password\": true\n }\n ],\n \"servers\": {\n \"github\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"-e\",\n \"GITHUB_PERSONAL_ACCESS_TOKEN\",\n \"-e\",\n \"GITHUB_HOST\",\n \"ghcr.io/github/github-mcp-server\"\n ],\n \"env\": {\n \"GITHUB_PERSONAL_ACCESS_TOKEN\": \"${input:github_token}\",\n \"GITHUB_HOST\": \"https://YOUR_GHES_HOSTNAME\"\n }\n }\n }\n}\n```\n\n`YOUR_GHES_HOSTNAME`을(를) GitHub Enterprise Server 호스트 이름(예: `https://github.example.com`)으로 바꾸십시오.\n\n**데이터 저장 위치의 경우 GitHub Enterprise Cloud:**\n\n```json copy\n{\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"github_token\",\n \"description\": \"GitHub PAT\",\n \"password\": true\n }\n ],\n \"servers\": {\n \"github\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"-e\",\n \"GITHUB_PERSONAL_ACCESS_TOKEN\",\n \"-e\",\n \"GITHUB_HOST\",\n \"ghcr.io/github/github-mcp-server\"\n ],\n \"env\": {\n \"GITHUB_PERSONAL_ACCESS_TOKEN\": \"${input:github_token}\",\n \"GITHUB_HOST\": \"https://YOURSUBDOMAIN.ghe.com\"\n }\n }\n }\n}\n```\n\n귀하의 `YOURSUBDOMAIN` 하위 도메인으로 GitHub Enterprise Cloud을(를) 대체하십시오.\n\n1. 파일을 저장합니다.\n2. 변경 내용을 적용하려면 창을 다시 시작 Visual Studio Code 하거나 다시 로드합니다.\n\n
\n\n\n\nDocker를 사용하여 Visual Studio에서 로컬 MCP 서버를 구성하려면 `mcp.json` 파일을 수동으로 편집해야 합니다.\n\n1. `mcp.json` 파일을 Visual Studio에서 엽니다. 파일은 일반적으로 사용자 프로필 디렉터리에 있습니다.\n\n2. 다음 구성을 추가합니다.\n\n**의 경우 GitHub Enterprise Server:**\n\n```json copy\n{\n \"mcp\": {\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"github_token\",\n \"description\": \"GitHub PAT\",\n \"password\": true\n }\n ],\n \"servers\": {\n \"github\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"-e\",\n \"GITHUB_PERSONAL_ACCESS_TOKEN\",\n \"-e\",\n \"GITHUB_HOST\",\n \"ghcr.io/github/github-mcp-server\"\n ],\n \"env\": {\n \"GITHUB_PERSONAL_ACCESS_TOKEN\": \"${input:github_token}\",\n \"GITHUB_HOST\": \"https://YOUR_GHES_HOSTNAME\"\n }\n }\n }\n }\n}\n```\n\n`YOUR_GHES_HOSTNAME`을(를) GitHub Enterprise Server 호스트 이름(예: `https://github.example.com`)으로 바꾸십시오.\n\n**데이터 저장 위치의 경우 GitHub Enterprise Cloud:**\n\n```json copy\n{\n \"mcp\": {\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"github_token\",\n \"description\": \"GitHub PAT\",\n \"password\": true\n }\n ],\n \"servers\": {\n \"github\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"-e\",\n \"GITHUB_PERSONAL_ACCESS_TOKEN\",\n \"-e\",\n \"GITHUB_HOST\",\n \"ghcr.io/github/github-mcp-server\"\n ],\n \"env\": {\n \"GITHUB_PERSONAL_ACCESS_TOKEN\": \"${input:github_token}\",\n \"GITHUB_HOST\": \"https://YOURSUBDOMAIN.ghe.com\"\n }\n }\n }\n }\n}\n```\n\n귀하의 `YOURSUBDOMAIN` 하위 도메인으로 GitHub Enterprise Cloud을(를) 대체하십시오.\n\n1. 파일을 저장합니다.\n\n
\n\n\n\n\n\nXcode에서 Docker를 사용하여 로컬 MCP 서버를 구성하려면 다음을 수행합니다.\n\n1. Xcode용 GitHub Copilot 확장을 열고 \"Settings\"로 이동합니다.\n * 또는, 활성 Xcode 작업 영역의 메뉴 모음에서 **Editor**를 클릭하고 **GitHub Copilot** 을 선택한 다음, **Open GitHub Copilot for Xcode Settings**를 클릭하여 설정을 찾을 수 있습니다.\n\n2. **MCP** 탭을 선택한 다음, **Edit Config**를 클릭합니다.\n\n3. 다음 구성을 추가합니다.\n\n**의 경우 GitHub Enterprise Server:**\n\n```json copy\n{\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"github_token\",\n \"description\": \"GitHub PAT\",\n \"password\": true\n }\n ],\n \"servers\": {\n \"github\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"-e\",\n \"GITHUB_PERSONAL_ACCESS_TOKEN\",\n \"-e\",\n \"GITHUB_HOST\",\n \"ghcr.io/github/github-mcp-server\"\n ],\n \"env\": {\n \"GITHUB_PERSONAL_ACCESS_TOKEN\": \"${input:github_token}\",\n \"GITHUB_HOST\": \"https://YOUR_GHES_HOSTNAME\"\n }\n }\n }\n}\n```\n\n`YOUR_GHES_HOSTNAME`을(를) GitHub Enterprise Server 호스트 이름(예: `https://github.example.com`)으로 바꾸십시오.\n\n**데이터 저장 위치의 경우 GitHub Enterprise Cloud:**\n\n```json copy\n{\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"github_token\",\n \"description\": \"GitHub PAT\",\n \"password\": true\n }\n ],\n \"servers\": {\n \"github\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"-e\",\n \"GITHUB_PERSONAL_ACCESS_TOKEN\",\n \"-e\",\n \"GITHUB_HOST\",\n \"ghcr.io/github/github-mcp-server\"\n ],\n \"env\": {\n \"GITHUB_PERSONAL_ACCESS_TOKEN\": \"${input:github_token}\",\n \"GITHUB_HOST\": \"https://YOURSUBDOMAIN.ghe.com\"\n }\n }\n }\n}\n```\n\n귀하의 `YOURSUBDOMAIN` 하위 도메인으로 GitHub Enterprise Cloud을(를) 대체하십시오.\n\n
\n\n\n\n### 원본에서 빌드할 때 구성\n\nDocker를 사용하는 대신 원본에서 MCP 서버를 빌드하는 경우 환경 변수를 `GITHUB_HOST` 설정하거나 명령줄 플래그를 `--gh-host` 사용할 수 있습니다.\n\n**환경 변수 사용:**\n\n```bash\nexport GITHUB_HOST=\"https://YOUR_GHES_OR_GHEC_HOSTNAME\"\n./github-mcp-server stdio\n```\n\n**명령줄 플래그 사용:**\n\n```bash\n./github-mcp-server --gh-host \\\n \"https://YOUR_GHES_OR_GHEC_HOSTNAME\" stdio\n```\n\n`YOUR_GHES_OR_GHEC_HOSTNAME`를 GitHub Enterprise Server 호스트 이름(예: `https://github.example.com`) 또는 GitHub Enterprise Cloud 호스트 이름(예: `https://octocorp.ghe.com`)으로 바꾸세요.\n\n## 다음 단계\n\n* MCP 서버를 사용하는 GitHub 방법을 알아보려면 [IDE에서 GitHub MCP 서버 사용](/ko/copilot/how-tos/provide-context/use-mcp-in-your-ide/use-the-github-mcp-server)을 참조하세요.\n* MCP 서버에 대한 도구 집합을 GitHub 구성하는 방법을 알아보려면 [GitHub MCP 서버에 대한 도구 집합 구성](/ko/copilot/how-tos/provide-context/use-mcp-in-your-ide/configure-toolsets)을 참조하세요."}