내 AI 비서에게 GitHub 권한을? GitHub MCP Server 소개 및 설정 가이드 (Claude, Cursor)
1
설명
AI가 내 GitHub 리포지토리를 직접 읽고, 이슈를 생성하고, 심지어 파일까지 수정할 수 있게 만들어주는 GitHub MCP Server를 소개하려고 합니다.
매번 소스 코드를 복사·붙여넣기 하거나 이슈 내용을 직접 옮기느라 귀찮으셨던 분들에게 강력히 추천합니다.
🤖 GitHub MCP Server란?
GitHub MCP Server는 LLM(대형 언어 모델)이 내 GitHub 계정과 안전하게 상호작용할 수 있도록 연결해 주는 다리입니다. 이 서버를 연동하면 AI에게 다음과 같은 명령을 내릴 수 있습니다.
"내 리포지토리의 #12 이슈 내용 좀 요약해 줘."
"특정 소스 코드 파일 내용 확인하고 버그 수정해서 푸시해 줘."
"현재 프로젝트에 오픈된 PR 목록 보여줘."
🛠️ 사전 준비물
시작하기 전에 GitHub Personal Access Token (Classic)이 필요합니다.
1. GitHub > Settings > Developer Settings > Personal Access Tokens > Tokens (classic)으로 이동합니다.
2. Generate new token (classic)을 클릭합니다.
3. 권한(scopes)에서 repo 권한(이슈, PR, 코드 수정 등)을 체크하고 토큰을 생성합니다.
4. 생성된 토큰(ghp_...)을 안전한 곳에 복사해 둡니다.
🚀 AI 툴별 연동 방법 (Claude & Cursor)
1. Claude Desktop에 적용하기
Claude 데스크톱 앱을 사용 중이라면 설정 파일에 한 줄만 추가하면 됩니다.
1) Claude 데스크톱의 설정 구성 파일(claude_desktop_config.json)을 엽니다.
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
2) mcpServers 항목에 아래 내용을 추가합니다. (YOUR_GITHUB_TOKEN 부분에 복사한 토큰을 입력하세요.)
JSON{
"mcpServers": {
"github": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-github"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_TOKEN"
}
}
}
}
1) Claude Desktop 앱을 완전히 종료 후 재시작합니다. 오른쪽 하단에 🔌(플러그) 아이콘이 뜨면 성공입니다!
2. Cursor에 적용하기
개발자분들이 가장 많이 쓰시는 IDE인 Cursor에서도 간편하게 설정할 수 있습니다.
1) Cursor를 실행하고 Settings (Ctrl + , 또는 Cmd + ,)로 이동합니다.
2) Features > MCP 섹션으로 이동합니다.
3) + Add New MCP Server 버튼을 클릭하고 다음과 같이 입력합니다.
항목 입력할 값
Name github
Type command
Command npx -y @modelcontextprotocol/server-github
1) Environment Variables (환경 변수) 추가 버튼을 눌러 아래 내용을 입력합니다.
Key: GITHUB_PERSONAL_ACCESS_TOKEN
Value: 내 GitHub 토큰 값
2) Save를 누르면 끝! Cursor Chat에서 바로 GitHub 관련 기능을 사용할 수 있습니다.
💡 사용 예시 (꿀팁)
연동이 완료되었다면 Claude나 Cursor Chat창에 대고 이렇게 대화를 시작해 보세요.
"username/my-repo 리포지토리의 최근 이슈 5개만 보여줘."
"username/my-repo의 main 브랜치에 있는 src/index.js 파일 내용 읽어와 줘."
처음에는 토큰 권한이나 리포지토리 경로(유저명/리포지토리명)를 정확히 적어주셔야 AI가 길을 잃지 않습니다. 한 번 세팅해 두면 개발 생산성이 정말 말도 안 되게 올라가니 꼭 적용해 보세요!
궁금한 점이나 막히는 부분이 있다면 댓글로 편하게 남겨주세요. 🙂
신고 · 불법·유해·아동 안전(CSAE) 관련 콘텐츠
댓글 0
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.