GitHub MCP란?

GitHub MCP는 AI 모델이 GitHub API에 직접 접근할 수 있게 해주는 공식 MCP 서버입니다. 리포지토리 탐색, 이슈 생성, PR 관리, 코드 검색까지 GitHub의 거의 모든 기능을 AI가 활용할 수 있습니다.

이전 편에서 Filesystem MCP를 다뤘다면, 이번에는 원격 코드 저장소와의 통합을 배웁니다.

!mcp-guide-04-github 본문 이미지 1

설정

GitHub MCP는 인증 기반 서버라 초기 설정 단계에서 토큰 발급이 반드시 선행되어야 합니다. 권한 범위(Scope)를 실제로 필요한 최소 범위로 제한하고, 가능하다면 Fine-grained Personal Access Token을 사용해 특정 저장소에만 접근할 수 있도록 잠그는 편을 권장합니다. 아래에서는 토큰 발급과 MCP 설정 등록을 순서대로 설명합니다.

GitHub Personal Access Token 발급

GitHub MCP는 인증이 필요합니다. GitHub Settings > Developer Settings > Personal Access Tokens에서 토큰을 발급합니다.

필요한 권한(Scope)은 다음과 같습니다.

MCP 서버 등록

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

환경 변수로 토큰을 주입하므로 설정 파일에 직접 토큰을 하드코딩하지 마세요. .env 파일이나 시스템 환경 변수를 활용하는 것을 권장합니다.

!PR 자동화 워크플로우

핵심 도구

GitHub MCP가 제공하는 주요 도구들입니다.

PR 관련

# PR 목록 조회
claude "my-org/my-repo의 열린 PR 목록을 보여줘"

PR 상세 + diff 확인
claude "PR #42의 변경 내용을 요약해줘"

PR 리뷰 코멘트 작성
claude "PR #42에 코드 리뷰를 작성해줘. 보안과 성능 관점으로."

이슈 관련

# 이슈 생성
claude "my-repo에 버그 이슈를 생성해줘: 로그인 시 세션 만료 처리가 안 됨"

이슈 검색
claude "이번 주에 생성된 bug 라벨 이슈들을 찾아줘"

이슈 업데이트
claude "이슈 #15에 진행 상황 코멘트를 추가해줘"

코드 검색

# 리포지토리 내 코드 검색
claude "my-repo에서 deprecated된 API 호출을 찾아줘"

파일 내용 직접 조회
claude "my-repo의 src/auth/middleware.ts 파일을 보여줘"

!mcp-guide-04-github 본문 이미지 2

실전 워크플로우: AI 코드 리뷰

GitHub MCP의 가장 강력한 활용 사례는 AI 기반 코드 리뷰 자동화입니다.

// Claude Code에서 자연어로 실행하는 워크플로우 예시
// 1. PR의 변경 사항을 가져옴
// 2. 변경 파일을 분석
// 3. 리뷰 코멘트 작성

// 실제로는 이런 프롬프트 하나로 동작합니다:
// "PR #42를 리뷰해줘. 보안 취약점, 성능 이슈, 코딩 컨벤션을 중심으로."

AI가 수행하는 코드 리뷰 체크리스트는 다음과 같습니다.

• 보안 취약점 (하드코딩된 시크릿, SQL 인젝션, XSS)
• 성능 문제 (N+1 쿼리, 불필요한 리렌더링)
• 에러 핸들링 누락
• 타입 안전성
• 테스트 커버리지 확인

!이슈 자동 분류

고급 활용: 자동 이슈 분류

GitHub MCP를 활용하면 새 이슈를 자동으로 분류하고 담당자를 배정할 수 있습니다.

# 라벨이 없는 이슈를 찾아서 자동 분류
claude "my-repo에서 라벨이 없는 열린 이슈들을 찾아서,
내용을 분석한 뒤 bug/feature/docs 라벨을 추천해줘"

여러 리포지토리를 동시에 관리할 때 특히 유용합니다.

# 여러 리포 상태를 한 번에 파악
claude "my-org의 모든 리포에서 7일 이상 된 리뷰 대기 PR을 찾아줘"

보안 주의사항

GitHub MCP 사용 시 반드시 지켜야 할 보안 수칙입니다.

최소 권한 원칙: 필요한 scope만 부여합니다. 읽기만 필요하면 public_repo만 사용합니다

토큰 만료 설정: Fine-grained 토큰을 사용하고 만료일을 설정합니다

조직 접근 제한: 특정 리포지토리만 접근 가능하도록 제한합니다

감사 로그 확인: GitHub의 Security Log에서 토큰 사용 내역을 주기적으로 점검합니다

다음 단계

GitHub에서 코드와 프로젝트를 관리하는 방법을 익혔다면, 다음 편에서는 PostgreSQL MCP를 활용한 데이터베이스 쿼리 자동화를 다룹니다.

---

MCP 실전 가이드 시리즈

MCP란 무엇인가

첫 MCP 서버 만들기

Filesystem MCP 실전

GitHub MCP 자동화 (현재 글)

PostgreSQL MCP 쿼리

Slack MCP 커뮤니케이션

Linear MCP 프로젝트 관리

커스텀 MCP 서버

MCP 보안 가이드

MCP 생태계 총정리

AI K LINK의 Kit MCP 목록에서 GitHub MCP 서버를 확인하세요. API 레퍼런스에서 상세 설정을 참고할 수 있습니다.