Github MCP 설치 방법(클로드 코드)

클로드 코드에 Github MCP를 설치하는 방법입니다.

아래 공식 문서를 참조하였습니다.

https://github.com/github/github-mcp-server/blob/main/docs/installation-guides/install-claude.md

github-mcp-server/docs/installation-guides/install-claude.md at main · github/github-mcp-server

---

Github Personal Access Token 생성

Github MCP를 사용하려면 인증이 필요합니다. 이때 사용되는 것이 Github personal access token입니다.

생성 방법은 다음과 같습니다.

• Github 로그인
• 우측 상단의 "Profile" 아이콘을 클릭
• "Settings" 메뉴 클릭
• 왼쪽 메뉴 중 제일 하단의 "Developer Settings" 클릭
• 왼쪽 메뉴에서 "Personal Access Tokens" 클릭
• 하위 펼쳐진 메뉴에서 "Tokens Classic" 클릭
• 아래와 같은 화면에서 "Generate new token"을 클릭하고 "Generate New Token(Classic)"을 클릭

• 이름, expiration, scope을 설정 후 하단의 "Generate Token" 버튼을 클릭
  • 이름은 사용하고 싶은 것으로 입력하시면 됩니다. 예) codegear-info
  • expiration은 만료 기간입니다.
  • scope은 범위 입니다. 보통은 repo만 체크해주시면 됩니다.

---

Docker desktop 실행

Github MCP를 사용하기 위해서는 Docker Desktop이 실행되고 있어야 합니다.

---

클로드 코드에 Github MCP 추가하기

• 터미널에서 다음 명령을 실행합니다.

claude mcp add github -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

• 이렇게 하면 github mcp가 추가됩니다.

---

Github MCP에 인증 추가하기

• 로그인 계정의 루트에 .claude.json 파일을 에디터에서 Open합니다.
• github으로 검색해보시면 아래와 같이 추가된것을 확인할 수 있습니다.

"mcpServers": {
	"github": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {}
    }
}

• env 아래에 GITHUB_PERSONAL_ACCESS_TOKEN 을 추가합니다. 

"env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "$GITHUB_CODEGEAR"
  }

• 예시로 사용한 $GITHUB_CODEGEAR 부분에 github에서 생성한 토큰을 입력하시면 됩니다.
• 저는 맥북에서 환경변수로 $GITHUB_CODEGEAR 를 사용하였으므로 이렇게 썼습니다.
• 맥북 환경변수 등록은 .zshrc 파일에 아래 내용을 추가하시면 됩니다.

export GITHUB_CODEGEAR_TOKEN="github에서 생성한 토큰"

 

---

Github MCP 연결 확인

• 이제 클로드코드를 재실행 합니다.
• "/mcp" 를 입력합니다.
• 아래와 같이 "connected"라고 나오면 정상적으로 설치가 완료된 것입니다.