[Claude Code] Github MCP 연동하기

이번 포스팅에서는 클로드 코드와 깃허브를 연동하기 위해 Github MCP를 사용하는 방법에 대해 알아볼 것이다.

 

 

1. Github API Token 발급

Github MCP 서버 연동을 위해서는 깃허브에서 API Token을 발급 받아야 한다.

먼저, 깃허브에 로그인하여 Settings로 들어간다.

 

좌측 메뉴 최하단에 Developer settings로 들어간다.

 

Personal access tokens -> Tokens (classic) 에서 API 토큰을 생성할 수 있다.

 

토큰을 생성하다보면, 해당 토큰이 접근할 수 있는 권한 범위를 지정하는 옵션(Select scopes)이 있다.

필자는 repo, user, project 전체에 체크했다.

 

생성한 토큰은 한 번만 보여주기 때문에 반드시 안전한 곳에 복사를 해두자. ★

 

 

 

2. Github MCP 설치

앞서 만든 Github API Token으로 클로드 코드와 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

 

클로드 코드 버전에 따라 설치 명령어가 다르다고 안내되어있다. claude --version 명령으로 버전을 미리 확인해보자.

 

아래 명령어에서 YOUR_GITHUB_PAT 부분을 여러분의 Github API Token로 대체하면 된다.

Claude Code 2.1.1 버전 이상인 경우

claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'

※ Bearer: 토큰 방식으로 인증한다는 뜻

 

(참고) Invalid configuration: : Invalid input 에러가 발생한다면, Claude Code 2.1.0 버전 이하인 경우대로 진행하면 된다.

 

Claude Code 2.1.0 버전 이하인 경우

claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer YOUR_GITHUB_PAT"

※ -H: 헤더

 

클로드 코드에서 /mcp 로 조회한 MCP 목록에 github가 뜨면 잘 설치된 것이다.

 

 

 

3. Github에 프로젝트 업로드

github mcp를 사용해서 원하는 레포지토리에 업로드해달라고 요청하면 된다.

 

일단 3개의 파일만 올렸다고 하는데, 혹시 다른 파일들은 왜 누락하지 않은지 물어보는게 좋을 것 같다.

 

클로드 코드가 package.json, package-lock.json을 실수로 업로드하지 않았다고 한다.

 

만약 특정 파일들을 업로드하지 않은 명확한 이유가 있다면 .gitignore에 명시하는게 좋으니 다음과 같이 요청한다.

 

클로드 코드의 판단으로 깃허브에 업로드 하지 않은 파일들 중에서 꼭 올렸으면 좋겠다고 생각한 파일들이 있다면, .gitignore 수정 및 누락 파일 업로드를 요청하면 된다.

 

클로드 코드도 실수를 할 수 있기 때문에 결과물을 정확히 검토하는 습관이 중요하다.