GitHub MCP 서버는 클로드가 GitHub의 레포·이슈·풀리퀘스트 등을 다루게 해 주는 GitHub 공식 서버입니다. 두 가지 방식 — 원격(GitHub 호스팅)과 로컬(Docker) — 으로 연결할 수 있습니다. (참고: PR에 @claude 멘션으로 자동 리뷰하는 GitHub Actions 방식은 별개이며 GitHub Actions 연동 글에서 다룹니다.)
무엇을 할 수 있나
레포 탐색, 이슈·PR 조회·생성, 코드 검색 같은 작업을 도구로 제공합니다. 기능은 "툴셋"으로 묶여 있어 필요한 것만 켤 수 있습니다(실제 도구는 켠 툴셋에 따릅니다).
방식 1 — 원격 GitHub MCP 서버 (간단)
GitHub가 직접 호스팅하는 서버입니다. 주소는 https://api.githubcopilot.com/mcp/ 이며, 원격 MCP를 지원하는 호스트(예: Claude Desktop)에서 추가한 뒤 OAuth로 GitHub에 로그인합니다. 클로드(웹·데스크톱)에서는 이 URL을 커스텀 커넥터로 추가하면 됩니다 — 연결·사용법.
방식 2 — 로컬 GitHub MCP 서버 (Docker)
Docker로 직접 실행하는 방식입니다. GitHub 개인용 액세스 토큰(PAT)이 필요하며 환경변수 GITHUB_PERSONAL_ACCESS_TOKEN으로 전달합니다. claude_desktop_config.json 예시는 다음과 같습니다.
{
"mcpServers": {
"github": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<여기에_본인_PAT>"
}
}
}
}토큰은 필요한 최소 권한으로 발급하고, 외부에 노출되지 않도록 주의하세요.
Claude Code에서
claude mcp add 명령으로 등록합니다 — 자세한 사용법은 Claude Code MCP 설정을 참고하세요.
써보기
"이 레포의 열린 이슈를 정리해줘", "최근 PR의 리뷰 포인트를 짚어줘"처럼 요청하면, 클로드가 승인을 물은 뒤 GitHub에서 작업합니다.
안전하게 · 문제해결
토큰과 권한 범위를 최소로 두세요(MCP 커넥터 보안). 서버가 안 보이거나 오류가 나면 문제해결 가이드를 참고하세요.
관련 글
PR에 @claude로 자동 리뷰는 GitHub Actions 연동, 다른 서버는 Filesystem 서버와 용도별 추천, 전체 지도는 커넥터·MCP 카탈로그, 직접 만들려면 MCP 서버 직접 만들기를 보세요. 공식 출처는 github/github-mcp-server입니다.