Genie Code를 사용하여 GitHub 코드 검색

Genie Code는 native Databricks GitHub 커넥터 또는 custom GitHub MCP 서버 통해 연결할 때 GitHub 리포지토리를 검색할 수 있습니다. 대부분의 경우 네이티브 커넥터를 사용합니다. 프라이빗 리포지토리 액세스에는 GitHub 조직 관리자가 Databricks GitHub 커넥터 앱을 설치해야 합니다.

네이티브 커넥터 사용(권장)

Important

이 기능은 베타 버전으로 제공됩니다. 타사 데이터 원본 커넥터를 사용하려면 작업 영역 관리자가 에이전트용 타사 커넥터 미리 보기를 사용하도록 설정해야 합니다. Azure Databricks 미리 보기 관리를 참조하세요.

Genie One 또는 Genie Code를 GitHub 연결하려면 Databricks 타사 커넥터를 사용합니다. 타사 데이터 원본에 네이티브 커넥터 사용 및 외부 도구 및 원본에 연결 참조 프라이빗 리포지토리의 경우 관리자는 액세스를 사용하도록 설정해야 합니다.

프라이빗 리포지토리 액세스 사용

GitHub 대한 기본 Databricks 시스템 연결은 공용 리포지토리에만 액세스할 수 있습니다. 연결에 프라이빗 엔터프라이즈 리포지토리에 대한 읽기 권한을 부여하려면 GitHub 조직 관리자가 다음 단계를 완료해야 합니다.

  1. 개인 리포지토리에 대한 읽기 권한이 있도록 GitHub 조직에 Databricks GitHub 커넥터 앱 설치합니다.

  2. 작업 영역의 클라우드 및 지역에 대한 Databricks 서버리스 아웃바운드 IP를 허용 목록에 추가합니다. IP 주소 목록은 Azure Databricks 서비스 및 자산에 대한 IP 주소 및 도메인 참조하세요. GitHub 조직에 허용되는 IP 주소를 구성하는 방법에 대한 지침은 조직의 허용된 IP 주소 관리 참조하세요.

관리자 설정이 완료되면 조직의 사용자는 기본 Databricks 시스템 연결을 사용하여 프라이빗 리포지토리에 액세스할 수 있습니다.

Databricks 작업 영역에 사용할 수 있는 GitHub Unity 카탈로그 연결이 이미 있는 경우 이 섹션을 건너뜁니다. 공용 리포지토리 및 사용자 계정의 정보에만 액세스해야 하는 경우 3단계로 건너뜁니다.

아래 단계에 따라 사용자 지정 GitHub MCP 서버를 만듭니다. 이렇게 하면 특정 데이터 및 보안 요구 사항에 맞게 서버를 구성할 수 있습니다.

  1. GitHub 계정에서 GitHub 앱을 만듭니다. 엔터프라이즈 코드베이스의 경우 GitHub 조직 관리자가 이 단계를 완료해야 합니다.

    • 프로파일 > 설정 > 개발자 설정 > GitHub 앱로 이동하고 새로운 GitHub 앱 클릭합니다.
    • 요청된 필드를 채웁니다. 콜백 URL은 .이어야 https://<your-databricks-workspace-url>/login/oauth/http.html합니다. GitHub Databricks 작업 영역에서 인증하는 방법입니다.
      • 홈페이지 URL은 MCP 서버에 영향을 주지 않으며 원하는 값으로 설정될 수 있습니다.
      • 웹후크 URL을 선택적 필드로 만들려면 "활성" 상자의 선택을 취소합니다.
    • GitHub 앱에 리포지토리 및 조직에 액세스하는 데 필요한 권한을 부여합니다.
    • GitHub 앱 만들기를 클릭합니다.

  2. 새로 만든 앱의 클라이언트 비밀에서 새 클라이언트 암호 생성을 클릭합니다. 이 값을 복사합니다.

  3. GitHub 대한 새 Unity 카탈로그 연결을 만듭니다. CREATE CONNECTION 권한이 있어야 합니다.

    • 작업 영역에 이미 설치되어 있는 경우, USE CONNECTION 권한이 있는 한 기존 것을 사용할 수 있습니다.
    • 다음 필드를 입력합니다.
      • 연결 유형: HTTP
      • 인증 유형: OAuth User to Machine
      • OAuth 공급자: Manual configuration
        • 공용 리포지토리 및 고유한 계정 정보에만 액세스해야 하는 경우 여기를 선택하고 Github MCP 나머지 단계를 건너뜁니다.
      • 호스트: https://api.githubcopilot.com
      • OAuth 범위: 앱의 범위입니다. 예를 들어 mcp:access read:user user:email repo read:org
      • 클라이언트 암호 및 클라이언트 ID: 2단계에서 생성됨
      • 권한 부여 엔드포인트: https://github.com/login/oauth/authorize
      • 토큰 엔드포인트: https://github.com/login/oauth/access_token
      • 기본 경로: /mcp
      • mcp 연결은 다음과 같습니다. checked
    • 을 클릭하여 연결을 만듭니다.

  4. 오른쪽 위 모서리에서 로그인 을 클릭하여 연결에 로그인합니다. 그러면 Databricks 계정에 GitHub 앱에 권한을 부여하라는 새 창이 열립니다. 연결하려는 GitHub 계정에서 connect 클릭합니다.

이제 GitHub MCP를 사용할 준비가 되었습니다. 이를 Genie Code에 외부 MCP 서버로 추가합니다.

  • Last updated on