Claude Code에서 GitHub MCP 서버 연결하는 법 — PR 리뷰부터 이슈 관리까지 자동화

GitHub MCP 서버가 뭔지 한 줄로 정리

Claude Code에 GitHub MCP 서버를 연결하면, Claude가 터미널에서 GitHub 리포지토리를 직접 읽고, 이슈를 만들고, PR을 생성하고, 코드 리뷰까지 할 수 있게 됩니다. 브라우저를 열 필요가 없습니다. "이 리포의 열린 이슈 보여줘", "이 PR 리뷰해줘" 같은 자연어 명령이 바로 동작합니다.

GitHub이 공식으로 만든 MCP 서버(github.com/github/github-mcp-server, Star 15,000+)를 사용하며, 설치부터 실전 활용까지 10분이면 됩니다.

사전 준비 — 이것만 확인하세요

1. Claude Code가 설치되어 있어야 합니다. 터미널에서 claude --version을 실행해서 버전이 나오면 됩니다. 설치가 안 되어 있다면 아래 명령어로 설치합니다.

npm install -g @anthropic-ai/claude-code

2. GitHub Personal Access Token(PAT)이 필요합니다. MCP 서버가 GitHub API에 접근하려면 인증 토큰이 있어야 합니다. 아직 없다면 다음 단계로 만듭니다.

GitHub.com 접속 → 오른쪽 상단 프로필 → Settings → 왼쪽 메뉴 맨 아래 Developer settings → Personal access tokens → Tokens (classic) → Generate new token (classic)

권한(scope)은 다음을 체크합니다:

✅ repo          (리포지토리 전체 접근 — PR, 이슈, 코드)
✅ read:org      (조직 리포 읽기, 조직 소속이면 필요)
✅ read:user     (사용자 프로필 읽기)

토큰을 생성하면 ghp_xxxxxxxxxxxx 형태의 문자열이 나옵니다. 이 화면을 벗어나면 다시 볼 수 없으니 반드시 복사해서 안전한 곳에 저장하세요.

설치 — 터미널 명령어 한 줄

Claude Code에서 GitHub MCP 서버를 추가하는 명령어입니다. 터미널을 열고 아래를 실행합니다.

claude mcp add github \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=ghp_여기에토큰붙여넣기 \
  -- npx -y @modelcontextprotocol/server-github

각 부분의 의미:

claude mcp add github          → "github"라는 이름으로 MCP 서버 추가
-e GITHUB_PERSONAL_ACCESS_TOKEN=...  → 환경 변수로 토큰 전달
-- npx -y @modelcontextprotocol/server-github  → 실행할 MCP 서버 패키지

설치 확인:

claude mcp list

출력에 github가 보이면 성공입니다. 다음과 같은 형태로 나옵니다:

github: npx -y @modelcontextprotocol/server-github (stdio)
  Environment: GITHUB_PERSONAL_ACCESS_TOKEN=ghp_***

실전 사용법 1 — 리포지토리 이슈 관리

Claude Code를 실행하고 자연어로 GitHub 작업을 시킵니다.

열린 이슈 목록 보기:

# Claude Code 프롬프트에서
> my-org/my-repo 리포의 열린 이슈 보여줘

Claude가 GitHub API를 호출해서 이슈 번호, 제목, 라벨, 작성자, 생성일을 정리해서 보여줍니다.

새 이슈 생성:

> my-org/my-repo에 이슈 만들어줘
  제목: 로그인 페이지 다크모드 미적용
  내용: 설정에서 다크모드를 켜도 로그인 페이지는 여전히 라이트 모드로 표시됩니다.
  라벨: bug

Claude가 create_issue 도구를 호출해서 실제로 GitHub에 이슈가 생성됩니다. 이슈 번호와 URL까지 알려줍니다.

이슈 검색:

> my-org/my-repo에서 "authentication" 관련 이슈 찾아줘

실전 사용법 2 — PR 생성과 코드 리뷰

GitHub MCP의 가장 강력한 기능입니다.

PR의 변경 내용 확인:

> my-org/my-repo의 PR #42 변경 내용을 분석해줘

Claude가 PR의 diff를 읽고, 변경된 파일 목록과 각 파일에서 무엇이 바뀌었는지 요약합니다.

PR 코드 리뷰 요청:

> my-org/my-repo PR #42를 코드 리뷰해줘.
  보안 취약점, 성능 이슈, 코딩 컨벤션 위반을 중점으로 봐줘

Claude가 diff를 줄 단위로 분석하고, 문제가 되는 부분에 대해 파일명 + 라인 번호 + 구체적인 개선 제안을 줍니다. 실제 PR에 리뷰 코멘트를 달아달라고 하면 create_pull_request_review 도구로 GitHub에 직접 코멘트가 달립니다.

PR 생성:

> 현재 브랜치의 변경 사항으로 my-org/my-repo에 PR 만들어줘
  제목: fix: 다크모드 로그인 페이지 적용
  base 브랜치: main

실전 사용법 3 — 코드 검색과 파일 읽기

로컬에 clone하지 않은 리포지토리의 코드도 직접 읽을 수 있습니다.

파일 내용 읽기:

> facebook/react 리포의 packages/react/src/React.js 파일 보여줘

코드 검색:

> my-org/my-repo에서 "deprecated" 키워드가 있는 파일 찾아줘

리포 구조 파악:

> my-org/my-repo의 src/ 디렉토리 구조 보여줘

이 기능이 특히 유용한 상황은 오픈소스 프로젝트를 분석할 때입니다. 수십 개의 파일을 브라우저에서 하나하나 클릭하는 대신, Claude에게 "이 프로젝트의 인증 로직이 어디에 있어?"라고 물으면 관련 파일을 찾아서 설명해줍니다.

설정 파일로 관리하기 — .mcp.json

팀 프로젝트에서 모든 팀원이 같은 MCP 설정을 쓰려면, 프로젝트 루트에 .mcp.json 파일을 만들어 git에 커밋합니다.

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

토큰을 파일에 직접 쓰면 보안 문제가 되므로, ${GITHUB_TOKEN}처럼 환경 변수를 참조하게 합니다. 각 팀원은 자신의 셸 환경에 GITHUB_TOKEN을 설정하면 됩니다.

# ~/.zshrc 또는 ~/.bashrc에 추가
export GITHUB_TOKEN="ghp_여기에내토큰"

이렇게 하면 claude mcp add를 따로 실행할 필요 없이, 해당 프로젝트 폴더에서 Claude Code를 열면 자동으로 GitHub MCP가 연결됩니다.

트러블슈팅 — 자주 발생하는 오류

오류 1: "GITHUB_PERSONAL_ACCESS_TOKEN is not set"

토큰이 비어있거나 환경 변수가 전달되지 않은 경우입니다. claude mcp remove github으로 삭제 후 다시 추가하세요. 토큰 앞뒤에 공백이나 따옴표가 포함되지 않았는지 확인합니다.

# 삭제 후 다시 추가
claude mcp remove github
claude mcp add github \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=ghp_정확한토큰 \
  -- npx -y @modelcontextprotocol/server-github

오류 2: "Resource not accessible by personal access token"

토큰의 권한(scope)이 부족합니다. GitHub Settings → Developer settings → Personal access tokens에서 해당 토큰의 scope에 repo가 포함되어 있는지 확인하세요. 조직(Organization) 리포에 접근하려면 조직 관리자가 해당 토큰의 접근을 승인해야 할 수도 있습니다.

오류 3: "npx: command not found"

Node.js가 설치되지 않았거나 PATH에 없는 경우입니다. node --version으로 Node.js 설치 여부를 확인하고, 없으면 nvm install --lts 또는 nodejs.org에서 설치하세요.

오류 4: MCP 서버가 Claude Code에서 안 보임

claude mcp list에서 github가 표시되는지 확인합니다. 표시되는데 Claude 대화에서 동작하지 않으면, Claude Code를 완전히 종료하고 다시 실행합니다. MCP 서버는 Claude Code 시작 시 로드됩니다.

보안 주의사항

GitHub PAT은 GitHub 계정의 비밀번호와 동일한 수준의 접근 권한을 줍니다. 다음 사항을 꼭 지켜주세요.

토큰을 코드에 직접 쓰지 마세요. .mcp.json에는 ${환경변수}를 쓰고, 실제 토큰은 셸 환경 변수나 시크릿 매니저로 관리합니다. .env 파일에 토큰을 넣었다면 반드시 .gitignore에 .env를 추가하세요.

최소 권한 원칙을 적용하세요. 읽기만 필요하면 repo 대신 public_repo(퍼블릭 리포만 접근)를 선택합니다. Fine-grained token을 사용하면 특정 리포지토리에만 접근 권한을 줄 수 있어 더 안전합니다.

토큰 만료 기간을 설정하세요. PAT 생성 시 Expiration을 90일 이하로 설정하고, 주기적으로 갱신하는 것을 권장합니다.

다음 단계 — 이것도 연결해보세요

GitHub MCP에 익숙해졌다면, 다른 MCP 서버를 추가로 연결하면 Claude Code의 활용 범위가 더 넓어집니다.

Filesystem MCP(@modelcontextprotocol/server-filesystem): 로컬 파일 시스템에 대한 고급 파일 작업. PostgreSQL MCP(@modelcontextprotocol/server-postgres): 자연어로 DB 쿼리 실행. Playwright MCP: 웹 브라우저 자동화, E2E 테스트.

설치 방식은 모두 동일합니다. claude mcp add 이름 -- npx -y 패키지명 형태로 추가하면 됩니다. 사용 가능한 MCP 서버 전체 목록은 awesome-mcp-servers(GitHub Star 83K+)에서 확인하세요.

이 글에 소개된 서비스와 도구는 작성 시점 기준이며, 업데이트에 따라 변경될 수 있습니다.