Claude × GitHub MCP 가이드 2026: 자연어로 이슈·PR·코드 검색하기
GitHub 공식 MCP를 Claude에 연결하면 자연어로 레포 읽기·파일 수정·코드/이슈 검색·PR 관리를 할 수 있다. OAuth 연결, 51개 툴셋, 자동 브랜치·git 히스토리 보존, secret_protection(GA)까지 — 설치 경로와 사용법, 권한 주의점을 직접 확인해 정리했다.
MCP 시리즈를 이어간다. 오늘은 개발자용 끝판왕 중 하나다. Claude에 GitHub 공식 MCP를 연결하면 “이 레포 최근 이슈 정리해줘”, “이 브랜치로 PR 만들어줘”를 말로 시킬 수 있다. 레포 읽기·파일 수정·코드/이슈 검색·PR 관리까지 자연어로 된다. GitHub이 직접 만든 공식 서버라 신뢰도도 높다.
뭐가 가능해지나?
Claude가 내 GitHub에 직접 접근한다.
- 레포 파일 읽기·생성·수정(자동 브랜치 생성 + git 히스토리 보존)
- 코드·이슈 검색(“이 함수 어디서 쓰이나”, “결제 관련 열린 이슈 찾아줘”)
- PR 관리(생성·리뷰·상태 확인)
- 레포 인사이트 분석까지 자연어로
편집기·브라우저를 오가지 않고 대화로 레포 작업을 처리하는 게 핵심이다. 같은 MCP 계열은 Playwright MCP·Notion MCP에서 이어진다.
왜 이게 되나?
핵심은 GitHub 공식 MCP 서버다. GitHub이 직접 만들어 유지하는 서버라 레포 전체 워크플로(이슈→코드→PR)를 커버한다. OAuth로 내 GitHub 계정을 연결하면 Claude가 51개 툴셋에 접근한다. MCP가 이런 연결의 표준이 된 배경은 스킬 vs MCP에서 이어진다.
언제 쓰나
| 잘 맞는 상황 | 덜 맞는 상황 |
|---|---|
| 이슈 트리아지·PR 초안·코드 검색 | 자동 머지 등 되돌리기 어려운 작업 |
| 릴리스 노트·변경 요약 | 민감 레포에 광범위한 쓰기 권한 부여 |
| 여러 레포를 대화로 넘나들기 | 완전 오프라인 처리 |
설치 방법
두 가지 경로가 있다.
- 원격 서버(권장): OAuth 커스텀 커넥터로 연결(Claude Desktop은 Pro/Max/Team/Enterprise 플랜 필요)
- 로컬: 설정 파일에 등록 — 사용자 범위
~/.claude/settings.json, 프로젝트 범위는 프로젝트 루트의.claude/settings.json - Claude Code면
claude mcp add방식도 가능
사용 방법
연결됐다면 말로 시키면 된다.
“이 레포 최근 열린 이슈 10개 요약하고 우선순위 매겨줘” “이 변경사항으로 새 브랜치 만들고 PR 초안 작성해줘” “코드베이스에서 결제 처리 로직 어디 있는지 찾아줘”
Claude가 알아서 브랜치를 만들고 히스토리를 보존하며 작업한다.
특이점·한계 (직접 확인)
가장 신경 쓸 건 권한 스코프다. 연결 시 Claude가 접근하는 레포·권한 범위를 확인하고 쓰기 권한은 최소로 두자. secret_protection 툴셋은 커밋 전 노출된 시크릿(키·토큰)을 스캔하는데, 2026년 5월 정식(GA)됐고 레포에 GitHub Secret Protection 활성화가 필요하다. 또 일부 새 툴셋(copilot_spaces, github_support_docs_search 등)은 원격 서버 전용이라 로컬 도커 이미지엔 없다.
노하우·꿀팁
필요한 툴셋만 켜자 — 51개를 전부 켜면 토큰이 무거워진다. 읽기 위주로 시작해 익숙해지면 PR·커밋 쓰기 권한을 준다. PR은 초안까지 AI가 만들되 머지는 사람이 하는 게 안전하다(자동 머지는 피하자). 민감 레포는 secret_protection으로 사고를 예방하자.
자주 묻는 질문
Q. 공식 서버인가, 커뮤니티 서버인가? GitHub이 직접 만들어 유지하는 공식 MCP 서버다. 그래서 이슈→코드→PR의 레포 전체 워크플로를 폭넓게 커버한다.
Q. 설치는 어떻게 하나?
원격 서버는 OAuth 커스텀 커넥터로 연결한다(Claude Desktop은 Pro/Max/Team/Enterprise 필요). 로컬은 ~/.claude/settings.json(사용자)·.claude/settings.json(프로젝트)에 등록하거나 claude mcp add를 쓴다.
Q. 안전한가? 연결 시 접근 레포·권한 범위를 확인하는 게 핵심이다. 쓰기는 최소로 주고, secret_protection으로 시크릿 노출을 막고, 머지는 사람이 확정하는 것을 권한다.
Q. 자동 머지도 되나? 기술적으로 쓰기는 가능하지만, PR 초안까지 AI가 만들고 머지는 사람이 검수·확정하는 흐름을 권장한다.
