將 Genie Code 連接到 MCP 伺服器

Genie Code 透過模型情境協定（MCP）伺服器及原生連接器連接外部工具、文件與資料，支援 Google Drive、Gmail、Google 日曆、Microsoft 365、Atlassian、Glean、Slack 及 GitHub。 使用原生連接器連接常見的 SaaS 來源，或從工作區新增自己的外部或自訂 MCP 伺服器。 你可以在 Genie Code 設定中選擇要啟用哪些工具。

什麼是MCP？

MCP 是一個開放原始碼標準，連結代理與工具、資源、提示詞及其他情境資訊。 MCP 提供一種標準化的方式，讓工具、資料和工作流程暴露於 Genie Code 中，而不必直接將該上下文嵌入提示或指令中。

MCP 是為那些重要上下文已經存在但代理難以存取的情況設計的，例如 Genie Code。 MCP 提供一種安全的方式，讓 Genie Code 存取上下文，例如以下內容：

  • 文件系統：團隊通常會將跑程簿或作業文件保存在像 Confluence 這類工具中。 與其將部分段落複製到提示中，內容可以透過外部 MCP 伺服器一次性公開，並在必要時引用。 你的文件也可能已經存在 Databricks 的 AI 搜尋索引中，Genie Code 可以用來查詢相關文件。
  • 工具與服務：平台團隊可能會維護用於設定、驗證或部署的 API 或腳本。 MCP 將這些功能直接提供給 Genie Code。
  • 資料來源：如果你已經在 Databricks 裡有資料，你可以將 Genie Code 連接到 Genie 代理程式，幫助你用自然語言分析資料。 對於儲存在 Databrick 外部的資料，你可以透過外部 MCP 伺服器給予 Genie Code 安全存取權限。
  • 自訂應用程式：你也可以透過 Databricks 應用程式新增自訂功能。 這讓你能將 Genie Code 與專為你或你的組織打造的專有工具、工作流程或整合連結，且全部在你的 Databricks 工作區內安全管理。

在這些情況下，MCP 以結構化且可重複使用的方法取代手動複製貼上，僅在需要時提供正確的上下文。

你可以將 Genie Code 連接到你工作區中任何你有權限使用的 MCP 伺服器。 工作區管理員可控制可用的伺服器，而使用者則可依需求從這些核准來源中選擇。

想了解更多關於 Databricks 中的 MCP 伺服器以及如何建立自己的伺服器，請參閱 MCP 與代理工具。

使用原生連接器來接收第三方資料來源

Genie Code 提供常見企業資料來源的內建連接器：

  • Google 雲端硬碟：搜尋並建立 Google 文件、試算表和投影片;編輯它建立的文件。
  • Gmail：搜尋、閱讀並草擬電子郵件。
  • Google 行事曆：搜尋並建立行事曆事件。
  • Microsoft 365：搜尋 SharePoint、Teams、Outlook 和行事曆;草擬 Outlook 電子郵件。
  • Atlassian：搜尋並更新 Jira 和 Confluence。
  • Glean （測試版）：使用 Glean 搜尋您組織內所有連接的應用程式。
  • Slack：搜尋 Slack 訊息和頻道，並發送訊息。
  • GitHub：搜尋並更新存放庫、議題和提取要求。

連接這些資料來源後，Genie Code 能搜尋您的文件，並在連線工具中回答問題時採取行動。 每位使用者個別認證，且 OAuth 代幣不會在使用者間共享。

這些連線使用 Databricks 提供的 MCP 連接器，因此沒有伺服器要架設，也沒有 OAuth 應用程式需要註冊。 Azure Databricks 透過 Unity Catalog 和 Unity Gateway 管理所有連線。 閘道會授權每次工具呼叫以符合你的 Unity Catalog 權限，套用內建政策與核准要求，並在系統資料表中記錄使用與稽核日誌。 參見 「註冊一個外部 MCP 伺服器」。

要連接第三方資料來源：

  1. 在你的工作區，點選 Sparkle 精靈代碼圖示。 右上角的精靈代碼可以開啟聊天室。
  2. 在提示欄中，點選 新圖示。 就是加號圖示。
  3. 在你想連接的資料來源旁邊，點選 「連接」。
  4. 完成登入步驟。

認證後，Genie Code 可以在回答問題時搜尋你的文件。 Metastore 管理員和連線擁有者可以管理或撤銷該連線的使用者權限。 請參見 步驟 4。授權存取 MCP 服務。

備註

資料來源工具不一定會自動觸發。 如果文件搜尋無法啟動，試著明確提示 Genie Code 使用該工具，例如「使用 Google 文件」或「使用 SharePoint」。

若要連接其他資料來源，請手動將它們加入 Genie Code。 請參見 手動將 MCP 伺服器加入 Genie Code。

排程任務與認證

  • Genie Code 不會在連線認證過期時警告你。 你可能只有在工具呼叫失敗或打開連線清單時才會知道。 重新驗證以解決問題。
  • 更改連線權限需要每位使用者重新認證。 使用該連線的排程任務會失敗，直到使用者重新認證。

Google 雲端硬碟的限制

  • 授權 Google Drive 時，你可能會看到「未驗證應用程式」的畫面。 點擊 進階 ，繼續授權流程。
  • 檔案大小上限為 25 MB。
  • 只支援原生的 Google Workspace 檔案（文件、試算表、投影片）。 不支援 PDF、圖片及其他二進位格式。
  • Genie Code 可以建立 Google 文件、試算表和投影片，並透過連接器編輯它建立的 Google 文件。 它無法編輯在連接器外建立的文件，也無法編輯現有的試算表或投影片。
  • 閱讀一份非常龐大的文件可能會很慢。

備註

從 Google Workspace API 收到的原始或衍生用戶資料的使用與轉移，將遵守 Google API 服務的使用者資料政策，包括有限使用要求。

Gmail 限制

  • Genie Code 可以搜尋、閱讀和草擬電子郵件，但無法發送電子郵件或編輯現有訊息。
  • Genie Code 無法將 Drive 檔案新增為原生的 Gmail 附件。 作為一個變通方法，可以在郵件正文中附上檔案連結。

Microsoft 365 限制

  • 包含 SharePoint、Teams、Outlook 和行事曆。
  • Genie Code 可以草擬 Outlook 電子郵件，但無法發送。
  • SharePoint 檔案的最大檔案大小為 25 MB。
  • 支援的 SharePoint 檔案類型包括 Office 文件（.docx、.xlsx、.pptx），以及常見的文字格式，如 .txt、 .csv、 .json.md、 、 及其他。 不支援 PDF、圖片及其他二進位格式。

Glean（測試版）限制

  • Glean 只支援搜尋。 它無法從直接連結讀取文件。
  • 中繼存放區管理員必須先設定 Glean 租用戶 ID，之後非管理員使用者才能使用此連線。 管理員在首次連接 Glean 時可以輸入租戶 ID。
  • 要連接特定的 Glean MCP 伺服器，元儲存管理員可在設定連線時選擇性地設定 MCP 伺服器路徑（例如 /mcp/eng）。 此欄位留空以使用預設路徑（/mcp/default）。 非管理員使用者無法指定或更改 Glean MCP 伺服器路徑。

Slack 限制

  • Genie Code 無法在發送訊息後編輯或刪除。

GitHub 限制

  • 寫入權限僅限於檔案內容、問題和拉取請求。
  • 預設情況下，Databricks GitHub MCP 連接器只能存取公開的倉庫。 要讓連接器有讀取權限存取您的私人企業倉庫，GitHub 組織管理員必須完成額外的設定。 請參見 啟用私人儲存庫存取。
  • GitHub Enterprise Server（GitHub 的自架版本）不被支援。

手動將 MCP 伺服器加入 Genie Code

要將 Genie Code 連接到 MCP 伺服器，請在你的 Genie Code 設定中新增：

  1. 打開 Genie Code 設定。 在精靈代碼選區，點擊 齒輪圖示。 設定。
  2. 在 MCP 伺服器中，點選 新圖示。 新增伺服器。
  3. 選擇你想新增的 MCP 伺服器。 您可以選擇 Databricks 管理的 MCP 伺服器或外部 MCP 伺服器：
    • Unity 目錄函式：選擇函式的結構。 這使得 Genie Code 能利用函式執行預設的 SQL 查詢。
    • AI 搜尋：選擇索引的結構。 這讓 Genie Code 能夠查詢 AI 搜尋索引以尋找相關文件。
    • 精靈代理人：選擇精靈代理人。 Genie MCP 以 Genie 為工具，讓你能查詢 Genie 代理，利用自然語言分析資料。
    • 外部 MCP 伺服器：選擇 Unity 目錄連線作為外部 MCP 伺服器使用。 你必須先登入該連線才能使用。
    • 自訂 MCP 伺服器：選擇 Databricks 應用程式 作為自訂 MCP 伺服器使用。 這讓你可以使用任何自訂的工具。 適用以下要求：
      • 你的應用程式必須部署在與你嘗試連接至其的同一個工作區中。
      • MCP 伺服器必須從 https://<server-url>/mcp 被存取。
      • 你的應用程式必須是無狀態的。 例如，設定 mcp_app = mcp_server.http_app(stateless_http=True)。
      • 如果你遇到 CORS 錯誤，可能需要將工作區網址加入應用程式允許的來源清單。 例如，設定 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