Genie Code는 native Databricks GitHub 커넥터 또는 custom GitHub MCP 서버 통해 연결할 때 GitHub 리포지토리를 검색할 수 있습니다. 대부분의 경우 네이티브 커넥터를 사용합니다. 프라이빗 리포지토리 액세스에는 GitHub 조직 관리자가 Databricks GitHub 커넥터 앱을 설치해야 합니다.
네이티브 커넥터 사용(권장)
Genie One 또는 Genie Code를 GitHub 연결하려면 Databricks 타사 커넥터를 사용합니다. 타사 소스에 Databricks 제공 MCP 커넥터 사용 및 Genie One을 외부 도구 및 소스와 연결을(를) 참조하세요. 프라이빗 리포지토리의 경우 관리자는 액세스를 사용하도록 설정해야 합니다.
- 네이티브 커넥터는 기본 Databricks 시스템 연결을 사용합니다. 대신 custom GitHub MCP 서버를 사용하려면 수동으로 추가합니다. 수동으로 Genie Code에 MCP 서버 추가를 참조하세요.
- 응답을 개선하려면 각 리포지토리에 대한 개인 컨텍스트를 추가하여 GitHub 검색 도구가 코드베이스를 이해하는 데 도움이 됩니다.
커스텀 GitHub MCP 서버 등록하기(권장하지 않음)
Azure Databricks 작업 공간에 이미 GitHub Unity Catalog MCP 서비스가 있다면 이 섹션은 건너뛰세요. 공개 저장소와 본인 계정 정보에만 접근하면 managed OAuth를 사용하고 Unity 카탈로그 연결을 MCP 서비스로 등록하는 방향으로 건너뛰세요.
아래 단계를 따라 특정 데이터 및 보안 요구에 맞는 맞춤형 GitHub MCP 서버를 MCP 서비스로 등록하세요. 먼저, MCP 서비스가 어떻게 인증하는지 선택하세요:
- 관리형 OAuth: Databricks는 GitHub OAuth 앱과 자격 증명을 관리합니다. 아래의 GitHub 앱과 클라이언트 비밀 단계는 건너뛰고, 연결을 생성할 때 관리되는 공급자를 선택하세요.
- 커스텀 OAuth: 직접 GitHub 앱을 만들고 연결을 만들 때 그 앱 자격 증명을 제공하세요.
GitHub 앱 만들기(사용자 지정 OAuth 전용)
GitHub 앱을 만드세요. 엔터프라이즈 코드베이스의 경우 GitHub 조직 관리자가 이 단계를 완료해야 합니다.
- 프로필 > 설정 > 개발자 설정 > GitHub 앱으로 이동한 다음 새 GitHub 앱을 클릭합니다.
- 요청된 필드를 채웁니다.
콜백 URL은 .이어야
https://<your-databricks-workspace-url>/login/oauth/http.html합니다. GitHub Databricks 작업 영역에서 인증하는 방법입니다.- 홈페이지 URL은 MCP 서버에 영향을 주지 않으며 원하는 값으로 설정할 수 있습니다.
- 활성 확인란의 선택을 취소하여 웹후크 URL을 선택적 필드로 만듭니다.
- GitHub 앱에 리포지토리 및 조직에 액세스하는 데 필요한 권한을 부여합니다.
- GitHub 앱 만들기를 클릭합니다.
새로 만든 앱의 클라이언트 비밀에서 새 클라이언트 암호 생성을 클릭합니다. 이 값을 복사합니다.
Unity 카탈로그 연결을 MCP 서비스로 등록하세요
GitHub용 Unity 카탈로그 HTTP 연결을 생성하거나 재사용하세요. 스키마를 생성하려면 해당 스키마에 대한
CREATE CONNECTION권한이 있어야 합니다. 기존 연결을 재사용할 경우, 해당 연결에 반드시USE CONNECTION이(가) 있어야 합니다. 다음 단계에서는 해당 연결을 MCP 서비스로 등록하는 작업을 계속하세요. 새로운 연결을 위해서는 다음 인증 옵션 중 하나를 사용하세요:- 관리형 OAuth: OAuth User to Machine Per User 인증 유형과 GitHub OAuth 프로바이저를 선택하세요. Databricks는 GitHub 호스트, 기본 경로, OAuth 자격 증명을 제공합니다.
-
커스텀 OAuth: OAuth 사용자-시스템 사용자별 인증 유형과 수동 구성 OAuth 제공자를 선택하세요. 다음 값을 입력합니다.
- 호스트:
https://api.githubcopilot.com - OAuth 범위: 앱의 범위입니다. 예를 들어
mcp:access read:user user:email repo read:org - 클라이언트 비밀과 클라이언트 ID: 위의 GitHub 앱 단계에서 생성됨
- 권한 부여 엔드포인트:
https://github.com/login/oauth/authorize - 토큰 엔드포인트:
https://github.com/login/oauth/access_token - 기본 경로:
/mcp
- 호스트:
- 을 클릭하여 연결을 만듭니다.
HTTP 연결을 사용하는 MCP 서비스를 등록합니다. 필요한 권한은 외부 MCP 서버를 참조하세요.
- Azure Databricks 작업 공간에서 카탈로그로 가서 스키마를 선택한 후 생성>를 클릭하세요.
- MCP 서비스의 카탈로그, 스키마, 이름을 입력하세요.
- 생성하거나 재사용한 HTTP 연결을 선택하고, 노출할 도구를 선택한 후 생성을 클릭하세요.
사용자별 OAuth를 선택했다면, MCP 서비스에 로그인하여 GitHub 계정에 대한 액세스를 승인하세요.
사용자 또는 그룹에 MCP 서비스에 대한
USE CATALOG과 해당 상위 카탈로그 및 스키마에 대한USE SCHEMA및EXECUTE를 부여합니다. 최종 사용자에게USE CONNECTION을(를) 부여하지 마세요. MCP 공유하기를 참조하세요.
귀하의 GitHub MCP 서비스는 사용 준비가 완료되었습니다. Genie Code에 추가하세요