GitHub MCP 서버 사용 방법에 대한 실용 가이드
MCP (Model Context Protocol) 서버를 로컬로 작동하지만 Docker 관리, 액세스 토큰 회전 및 업데이트를 당기는 것은 번거 로움입니다. GitHub의 관리되는 MCP 엔드 포인트는 이러한 인프라 두통을 제거하여 좋아하는 것, 즉 운송 코드에 집중할 수 있습니다.
이 201 레벨 튜토리얼에서는 로컬 MCP 설정에서 GitHub의 관리 엔드 포인트로 업그레이드를 진행합니다. OAUTH 인증, 자동 업데이트 및 더 풍부한 AI 워크 플로우의 도어를 열 수있는 도구 세트 액세스를 얻을 수 있습니다.
또한 읽기 전용 모드로 도구 액세스를 사용자 정의하고 동적 도구 세트로 AI 워크 플로를 간소화하며 GitHub Copilot을 사용하여 에이전트 간 협업을 준비하는 방법을 배웁니다.
그러나 먼저 호스팅 된 서버로 전환하는 이유는 무엇입니까?
오픈 소스 MCP 서버를 로컬로 운영하는 것은 작동하지만 숨겨진 비용이 발생합니다. 원격으로 갈 때 변경 사항은 다음과 같습니다.
로컬 도커 서버 | 호스팅 된 MCP 엔드 포인트 |
---|---|
도커 이미지를 유지하고 수동으로 업그레이드하십시오 | Github 패치 및 업그레이드 자동으로 |
개인 액세스 토큰 관리 (PATS) | OAUTH로 한 번 로그인하십시오. 당신을 위해 처리 된 스코프 |
LocalHost에만 서버를 노출시킵니다 | IDE 또는 원격 DEV 상자에서 도달 할 수 있습니다 |
이진을 사용자 정의하지 않는 한 전체 쓰기 액세스 | 내장 된 읽기 전환 및 Toolset 당 플래그 |
공기 갭 환경이 필요한 경우 로컬로 고수하십시오. 대부분의 팀의 경우 호스팅 서버는 인프라 작업을 제거하고 자동화에 집중할 수 있습니다. 그것으로, 다이빙합시다.
시작하기 전에 필요한 몇 가지 사항 :
- Github Copilot 또는 Coplot Enterprise Seat
- 대 코드 1.92+ (또는 다른 MCP 가능 클라이언트)
- 네트워크 액세스
- 실험 할 테스트 저장소
1 단계 : 원격 MCP 서버를 설치하십시오
Github의 원격 MCP 서버 서버를 설정하는 것은 로컬 Docker 기반 설치에 비해 산들 바람입니다. Github가 호스팅하는이 제품은 Docker 컨테이너를 관리하거나 수동으로 업데이트를 처리 할 필요가 없으며, 클라우드 네이티브 경험을 제공합니다.
대 코드 또는 대 코드 내부자에 원격 서버를 설치하는 방법 :
- 명령 팔레트를 열고 실행하십시오.
> GitHub MCP: Install Remote Server
- 완료 Oauth 흐름 GitHub 계정을 연결하려면.
- 설정을 완료하도록 서버를 다시 시작하십시오.
다른 고객을 위해
서버 URL을 다음으로 설정합니다.
그런 다음 프롬프트되면 인증하십시오.
빠른 점검으로 연결을 확인하십시오
curl -I healthz
# HTTP/1.1 200 OK
당신이 보면 200 OK
당신은 갈 수 있습니다.
일단 설치되면 원격 서버가 로컬 서버를 대체하고 롤 준비가됩니다. 이는 더 이상 Docker 나 토큰이 아니라 간단한 통합 일뿐입니다.
2 단계 : 액세스 컨트롤을 구성합니다
안전한 탐색을 위해 읽기 전용 모드를 사용하십시오.
민감한 환경에서 일합니까? 생산 테스트? 이해 관계자에게 시연? 서버를 읽기 전용 모드로 뒤집습니다.
{
"servers": {
"github": {
"type": "http",
"url": "",
"mode": "read-only"
}
}
}
에이전트는 문제, 요청을 당기고 코드를 읽을 수 있지만 변경 사항을 푸시 할 수는 없습니다. 위험없이 컨텍스트를 원하는 코드 리뷰에 적합합니다.
유스 케이스 : 요청 뷰어를 당기십시오
아무것도 수정하지 않고 풀 요청을 검토해야합니까? 이 설정은 안전하고 읽기 전용 액세스를 제공합니다. 변경 사항을 탐색하거나 의견을 남기거나 코드 변경 위험없이 컨텍스트 수집에 적합합니다.
- Github MCP 서버 리포지토리로 이동하십시오.
- “원격 서버”섹션으로 이동하십시오.
- 선택하십시오 요청 읽기 전용을 당기십시오 변종.
- 딸깍 하는 소리 읽기 만 설치하십시오.
이제와 같은 도구를 볼 수 있습니다 listPullRequests
,,, getPullRequest
그리고 searchPullRequests
그러나 쓰기 액세스가 없습니다. 이러한 도구가 변경되지 않기 때문에 코드는 원활한 경험을위한 권한 프롬프트를 건너 뜁니다.
3 단계 :이 세 가지 실무 예제로 시도해보십시오.
Copilot 에이전트 모드가 실제로 어떻게 작동하는지보고 싶습니까? 이 실제 예제는 로컬 설정 또는 수동 파기가 필요하지 않고 풀 요청 관리, 디버깅 워크 플로우 및 보안 경보를 위반하는 일상 개발자 작업을 처리 할 수있는 방법을 보여줍니다. 그냥 프롬프트하고 가십시오.
예 1 : 코드 소유자 파일 추가 및 풀 요청을 엽니 다.
- 레포를 엽니 다 ➜ Coplot 에이전트에게 문의하십시오.
- 에이전트 프롬프트 :
"Add a CODEOWNERS file for /api/** assigning @backend-team, then open a draft pull request."
- 에이전트는 :
- 사용
repos.create_file
코드 소유자 파일을 추가합니다. - 부르다
pull_requests.open
풀 요청을 생성합니다. - 실행하다
pull_requests.request_reviewers
리뷰어를 할당합니다.
로컬 복제, 수동 파일 생성이 없습니다. 그냥 프롬프트하고 선박.
예제 2 : 실패한 워크 플로를 디버깅합니다
즉각적인: “왜 release.yml
어젯밤에 직업 실패?”
에이전트는 로그를 가져옵니다 actions.get_workflow_run_logs
스택 추적을 분석하고 수정을 제안합니다. 선임 엔지니어가 CI/CD 실패를 검토하는 것과 같습니다.
예 3 : 심사 보안 경고
즉각적인: “모든 저장소에서 중요한 의존 경고를 나열하고 각각에 대한 문제를 만듭니다.”
서버는 경고를 통해 경고를 반환합니다 dependabot.list_dependabot_alerts
그런 다음 에이전트는 필요한 경우에만 집중된 문제를 만듭니다.
4 단계 : GitHub 원격 MCP 서버로 팁 문제 해결 팁
징후 | 아마도 원인 | 고치다 |
---|---|---|
401 무단 설치시 | 나머지 GITHUB_TOKEN Env |
var 및 rerun oauth 흐름을 설정하지 마십시오 |
도구가 나타나지 않습니다 | 기업 프록시 블록 api.githubcopilot.com |
프록시 설정을 추가하거나 도메인을 허용합니다 |
모델 시간 아웃 | 큰 도구 세트가 활성화되었습니다 | 필요한 도구 세트로만 제한하십시오 |
전체 MCP 서버에는 70 개가 넘는 도구가 포함되어 있으며 강력하지만 귀하와 AI 모델 모두를 압도 할 수 있습니다.
그것이 동적 도구 세트가 들어오는 곳입니다.
작동 방식 :
- LLM은 몇 가지 메타 툴로 시작합니다.
listAvailableToolsets
,,,enableToolset
그리고getToolsetTools
- 당면한 작업을 결정합니다 (예 : “풀 요청으로 작업”).
- 해당 작업에 필요한 도구 만 가져오고 가능합니다.
- vs 코드는 공구 변경 알림을 통해 자동으로로드합니다.
이렇게하면 인터페이스 (및 AI)가 집중적이고 효율적으로 유지됩니다.
6 단계 : 보안 및 에이전트 워크 플로의 다음 단계
GitHub MCP 서버는 적극적으로 진화하고 있습니다. 다음에 오는 것은 다음과 같습니다.
MCP의 비밀 스캐닝
곧 MCP 서버는 Github이 풀 요청에서 비밀을 추진하지 못하게하는 것처럼 AI 생성 비밀을 감지하고 차단합니다. 필요한 경우 재정의 할 수 있지만 기본값은 신속한 주입 또는 우발로 데이터를 보호합니다.
Copilot에 문제를 할당합니다
Copilot의 코딩 에이전트와 직접 통합하면 다음을 수행 할 수 있습니다.
- Copilot에 직접 문제를 할당하십시오.
- VS 코드에서 완료를 트리거합니다.
- 에이전트 대 에이전트 워크 플로가 도구를 통해 전개되는 것으로보십시오.
미래는 에이전트와 협력하는 에이전트이며, Github MCP가 기초입니다.
기여하고 싶습니까?
Github MCP 프로젝트는 완전히 오픈 소스이며 빠르게 성장하고 있습니다.
REPO를 탐색하십시오 : 도구가 어떻게 구축되고 자신의 기여를하는지 확인하십시오.
📌 파일 문제 : 프로토콜 및 툴링 형성에 도움이됩니다.
📌 토론에 참여 : Github 및 Discord의 다른 빌더와 연결하십시오.
도구를 구축하거나 피드백 제공 또는 AI 구동 개발을 탐구하든 MCP 생태계에는 귀하를위한 장소가 있습니다.
배송 준비가 되셨습니까?
GitHub 원격 MCP 서버는 인프라 오버 헤드를 제거하여 더 나은 자동화를 구축하는 데 집중할 수 있습니다. 더 이상 Docker Babysitting, 더 이상 토큰 회전도없고 Oauth 만 한 번만 배송을 시작하십시오.
기억하십시오 : 최고의 인프라는 관리 할 필요가없는 인프라입니다.
시작하려면 전체 문서를 읽거나 위의 예제로 뛰어 들어 오늘 실험을 시작하십시오.
우리 가이드를 읽으십시오 안전하고 확장 가능한 원격 MCP 서버를 구축합니다
작성자가 작성했습니다
Post Comment