Skip to main content

GitHub Enterprise용 GitHub MCP 서버 구성

          GitHub Enterprise Server 또는 데이터 보존 기능을 갖춘 GitHub Enterprise Cloud 사용하도록 GITHUB MCP(모델 컨텍스트 프로토콜) 서버를 구성하는 방법에 대해 알아봅니다.

MCP 서버는 GitHub 및 데이터 보존 기능을 갖춘 GitHub Enterprise Cloud와 함께 작동하도록 구성할 수 있습니다. 구성 단계는 원격 또는 로컬 MCP 서버를 사용하는지 여부에 따라 다릅니다.

엔터프라이즈 MCP 서버 구성 정보

MCP 서버는 GitHub 다음 두 가지 엔터프라이즈 배포 유형을 지원합니다.


          [
          데이터 보존 기능을 갖춘 GitHub Enterprise Cloud
          ](#configuring-the-remote-mcp-server-for-github-enterprise-cloud-with-data-residency)
          **: 원격 및 로컬 MCP 서버 구성을 모두 지원합니다.

          [
          GitHub Enterprise Server
          ](#configuring-the-local-mcp-server-for-enterprise)
          **: **로컬 MCP 서버 구성만** 지원합니다.

중요

          GitHub Enterprise Server 는 원격 MCP 서버 호스팅을 지원하지 **않습니다** . 사용하는 GitHub Enterprise Server경우 엔터프라이즈용 로컬 MCP 서버 구성에 설명된 **로컬 MCP 서버 구성을** 사용해야 [합니다](#configuring-the-local-mcp-server-for-enterprise). 아래의 원격 MCP 서버 구성 섹션을 건너뜁니다.

사전 요구 사항

  • 데이터의 저장 위치를 사용하는 GitHub Enterprise Server 인스턴스 또는 GitHub Enterprise Cloud 계정
  • GitHub 편집기에서 구성된 MCP 서버입니다. GitHub MCP 서버 설정을(를) 참조하세요.

          데이터 보존 기능을 갖춘 GitHub Enterprise Cloud에 대한 원격 MCP 서버 구성하기

참고

이 섹션은 오직데이터 보존 기능을 갖춘 GitHub Enterprise Cloud에 적용됩니다. GitHub Enterprise Server를 사용 중인 경우, 엔터프라이즈용 로컬 MCP 서버 구성 단계로 건너뜁니다.

          데이터 보존 기능을 갖춘 GitHub Enterprise Cloud 는 원격 MCP 서버를 사용할 수 있습니다. 구성하려면 MCP 서버 URL을 GitHub Enterprise Cloud 인스턴스를 가리키도록 업데이트해야 합니다.

예를 들어, GitHub Enterprise Cloud 인스턴스가 https://octocorp.ghe.com인 경우, MCP 서버 URL은 https://copilot-api.octocorp.ghe.com/mcp입니다.

  1.        Visual Studio Code
           <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (Windows/Linux)를 눌러 명령 팔레트를 엽니다. / <kbd>Command</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (Mac)를 눌러 명령 팔레트를 엽니다.
    
  2.        **MCP를 입력하고 선택합니다. 사용자 구성을 엽니다**.
    
  3. 설정 파일에서 섹션을 찾습니다 servers . 이미 MCP 서버를 구성했다면 github 항목이 표시됩니다.

  4.        `url` 필드를 업데이트하여 GitHub Enterprise Cloud 인스턴스를 가리키도록 합니다.
    
    
           **옵션 A: PAT 인증 사용**
    
    JSON
    {
      "servers": {
        "github": {
          "type": "http",
          "url": "https://copilot-api.SUBDOMAIN.ghe.com/mcp",
          "headers": {
            "Authorization": "Bearer ${input:github_mcp_pat}"
          }
        }
      },
      "inputs": [
        {
          "type": "promptString",
          "id": "github_mcp_pat",
          "description": "GitHub PAT",
          "password": true
        }
      ]
    }
    
           **옵션 B: OAuth 인증 사용**
    
    JSON
    {
      "servers": {
        "github": {
          "type": "http",
          "url": "https://copilot-api.SUBDOMAIN.ghe.com/mcp"
        }
      }
    }
    

    귀하의 GHE.com 하위 도메인으로 SUBDOMAIN.ghe.com을(를) 대체하십시오.

  5. 파일을 저장합니다.

  6. OAuth를 데이터 보존 기능을 갖춘 GitHub Enterprise Cloud과 함께 사용하는 경우, GitHub Enterprise Cloud 인스턴스를 가리키도록 VS Code 설정을 구성합니다. 사용자 설정에 다음을 추가합니다VS Code.

    {
      "github-enterprise.uri": "https://copilot-api.SUBDOMAIN.ghe.com/mcp"
    }
    
  7. 변경 내용을 적용하려면 창을 다시 시작 Visual Studio Code 하거나 다시 로드합니다.

          GitHub Enterprise Cloud 데이터 상주가 있는 경우 원격 MCP 서버를 사용할 수 있습니다. 구성하려면 MCP 서버 URL을 업데이트하여 GitHub Enterprise Cloud 인스턴스를 가리키도록 해야 합니다.

예를 들어, GitHub Enterprise Cloud 인스턴스가 https://octocorp.ghe.com인 경우, MCP 서버 URL은 https://copilot-api.octocorp.ghe.com/mcp입니다.

  1. 메뉴 모음에서 Visual Studio보기를 클릭한 다음 을 클릭합니다 깃허브 코파일럿 채팅.
  2. 채팅 패널 아래쪽의 모드 드롭다운에서 Agent를 선택합니다.
  3. 창에서 공동 파일럿 채팅 도구 아이콘을 클릭한 다음 도구 선택 창에서 더하기 아이콘을 클릭합니다.
  4. "Configure MCP server" 팝업창에서 필드를 채웁니다.
    1. "서버 ID"에 github 입력합니다.
    2. "유형"의 경우, 드롭다운에서 "HTTP/SSE"를 선택합니다.
    3. "URL"의 경우, YOURSUBDOMAIN을(를) GitHub Enterprise Cloud 하위 도메인으로 바꿔서 https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp을(를) 입력합니다.
    4. "Headers" 아래에 "Authorization"이라는 새 헤더를 추가하고 값을 Bearer YOUR_GITHUB_PAT으로 설정하며, "YOUR_GITHUB_PAT"를 사용자의 personal access token으로 바꾸세요.
  5.        **저장**을 클릭합니다.
    
          GitHub Enterprise Cloud 데이터 상주가 있는 경우 원격 MCP 서버를 사용할 수 있습니다. 구성하려면 MCP 서버 URL을 업데이트하여 GitHub Enterprise Cloud 인스턴스를 가리키도록 해야 합니다.

예를 들어, GitHub Enterprise Cloud 인스턴스가 https://octocorp.ghe.com인 경우 MCP 서버 URL은 https://copilot-api.octocorp.ghe.com/mcp 다음과 같습니다.

  1. 오른쪽 아래 모서리에서 을 클릭합니다.

  2. 메뉴에서 "Open Chat"을 선택하고, 에이전트 모드에 있는지 확인한 다음, 채팅 창 하단에 있는 도구 아이콘("MCP 서버 구성"이라고 함)을 클릭합니다.

  3. Add MCP Tools를 클릭합니다.

  4.        `mcp.json` 파일에서 다음 구성을 추가하고, `YOURSUBDOMAIN`을(를) 당신의 GitHub Enterprise Cloud 하위 도메인으로, `YOUR_GITHUB_PAT`을(를) 당신의 personal access token로 교체하십시오.
    
    JSON
    {
      "servers": {
        "github": {
          "url": "https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp",
          "requestInit": {
            "headers": {
              "Authorization": "Bearer YOUR_GITHUB_PAT"
            }
          }
        }
      }
    }
    
          GitHub Enterprise Cloud 데이터 상주 기능을 갖춘 경우 원격 MCP 서버를 사용할 수 있습니다. 구성하려면 MCP 서버 URL을 업데이트하여 GitHub Enterprise Cloud 인스턴스를 가리키도록 해야 합니다.

예를 들어, GitHub Enterprise Cloud 인스턴스가 https://octocorp.ghe.com인 경우, MCP 서버 URL은 https://copilot-api.octocorp.ghe.com/mcp입니다.

  1. Xcode용 GitHub Copilot 확장을 열고 "Settings"로 이동합니다.

    • 또는, 활성 Xcode 작업 영역의 메뉴 모음에서 Editor를 클릭하고 GitHub Copilot 을 선택한 다음, Open GitHub Copilot for Xcode Settings를 클릭하여 설정을 찾을 수 있습니다.
  2. MCP 탭을 선택한 다음, Edit Config를 클릭합니다.

  3.        `YOURSUBDOMAIN`을 GitHub Enterprise Cloud 하위 도메인으로, `YOUR_GITHUB_PAT`을 personal access token으로 바꿔 아래 구성을 추가하십시오.
    
    JSON
    {
      "servers": {
        "github": {
          "url": "https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp",
          "requestInit": {
            "headers": {
              "Authorization": "Bearer YOUR_GITHUB_PAT"
            }
          }
        }
      }
    }
    
          GitHub Enterprise Cloud 데이터 상주가 있는 경우 원격 MCP 서버를 사용할 수 있습니다. 구성하려면 MCP 서버 URL을 업데이트하여 GitHub Enterprise Cloud 인스턴스를 가리키도록 해야 합니다.

예를 들어, GitHub Enterprise Cloud 인스턴스가 https://octocorp.ghe.com인 경우, MCP 서버 URL은 https://copilot-api.octocorp.ghe.com/mcp입니다.

  1. Eclipse 하단의 상태 표시줄에 있는 Copilot 아이콘()을 클릭합니다.

  2. 메뉴에서 Open Chat을 선택하고 채팅 창에서 "Configure Tools..." 아이콘을 클릭합니다.

    • 또는 Edit preferences를 선택한 다음, 왼쪽 창에서 GitHub Copilot을 확장하고 MCP를 클릭합니다.
  3. "서버 구성" 아래에 다음 구성을 추가하여, YOURSUBDOMAIN을(를) GitHub Enterprise Cloud 하위 도메인으로 바꾸고 YOUR_GITHUB_PAT을(를) personal access token으로 교체하세요.

    JSON
    {
      "servers": {
        "github": {
          "url": "https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp",
          "requestInit": {
            "headers": {
              "Authorization": "Bearer YOUR_GITHUB_PAT"
            }
          }
        }
      }
    }
    
  4.        **적용**을 클릭합니다.
    

엔터프라이즈용 로컬 MCP 서버 구성

          GitHub Enterprise Server와 GitHub Enterprise Cloud 모두 데이터 상주 기능을 갖춘 로컬 MCP 서버를 지원합니다. 환경 변수 또는 `GITHUB_HOST` 명령줄 플래그를 `--gh-host` 사용하여 로컬 서버를 구성할 수 있습니다.

중요 고려 사항

  • 에 대한 경우GitHub Enterprise Server: 호스트 이름 앞에 https:// URI 스킘을 지정하십시오. 그렇지 않으면 기본적으로 http://으로 설정되며 이는 GitHub Enterprise Server에서 지원되지 않습니다.
  • 데이터 보존의 경우GitHub Enterprise Cloud: 호스트 이름으로 사용합니다https://YOURSUBDOMAIN.ghe.com.

Docker를 사용하여 구성

Docker Visual Studio Code를 사용하여 로컬 MCP 서버를 구성하려면:

  1.        Visual Studio Code
           <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd>를 눌러 명령 팔레트를 엽니다 (Windows/Linux) / <kbd>Command</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd>를 눌러 명령 팔레트를 엽니다 (Mac).
    
  2.        **MCP를 입력하고 선택합니다. 사용자 구성을 엽니다**.
    
  3. 설정 파일에서 해당 섹션 servers을 찾거나 존재하지 않는 경우에는 만듭니다.

  4. 다음 구성을 추가합니다.

           **의 경우 GitHub Enterprise Server:**
    
    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOUR_GHES_HOSTNAME"
          }
        }
      }
    }
    
           `YOUR_GHES_HOSTNAME`을(를) GitHub Enterprise Server 호스트 이름(예: `https://github.example.com`)으로 바꾸십시오.
    
    
           **데이터 저장 위치의 경우 GitHub Enterprise Cloud:**
    
    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOURSUBDOMAIN.ghe.com"
          }
        }
      }
    }
    
           `YOURSUBDOMAIN`을(를) GitHub Enterprise Cloud 서브도메인으로 교체합니다.
    
  5. 파일을 저장합니다.

  6. 변경 내용을 적용하려면 창을 다시 시작 Visual Studio Code 하거나 다시 로드합니다.

Docker를 사용하여 Visual Studio에서 로컬 MCP 서버를 구성하려면 mcp.json 파일을 수동으로 편집해야 합니다.

  1.        `mcp.json` 파일을 Visual Studio에서 엽니다. 파일은 일반적으로 사용자 프로필 디렉터리에 있습니다.
    
  2. 다음 구성을 추가합니다.

           **의 경우 GitHub Enterprise Server:**
    
    JSON
    {
      "mcp": {
        "inputs": [
          {
            "type": "promptString",
            "id": "github_token",
            "description": "GitHub PAT",
            "password": true
          }
        ],
        "servers": {
          "github": {
            "command": "docker",
            "args": [
              "run",
              "-i",
              "--rm",
              "-e",
              "GITHUB_PERSONAL_ACCESS_TOKEN",
              "-e",
              "GITHUB_HOST",
              "ghcr.io/github/github-mcp-server"
            ],
            "env": {
              "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
              "GITHUB_HOST": "https://YOUR_GHES_HOSTNAME"
            }
          }
        }
      }
    }
    
           `YOUR_GHES_HOSTNAME`을(를) GitHub Enterprise Server 호스트 이름(예: `https://github.example.com`)으로 바꾸십시오.
    
    
           **데이터 거주의 경우 GitHub Enterprise Cloud :**
    
    JSON
    {
      "mcp": {
        "inputs": [
          {
            "type": "promptString",
            "id": "github_token",
            "description": "GitHub PAT",
            "password": true
          }
        ],
        "servers": {
          "github": {
            "command": "docker",
            "args": [
              "run",
              "-i",
              "--rm",
              "-e",
              "GITHUB_PERSONAL_ACCESS_TOKEN",
              "-e",
              "GITHUB_HOST",
              "ghcr.io/github/github-mcp-server"
            ],
            "env": {
              "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
              "GITHUB_HOST": "https://YOURSUBDOMAIN.ghe.com"
            }
          }
        }
      }
    }
    
           `YOURSUBDOMAIN`를 GitHub Enterprise Cloud 하위 도메인으로 교체하세요.
    
  3. 파일을 저장합니다.

JetBrains IDE에서 Docker를 사용하여 로컬 MCP 서버를 구성하려면 다음을 수행합니다.

  1. 오른쪽 아래 모서리에서 을 클릭합니다.

  2. 메뉴에서 "Open Chat"을 선택하고, 에이전트 모드에 있는지 확인한 다음, 채팅 창 하단에 있는 도구 아이콘("MCP 서버 구성"이라고 함)을 클릭합니다.

  3. Add MCP Tools를 클릭합니다.

  4. 다음 구성을 추가합니다.

           **의 경우 GitHub Enterprise Server:**
    
    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOUR_GHES_HOSTNAME"
          }
        }
      }
    }
    
           `YOUR_GHES_HOSTNAME`을(를) GitHub Enterprise Server 호스트 이름(예: `https://github.example.com`)으로 바꾸십시오.
    
    
           **데이터 소재지의 경우 GitHub Enterprise Cloud :**
    
    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOURSUBDOMAIN.ghe.com"
          }
        }
      }
    }
    
           `YOURSUBDOMAIN`를 GitHub Enterprise Cloud 하위 도메인으로 교체하세요.
    

Xcode에서 Docker를 사용하여 로컬 MCP 서버를 구성하려면 다음을 수행합니다.

  1. Xcode용 GitHub Copilot 확장을 열고 "Settings"로 이동합니다.

    • 또는, 활성 Xcode 작업 영역의 메뉴 모음에서 Editor를 클릭하고 GitHub Copilot 을 선택한 다음, Open GitHub Copilot for Xcode Settings를 클릭하여 설정을 찾을 수 있습니다.
  2. MCP 탭을 선택한 다음, Edit Config를 클릭합니다.

  3. 다음 구성을 추가합니다.

           **의 경우 GitHub Enterprise Server:**
    
    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOUR_GHES_HOSTNAME"
          }
        }
      }
    }
    
           `YOUR_GHES_HOSTNAME`을(를) 예를 들어 GitHub Enterprise Server 호스트 이름으로 교체하세요`https://github.example.com`.
    
              **데이터 보존이 있는 GitHub Enterprise Cloud의 경우:**
    
    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOURSUBDOMAIN.ghe.com"
          }
        }
      }
    }
    
           `YOURSUBDOMAIN`을(를) GitHub Enterprise Cloud 하위 도메인으로 교체하십시오.
    

Eclipse에서 Docker를 사용하여 로컬 MCP 서버를 구성하려면 다음을 수행합니다.

  1. Eclipse 하단의 상태 표시줄에 있는 Copilot 아이콘()을 클릭합니다.

  2. 메뉴에서 Open Chat을 선택하고 채팅 창에서 "Configure Tools..." 아이콘을 클릭합니다.

    • 또는 Edit preferences를 선택한 다음, 왼쪽 창에서 GitHub Copilot을 확장하고 MCP를 클릭합니다.
  3. "서버 구성(Server Configurations)" 아래에 다음 구성을 추가합니다.

           **의 경우 GitHub Enterprise Server:**
    
    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOUR_GHES_HOSTNAME"
          }
        }
      }
    }
    

    당신의 GitHub Enterprise Server 호스트 이름(예: https://github.example.com)으로 YOUR_GHES_HOSTNAME을 대체합니다.

           **데이터 거주지의 경우 GitHub Enterprise Cloud :**
    
    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOURSUBDOMAIN.ghe.com"
          }
        }
      }
    }
    
           `YOURSUBDOMAIN`을(를) GitHub Enterprise Cloud 하위 도메인으로 교체하십시오.
    
  4.        **적용**을 클릭합니다.
    

원본에서 빌드할 때 구성

Docker를 사용하는 대신 원본에서 MCP 서버를 빌드하는 경우 환경 변수를 GITHUB_HOST 설정하거나 명령줄 플래그를 --gh-host 사용할 수 있습니다.

          **환경 변수 사용:**
export GITHUB_HOST="https://YOUR_GHES_OR_GHEC_HOSTNAME"
./github-mcp-server stdio
          **명령줄 플래그 사용:**
./github-mcp-server --gh-host \
  "https://YOUR_GHES_OR_GHEC_HOSTNAME" stdio
          `YOUR_GHES_OR_GHEC_HOSTNAME`를 GitHub Enterprise Server 호스트 이름(예: `https://github.example.com`) 또는 GitHub Enterprise Cloud 호스트 이름(예: `https://octocorp.ghe.com`)으로 바꾸세요.

다음 단계