MCP 서버에 Genie Code 연결

Genie Code는 모델 컨텍스트 프로토콜(MCP) 서버와 구글 드라이브, 지메일, 구글 캘린더, Microsoft 365, 아틀라시안, 글린, 슬랙, GitHub 등 네이티브 커넥터를 통해 외부 도구, 문서, 데이터에 연결됩니다. 일반적인 SaaS 원본에 네이티브 커넥터를 사용하거나 작업 영역에서 고유한 외부 또는 사용자 지정 MCP 서버를 추가합니다. Genie Code 설정에서 사용하도록 설정할 도구를 선택합니다.

MCP란?

MCP는 에이전트를 도구, 리소스, 프롬프트 및 기타 컨텍스트 정보에 연결하는 오픈 소스 표준입니다. MCP는 프롬프트 또는 지침에 직접 해당 컨텍스트를 포함하지 않고도 도구, 데이터 및 워크플로를 Genie Code에 노출하는 표준화된 방법을 제공합니다.

MCP는 중요한 컨텍스트가 이미 있지만 Genie Code와 같은 에이전트에서 액세스하기 어려운 경우를 위해 설계되었습니다. MCP는 다음과 같은 컨텍스트에 대한 액세스 권한을 Genie Code에 제공하는 안전한 방법을 제공합니다.

  • 설명서 시스템: Teams는 종종 Confluence와 같은 도구에서 Runbook 또는 운영 문서를 유지합니다. 섹션을 프롬프트에 복사하는 대신 외부 MCP 서버를 통해 해당 콘텐츠를 한 번 노출하고 관련된 경우 참조할 수 있습니다. 또한 문서는 이미 Databricks에 AI Search 인덱스로 있을 수 있으며, Genie Code는 관련 문서를 쿼리하는 데 사용할 수 있습니다.
  • 도구 및 서비스: 플랫폼 팀은 설치, 유효성 검사 또는 배포를 위해 API 또는 스크립트를 유지 관리할 수 있습니다. MCP는 이러한 기능을 Genie Code에서 직접 사용할 수 있도록 합니다.
  • 데이터 원본: Databricks에 데이터가 이미 있는 경우 Genie Code를 Genie 에이전트에 연결하여 자연어를 사용하여 데이터를 분석할 수 있습니다. Databricks 외부에 저장된 데이터의 경우 외부 MCP 서버를 통해 Genie Code에 보안 액세스 권한을 부여할 수 있습니다.
  • 사용자 지정 앱: Databricks 앱을 통해 호스팅되는 사용자 지정 기능을 추가할 수도 있습니다. 이를 통해 Databricks 작업 영역 내에서 안전하게 관리되는 사용자 또는 조직을 위해 특별히 빌드된 독점 도구, 워크플로 또는 통합에 Genie Code를 연결할 수 있습니다.

이러한 경우 MCP는 수동 복사 붙여넣기를 구조화된 재사용 가능한 접근 방식으로 대체하여 필요한 경우에만 올바른 컨텍스트를 사용할 수 있도록 합니다.

사용할 수 있는 권한이 있는 작업 영역의 MCP 서버에 Genie Code를 연결할 수 있습니다. 작업 영역 관리자는 사용 가능한 서버를 제어하는 반면 사용자는 필요에 따라 승인된 원본 중에서 선택할 수 있습니다.

Databricks의 MCP 서버에 대해 더 알고 싶다면, MCP 및 에이전트 도구를 참조하세요.

타사 데이터 원본에 네이티브 커넥터 사용

Genie Code는 일반적인 기업용 데이터 소스에 대한 내장 커넥터를 제공합니다:

  • 구글 드라이브: 구글 문서, 시트, 슬라이드를 검색하고 생성; 생성한 문서를 편집하세요.
  • Gmail: 이메일을 검색, 읽기, 작성하세요.
  • 구글 캘린더: 캘린더 이벤트를 검색하고 생성하세요.
  • Microsoft 365: SharePoint, Teams, Outlook, 캘린더 검색; Outlook 이메일 초안 작성.
  • Atlassian: Jira와 Confluence를 검색하고 업데이트하세요.
  • Glean (베타): Glean을 사용해 조직 내 연결된 앱 전체를 검색하세요.
  • 슬랙: 슬랙 메시지와 채널을 검색하고 메시지를 보내세요.
  • GitHub: 저장소, 이슈, 풀 리퀘스트를 검색하고 업데이트할 수 있습니다.

이러한 데이터 소스에 연결하면 Genie Code가 문서를 검색하고 관련 도구에서 질문에 답할 때 행동을 할 수 있습니다. 각 사용자는 개별적으로 인증하고 OAuth 토큰은 사용자 간에 공유되지 않습니다.

이 연결들은 Databricks에서 제공하는 MCP 커넥터를 사용하므로 서버를 호스팅하거나 OAuth 앱을 등록할 필요가 없습니다. Azure Databricks는 Unity Catalog와 Unity Gateway를 통해 모든 연결을 관리합니다. 게이트웨이는 각 도구 호출을 Unity 카탈로그 권한에 대해 승인하고, 내장된 정책과 승인 요구사항을 적용하며, 사용 및 감사 로그를 시스템 테이블에 기록합니다. 외부 MCP 서버 등록을 참조하세요.

타사 데이터 원본을 연결하려면 다음을 수행합니다.

  1. 작업 영역에서 Sparkle 지니 코드 아이콘을 클릭합니다. 오른쪽 위 모서리에 있는 지니 코드로 채팅을 엽니다.
  2. 프롬프트 표시줄에서 새로 만들기 아이콘 을 클릭합니다. 더하기 아이콘입니다.
  3. 연결하려는 데이터 원본 옆에 있는 연결을 클릭합니다.
  4. 로그인 단계를 완료합니다.

인증 후 Genie Code는 질문에 대답할 때 문서를 검색할 수 있습니다. Metastore 관리자 및 연결 소유자는 연결에 대한 사용자 권한을 관리하거나 해지할 수 있습니다. 4 단계를 참조하세요. MCP 서비스 접근 권한을 부여합니다.

메모

데이터 원본 툴이 항상 자동으로 트리거되지는 않습니다. 문서 검색이 시작되지 않으면 "Google Docs 사용" 또는 "SharePoint 사용" 등의 도구를 사용하도록 Genie Code에 명시적으로 묻는 메시지를 표시합니다.

다른 데이터 원본을 연결하려면 수동으로 Genie Code에 추가합니다. 수동으로 Genie Code에 MCP 서버 추가를 참조하세요.

예약된 작업 및 인증

  • Genie Code는 연결 인증이 만료될 때 경고하지 않습니다. 툴 호출이 실패하거나 연결 목록을 열어야만 알 수 있습니다. 다시 인증하여 해결합니다.
  • 연결 권한을 변경하려면 각 사용자가 재인증을 해야 합니다. 연결이 사용되는 예약된 작업은 사용자가 재인증할 때까지 실패합니다.

Google 드라이브 제한 사항

  • Google 드라이브에 권한을 부여할 때 "확인되지 않은 앱" 화면이 표시될 수 있습니다. 고급을 클릭하고 권한 부여 프로세스를 계속합니다.
  • 최대 파일 크기는 25MB입니다.
  • 네이티브 Google 작업 영역 파일(문서, 시트, 슬라이드)만 지원됩니다. PDF, 이미지 및 기타 이진 형식은 지원되지 않습니다.
  • Genie Code는 Google 문서, 시트, 슬라이드를 생성하고, 커넥터를 통해 생성된 Google Docs를 편집할 수 있습니다. 커넥터 외부에서 생성된 문서나 기존 시트, 슬라이드를 편집할 수 없습니다.
  • 아주 큰 문서를 읽는 것은 느릴 수 있습니다.

메모

Google Workspace API에서 받은 원시 또는 파생 사용자 데이터의 사용 및 전송은 제한된 사용 요구 사항을 포함하여 Google API 서비스 사용자 데이터 정책을 준수합니다.

Gmail 제한 사항

  • Genie Code는 이메일을 검색, 읽기, 작성할 수 있지만, 이메일을 보내거나 기존 메시지를 편집할 수는 없습니다.
  • Genie Code는 Drive 파일을 기본 Gmail 첨부파일로 추가할 수 없습니다. 임시 방편으로, 이메일 본문에 파일 링크를 포함하세요.

Microsoft 365의 한계

  • SharePoint, Teams, Outlook 및 일정을 포함합니다.
  • Genie Code는 Outlook 이메일 초안을 작성할 수 있지만 보낼 수는 없습니다.
  • SharePoint 파일의 최대 파일 크기는 25MB입니다.
  • 지원되는 SharePoint 파일 유형에는 Office 문서(.docx, .xlsx, .pptx)뿐만 아니라 , , .csv.json.md, , 기타 등 일반적인 텍스트 기반 형식.txt도 포함됩니다. PDF, 이미지 및 기타 이진 형식은 지원되지 않습니다.

Glean (베타) 제한 사항

  • Glean은 검색 전용입니다. 직접 링크에서 문서를 읽을 수 없습니다.
  • 메타스토어 관리자는 비관리자 사용자가 연결을 사용할 수 있도록 Glean 테넌트 ID를 먼저 설정해야 합니다. 관리자는 Glean에 처음 연결할 때 테넌트 ID를 입력할 수 있습니다.
  • 특정 Glean MCP 서버에 연결하기 위해 메타스토어 관리자는 연결을 설정할 때 선택적으로 MCP 서버 경로(예: /mcp/eng)를 설정할 수 있습니다. 기본 경로()를 사용하려면 이 필드를 비워두세요./mcp/default 비관리자 사용자는 Glean MCP 서버 경로를 지정하거나 변경할 수 없습니다.

여유 제한

  • Genie Code는 메시지를 보낸 후 편집하거나 삭제할 수 없습니다.

GitHub 제한 사항

  • 쓰기는 파일 내용, 이슈, 풀 요청으로 제한됩니다.
  • 기본적으로 Databricks GitHub MCP 커넥터는 공용 리포지토리에만 액세스할 수 있습니다. 커넥터에 프라이빗 엔터프라이즈 리포지토리에 대한 읽기 권한을 부여하려면 GitHub 조직 관리자가 추가 설정을 완료해야 합니다. 프라이빗 리포지토리 액세스 사용을 참조하세요.
  • GitHub Enterprise Server(자체 호스팅 버전의 GitHub)는 지원되지 않습니다.

수동으로 Genie Code에 MCP 서버 추가

MCP 서버에 Genie Code를 연결하려면 지니 코드 설정에 추가합니다.

  1. 지니 코드 설정을 엽니다. 지니 코드 창에서 기어 아이콘 을 클릭합니다. 설정.
  2. MCP 서버에서 새로 만들기 아이콘을 클릭합니다. 서버를 추가합니다.
  3. 추가하려는 MCP 서버를 선택합니다. Databricks 관리형 MCP 서버 또는 외부 MCP 서버를 선택할 수 있습니다.
    • Unity 카탈로그 함수: 함수에 대한 스키마를 선택합니다. 이를 통해 Genie Code는 함수를 사용하여 미리 정의된 SQL 쿼리를 실행할 수 있습니다.
    • AI 검색: 인덱스 스키마를 선택합니다. 이를 통해 Genie Code는 AI Search 인덱스를 쿼리하여 관련 문서를 찾을 수 있습니다.
    • 지니 에이전트: 지니 에이전트를 선택합니다. Genie MCP는 Genie를 도구로 호출하여 Genie 에이전트를 쿼리하여 자연어를 사용하여 데이터를 분석할 수 있도록 합니다.
    • 외부 MCP 서버: 외부 MCP 서버로 사용할 Unity 카탈로그 연결을 선택합니다. 연결을 사용하려면 먼저 연결에 로그인해야 합니다.
    • 사용자 지정 MCP 서버: 사용자 지정 MCP 서버로 사용할 Databricks 앱을 선택합니다. 이렇게 하면 사용자 지정 정의 도구를 사용할 수 있습니다. 다음 요구 사항이 적용됩니다.
      • 앱을 연결하려는 작업 영역과 동일한 작업 영역에 배포해야 합니다.
      • MCP 서버에 https://<server-url>/mcp에서 액세스해야 합니다.
      • 앱은 상태를 저장하지 않아야 합니다. 예를 들어, mcp_app = mcp_server.http_app(stateless_http=True)을(를) 설정하십시오.
      • CORS 오류가 발생하면 앱의 허용된 원본 목록에 작업 영역 URL을 추가해야 할 수 있습니다. 예를 들어, app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"])을(를) 설정하십시오.
  4. 저장을 클릭합니다.

추가된 후에는 MCP 서버를 Genie Code에서 즉시 사용할 수 있습니다. 프롬프트 또는 지침을 변경하지 않고 사용을 시작할 수 있습니다. Genie Code는 필요한 경우 이 서버들을 자동으로 활용합니다.

Genie Code 설정에서 사용하거나 사용하지 않도록 설정할 도구와 서버를 선택할 수 있습니다.

Limitations

연결된 애플리케이션에 대한 준수 지침은 Databricks가 제공하는 MCP 서비스 제한을 참조하세요.

  • Last updated on