# GitHub MCP Server

## 개요

GitHub MCP 서버는 Panther AI를 GitHub 계정에 연결하여 저장소, 이슈, 풀 요청, GitHub Actions, 코드 보안 기능과 상호작용할 수 있는 도구를 제공합니다.

**MCP 서버 URL:** `https://api.githubcopilot.com/mcp`

## 사전 요구 사항

* GitHub 계정
* GitHub Copilot Business 또는 Enterprise를 사용하는 조직의 경우
  * 조직 관리자에게 다음을 활성화하도록 요청해야 합니다. **Copilot의 MCP 서버** 정책

## Setup

GitHub MCP 서버를 사용하려면 수동 OAuth 자격 증명이 필요합니다. GitHub는 OAuth용으로 두 가지 앱 유형을 지원합니다: **GitHub Apps** (권장) 및 **OAuth Apps**. GitHub Apps는 수명이 짧은 토큰과 세분화된 권한을 사용하므로 더 안전합니다. OAuth Apps는 설정이 더 간단하지만 더 광범위하고 수명이 긴 토큰을 사용합니다.

앱 유형과 관계없이, 리디렉션 URL을 얻기 위해 먼저 Panther에 서버를 추가하세요.

### 옵션 1: GitHub App(권장)

1. **Panther에 서버를 추가합니다:**
   1. Panther Console의 오른쪽 상단에서 톱니바퀴 아이콘(**설정**) > **Panther AI**.
   2. 다음으로 이동합니다. **MCP 서버** 탭.
   3. 을 클릭합니다 **MCP 서버 추가**.
   4. 선택 **GitHub** 카탈로그에서 선택합니다.
   5. 다음을 입력합니다 **Name** 서버 이름(예: "GitHub")
   6. 선택적으로 다음을 입력합니다. **설명**.
   7. 을 클릭합니다 **다음**. Panther에 다음이 표시됩니다. **리디렉션 URL**. 이 URL을 복사하세요. 다음 단계에서 필요합니다.
2. **GitHub App을 생성합니다:**
   1. GitHub 계정에 로그인합니다.
   2. 다음으로 이동합니다. **설정** > **개발자 설정** > **GitHub Apps**.
   3. 을 클릭합니다 **새 GitHub App**.
   4. 다음을 입력합니다:
      * **GitHub App 이름**: 이름을 입력합니다(예: "Panther AI MCP").
      * **홈페이지 URL**: Panther 인스턴스 URL을 입력합니다.
      * **콜백 URL**: 1단계에서 복사한 리디렉션 URL을 붙여넣습니다.
   5. 필요한 **권한을 설정합니다** 허용하려는 작업에 대해.
   6. 을 클릭합니다 **GitHub App 생성**.
   7. 다음을 기록해 두고 **Client ID** 및 다음을 생성합니다. **클라이언트 시크릿**.
3. **GitHub App을 설치합니다:**
   * 개인 계정에 액세스 권한을 부여하려면: 앱의 설정 페이지로 이동하여 다음을 클릭합니다. **앱 설치**.
   * 조직에 액세스 권한을 부여하려면: 조직 관리자가 다음에서 앱을 설치해야 합니다. **조직 설정** > **GitHub Apps**또는 다음으로 이동합니다. `https://github.com/organizations/[ORG_NAME]/settings/apps`.
4. **Panther에서 설정을 완료합니다:**
   1. Panther MCP 서버 설정 마법사로 돌아갑니다.
   2. 다음을 입력합니다. **Client ID** Run Panther AI **클라이언트 시크릿** 를 2단계에서 가져온 값으로.
   3. 을 클릭합니다 **Create**.

### 옵션 2: OAuth App

1. **Panther에 서버를 추가합니다:**
   1. Panther Console의 오른쪽 상단에서 톱니바퀴 아이콘(**설정**) > **Panther AI**.
   2. 다음으로 이동합니다. **MCP 서버** 탭.
   3. 을 클릭합니다 **MCP 서버 추가**.
   4. 선택 **GitHub** 카탈로그에서 선택합니다.
   5. 다음을 입력합니다 **Name** 서버 이름(예: "GitHub")
   6. 선택적으로 다음을 입력합니다. **설명**.
   7. 을 클릭합니다 **다음**. Panther에 다음이 표시됩니다. **리디렉션 URL**. 이 URL을 복사하세요. 다음 단계에서 필요합니다.
2. **GitHub OAuth App을 생성합니다:**
   1. GitHub 계정에 로그인합니다.
   2. 다음으로 이동합니다. **설정** > **개발자 설정** > **OAuth Apps**.
   3. 을 클릭합니다 **새 OAuth App**.
   4. 다음을 입력합니다:
      * **애플리케이션 이름**: 이름을 입력합니다(예: "Panther AI MCP").
      * **홈페이지 URL**: Panther 인스턴스 URL을 입력합니다.
      * **승인 콜백 URL**: 1단계에서 복사한 리디렉션 URL을 붙여넣습니다.
   5. 을 클릭합니다 **애플리케이션 등록**.
   6. 다음을 기록해 두고 **Client ID** 및 다음을 생성합니다. **클라이언트 시크릿**.
3. **Panther에서 설정을 완료합니다:**
   1. Panther MCP 서버 설정 마법사로 돌아갑니다.
   2. 다음을 입력합니다. **Client ID** Run Panther AI **클라이언트 시크릿** 를 2단계에서 가져온 값으로.
   3. 을 클릭합니다 **Create**.

### 계정 연결

관리자가 GitHub 서버를 추가한 후:

1. MCP 서버 페이지에서 다음을 찾습니다. **GitHub** 사용 가능한 서버 목록에서.
2. 을 클릭합니다 **연결**.
3. GitHub의 OAuth 승인 페이지로 리디렉션됩니다. 로그인하고 요청된 권한을 부여하세요.
4. 승인 후, 도구 권한을 구성하기 위해 Panther로 다시 리디렉션됩니다.

### 조직의 비공개 저장소에 대한 액세스 허용

조직은 명시적으로 승인되기 전까지 GitHub Apps와 OAuth Apps를 차단할 수 있습니다. 사용자가 조직 리소스에 액세스할 때 승인 오류가 발생하면 조직 관리자가 액세스를 승인해야 합니다.

* **GitHub App**: 조직 관리자가 다음에서 앱을 설치해야 합니다. `https://github.com/organizations/[ORG_NAME]/settings/apps`.
* **OAuth App**: 조직 관리자가 앱을 승인해야 합니다.
  * GitHub에서 다음으로 이동합니다. **조직 설정** > **제3자 액세스** > **OAuth 앱 정책.**
  * 을 클릭합니다 **검토** > **액세스 허용**.

승인될 때까지 앱은 조직의 공개 리소스에만 액세스할 수 있습니다.

## 자세히 알아보기

* [GitHub MCP Server 문서](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp/set-up-the-github-mcp-server)
* [GitHub MCP Server 저장소](https://github.com/github/github-mcp-server)