GitHub OAuth 앱 등록

1. Developer Settings 접속

1. https://github.com/settings/developers 접속
2. GitHub 계정 (또는 Organization owner 계정) 으로 로그인
3. 좌측 메뉴 → OAuth Apps → New OAuth App

2. 앱 정보 입력

• Application name: 예) "MCP Hub Integration"
• Homepage URL: https://mcp-hub.wrks.ai
• Application description: 사내 AI 에이전트가 GitHub 를 도구로 사용
• Authorization callback URL: https://mcp-hub.wrks.ai/oauth/callback

3. Client Secret 발급

• 생성 완료 후 앱 상세 화면
• Client ID 확인 (즉시 복사 가능)
• Generate a new client secret 클릭 → 생성된 값은 최초 1회만 표시 — 즉시 복사

4. 조직 저장소 접근 승인 (조직 소유 저장소 사용 시)

개인 저장소만 접근하면 이 단계는 생략. 조직 저장소도 접근해야 한다면 owner 계정에서:

• https://github.com/organizations/{org}/settings/oauth_application_policy
• 등록한 OAuth App 을 Approved 상태로 변경
• Third-party access 정책이 'Restricted' 인 조직은 이 승인 없이는 API 호출이 실패함

5. Scope 선택

Studio 툴킷 설정 화면에서 요청할 scope:

• repo — 저장소 전체 접근 (private 포함)
• read:org — 조직 · 팀 조회
• read:user — 로그인 사용자 프로필
• workflow — GitHub Actions workflow 수정
• notifications — 알림 조회 · 관리

6. Studio 툴킷 설정

• Studio → Toolkits → New → 'GitHub' 템플릿 선택
• OAuth 설정 화면에 Client ID · Client Secret 입력
• 저장 후 사용자 로그인 시 위 scope 동의 화면이 뜸

참고

• Scope 전체 목록: https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps
• 주의: repo scope 는 private repo 전체 (읽기 · 쓰기 · 관리) 접근 권한이므로 최소권한 원칙상 과할 수 있음. 세밀한 권한이 필요하면 GitHub App (fine-grained permissions) 방식이 있으며, 이는 v2 별도 템플릿으로 지원 예정.