GitHub MCP 서버 사용 방법에 대한 실용 가이드 | 안드레아 그리피스 | GitHub Blog

분야 AI 일반
1

GitHub MCP 서버 실용 가이드

주요 개요

이 문서는 로컬 MCP Docker 이미지에서 GitHub의 호스팅 서버로 업그레이드하는 방법에 대한 실용적인 가이드입니다. 토큰 없이도 풀 리퀘스트, 지속적 통합, 보안 분류를 몇 분 안에 자동화할 수 있는 방법을 제시합니다.

1. 배경 정보 및 핵심 개념

GitHub 호스팅 MCP 서버란?

  • GitHub가 완전히 호스팅하고 항상 최신 상태로 유지되는 MCP 구현체
  • Docker나 개인 액세스 토큰 관리 없이 https://api.githubcopilot.com/mcp/로 접속
  • OAuth로 한 번 인증하면 GitHub가 나머지를 처리

기본 활성화된 도구셋

  • Repository intelligence: 로컬 클론 없이 코드 검색, 파일 스트리밍, 풀 리퀘스트 열기
  • Issue 및 pull request 자동화: 단일 에이전트 프롬프트로 파일링, 분류, 라벨링, 리뷰, 병합
  • CI/CD 가시성: 워크플로 실행 검사, 로그 가져오기, 실패한 작업 재실행
  • 보안 인사이트: 코드 스캐닝 및 Dependabot 알림 표시
  • 세밀한 제어: 특정 도구셋 토글 또는 서버를 읽기 전용으로 전환

2. 로컬 vs 호스팅 서버 비교

로컬 Docker 서버 호스팅 MCP 엔드포인트
Docker 이미지 유지보수, 수동 업그레이드 GitHub가 자동으로 패치 및 업그레이드
개인 액세스 토큰(PAT) 관리 OAuth로 한 번 로그인, 스코프 자동 처리
localhost에서만 서버 노출 모든 IDE나 원격 개발 박스에서 접근 가능
바이너리 커스터마이즈 없이는 전체 쓰기 권한 내장된 읽기 전용 스위치 및 도구셋별 플래그

권장사항

  • 에어갭 환경이 필요한 경우 로컬 사용
  • 대부분의 팀은 호스팅 서버로 인프라 작업 제거하고 자동화에 집중

3. 시작하기 전 필요사항

필수 요구사항

  • GitHub Copilot 또는 Copilot Enterprise 라이선스
  • VS Code 1.92+ (또는 기타 MCP 호환 클라이언트)
  • https://api.githubcopilot.com에 대한 네트워크 접근
  • 실험용 테스트 리포지토리

4. 단계별 설정 가이드

단계 1: 원격 MCP 서버 설치

VS Code 또는 VS Code Insiders에서 설치

  1. 명령 팔레트 열기
  2. 다음 명령 실행: > GitHub MCP: Install Remote Server
  3. OAuth 플로우 완료하여 GitHub 계정 연결
  4. 서버 재시작으로 설정 완료

기타 클라이언트의 경우

  • 서버 URL을 https://api.githubcopilot.com/mcp/로 설정
  • 프롬프트시 인증 진행

연결 검증

curl -I https://api.githubcopilot.com/mcp/healthz
# HTTP/1.1 200 OK

200 OK가 보이면 설정 완료

단계 2: 액세스 제어 구성

읽기 전용 모드 사용

민감한 환경에서 작업하거나 프로덕션에서 테스트할 때 안전한 탐색을 위해 사용

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "mode": "read-only"
    }
  }
}

에이전트는 이슈, 풀 리퀘스트, 코드를 읽을 수 있지만 변경사항을 푸시할 수 없음

선택적 도구셋으로 범위 제한

"toolsets": ["context", "issues", "pull_requests"]

mode 필드 옆에 이 배열을 추가하여 다른 모든 것을 숨김

단계 3: 실습 예제

예제 1: CODEOWNERS 파일 추가 및 풀 리퀘스트 열기

프롬프트: “Add a CODEOWNERS file for /api/** assigning @backend-team, then open a draft pull request.”

에이전트 동작:

  • repos.create_file로 CODEOWNERS 파일 추가
  • pull_requests.open으로 풀 리퀘스트 생성
  • pull_requests.request_reviewers로 리뷰어 할당

예제 2: 실패한 워크플로 디버깅

프롬프트: “Why did the release.yml job fail last night?”

에이전트는 actions.get_workflow_run_logs로 로그를 가져와 스택 트레이스를 분석하고 수정사항 제안

예제 3: 보안 알림 분류

프롬프트: “List critical Dependabot alerts across all my repos and create issues for each.”

서버는 dependabot.list_dependabot_alerts로 알림을 반환하고 에이전트가 필요한 곳에만 집중된 이슈 생성

단계 4: 문제 해결 팁

증상 가능한 원인 해결방법
설치시 401 Unauthorized 남은 GITHUB_TOKEN 환경변수 변수를 해제하고 OAuth 플로우 재실행
도구가 나타나지 않음 기업 프록시가 api.githubcopilot.com 차단 프록시 설정 추가 또는 도메인 허용 목록 등록
모델 타임아웃 대용량 도구셋 활성화 필요한 도구셋만 제한

단계 5: 동적 도구셋으로 워크플로 간소화

동적 도구셋의 중요성

전체 MCP 서버에는 70개 이상의 도구가 포함되어 있어 강력하지만 사용자와 AI 모델을 압도할 수 있음

동작 방식

  1. LLM이 몇 가지 메타 도구로 시작: listAvailableToolsets, enableToolset, getToolsetTools
  2. 당면 작업 결정 (예: “풀 리퀘스트 작업”)
  3. 해당 작업에 필요한 도구만 가져와서 활성화
  4. VS Code가 도구 변경 알림을 통해 자동으로 로드

이를 통해 인터페이스와 AI가 집중적이고 효율적으로 유지됨

5. 향후 발전 방향

보안 및 에이전시 워크플로의 미래

MCP의 시크릿 스캔

  • 곧 MCP 서버가 AI 생성 시크릿을 감지하고 차단
  • GitHub가 풀 리퀘스트에서 시크릿 푸시를 방지하는 것과 동일
  • 필요시 재정의 가능하지만 기본값으로 데이터 보호

Copilot에 이슈 할당

Copilot의 코딩 에이전트와 직접 통합:

  • Copilot에 직접 이슈 할당
  • VS Code에서 완료 트리거
  • 도구 간 에이전트 대 에이전트 워크플로 관찰

미래는 에이전트가 에이전트와 협업하는 것이며, GitHub MCP가 그 기반

6. 기여 및 참여 방법

오픈소스 프로젝트

GitHub MCP 프로젝트는 완전한 오픈소스이며 빠르게 성장 중

참여 방법

  • 리포지토리 탐색: 도구 구축 방법 확인 및 기여
  • 이슈 파일링: 프로토콜 및 도구 개선에 도움
  • 토론 참여: GitHub 및 Discord에서 다른 빌더들과 연결

도구 구축, 피드백 제공, AI 기반 개발 탐색 등 MCP 생태계에서 모든 사람을 위한 자리가 있음

7. 실용적인 팁 및 주의사항

핵심 장점

  • 인프라 오버헤드 제거로 더 나은 자동화 구축에 집중
  • Docker 관리나 토큰 순환 없이 OAuth로 한 번 인증 후 바로 배포
  • 관리할 필요 없는 인프라가 최고의 인프라

권장사항

  • 에어갭 환경이 필요한 경우가 아니라면 호스팅 서버 사용
  • 전체 문서를 읽고 시작하거나 예제를 통해 실험 시작
  • 동적 도구셋을 활용하여 효율성 극대화

8. 결론

GitHub 원격 MCP 서버는 인프라 관리 부담을 제거하여 개발자가 더 나은 자동화 구축에 집중할 수 있게 합니다. 로컬 Docker 설정의 복잡성에서 벗어나 OAuth 기반의 간단한 인증과 자동 업데이트, 그리고 풍부한 도구셋을 통해 AI 기반 개발 워크플로의 새로운 가능성을 열어줍니다.

1개의 좋아요