設定連接應用程式

Databricks 提供的外部服務(如 system.ai.github 和 system.ai.slack)的 MCP 會呼叫第三方應用程式。 大多數系統會在每位使用者完成一次性 OAuth 登入後立即運作。 有些還需要管理員先設定第三方應用程式或您的工作空間網路。

本頁說明該管理員設定及在啟用 Databricks 提供的 MCP 前應進行的合規審查。 它與每位使用者在首次呼叫前完成的 OAuth 登入 ,以及每個 MCP 請求的 OAuth 範圍 是分開的。

檢視合規要求

在啟用 Databricks 提供的 MCP 之前,請先檢視它所呼叫的第三方應用程式,並確認該應用程式及您預期的使用符合組織的需求,包括合規要求。

Databricks 提供的 MCP 會將請求(包括其中的資料)傳送給第三方應用程式。 部分請求會轉發至第三方應用程式自有的 MCP 伺服器,例如 Slack、GitHub 和 Atlassian。 其他軟體則運行在 Azure Databricks 上,並呼叫第三方應用程式的 API,例如 Google Drive、Gmail 和 Google 行事曆。 在這兩種情況下,第三方應用程式都會依照自身條款處理這些資料,包括合規性、資料保留及資料駐留政策。 第三方應用程式回傳的資料可供代理程式及其所使用的模型使用。

工具也可以在第三方應用程式中,根據已登入使用者的權限執行動作,例如傳送訊息或建立拉取請求。 若要限制 MCP 能做的事, 請選擇它所暴露的工具並套 用 服務原則。

一般設定

以下步驟適用於每一個 Databricks 提供的 MCP。 完成每一個符合您工作區及第三方應用程式設定的項目。

允許從工作區進行外寄存取

MCP 會將外寄請求路由至您工作空間的無伺服器運算平面。 如果您的工作區使用 無伺服器輸出控制 並將 存取權限設為受限,請將每個 MCP 伺服器的完整網域名稱(FQDN)新增至政策的 允許網域 清單。 有關步驟以及如何尋找每個服務的目的地,請參閱「 工作區至外部 MCP 伺服器」。

在第三方應用程式中允許 Databricks

如果您的組織將傳入第三方應用程式的流量限制為允許的 IP 位址集合,例如 GitHub 組織的 IP 允許清單,請將 Azure Databricks 工作區雲端及區域的無伺服器外發 IP 加入應用程式的允許清單,以便接受來自 Azure Databricks 的通話。 關於 IP 位址列表,請參見 IP 位址與網域,Azure Databricks服務與資產。 如需更多關於 Azure Databricks 無伺服器外發網路的資訊,請參閱 為無伺服器運算存取設定防火牆。

額外的第三方應用程式設定

兩組管理員控制使用者是否能登入連接器,以及連線能做什麼:

  • 提供者管理員:貴組織的 Slack、Google Workspace、Microsoft Entra ID 或 GitHub 管理員決定使用者是否能授權應用程式,以及該應用程式獲得哪些權限,例如 OAuth 範圍或 GitHub 倉庫的存取權。 他們通常不是你的 Azure Databricks 管理員。
  • Azure Databricks 管理員:擁有MANAGE連接器 MCP 權限的使用者決定可用工具及誰可以呼叫它們。 請參見 治理MCP。

如果供應商阻擋登入或限制連接器可存取的權限,請將該供應商的相關步驟分享給其管理員。 管理員批准應用程式後,登出連結器再登入以獲得核准權限。 請參閱 管理提供者登入。

在 Slack 中批准 Databricks Genie 應用程式

如果你的 Slack 工作區需要應用程式核准,Slack 登入畫面會警告該應用程式很可能被封鎖。 Slack 也可能移除管理員未核准的權限。 例如,登入成功,但連接器無法傳送訊息。

Slack Workspace 擁有者或應用程式管理員必須批准 Databricks Genie 應用程式:

  1. 在 Slack 中,點選側邊欄的 Admin。
  2. 選擇 應用程式與工作流程 以開啟 Slack 市集。
  3. 點選 瀏覽,然後搜尋並選擇 Databricks Genie。
  4. 查看所請求的權限並點擊 批准。 「代使用者發送訊息」權限(chat:write)允許使用者透過連接器發送訊息。

如果使用者已經請求該應用程式,Workspace 擁有者或應用程式管理員可以代為批准待處理的請求。 請參閱 「管理您的工作區應用程式審核」。

當 Azure Databricks 對連接器新增權限時,Slack 會再次請求批准。 在新權限未獲批准前,登入失敗或 Slack 會取消該新權限。

當你再次登入時,請檢查 Databricks Genie 在 Slack 登入畫面中可以執行的動作。 清單中應包含「傳送訊息」。 如果連接器仍然無法傳送訊息,請找 Metastore 管理員或其他在 MANAGE 上具有 system.ai.slack 的使用者檢查其工具:

  1. 在 Unity Gateway 中,選擇 MCP 並開啟 system.ai.slack。
  2. 在 總覽中,點選 編輯工具。
  3. 確認發送訊息的工具已被選取,然後點 儲存變更。

請參閱 選擇可用工具。

允許 Google Workspace 中的連接器

如果 Google 登入顯示存取被阻擋錯誤,或顯示管理員的政策阻擋該應用程式,Google Workspace 管理員會限制哪些第三方應用程式可以存取 Google 資料。 Google 雲端硬碟、Gmail 和 Google 日曆連接器使用相同的 Google OAuth 應用程式,因此一個設定涵蓋了這三個應用程式。

擁有服務設定管理員權限的 Google Workspace 管理員必須設定該應用程式:

  1. 在 Google 管理控制台,請前往 安全>存取與資料控制>API 控制。
  2. 點擊 管理應用程式存取。
  3. 對於 已設定的應用程式,請點選 「配置新應用程式」。
  4. 輸入客戶 ID 645306276512-s5jbhbhff6irpdq1fpt2f21pcrf4agqs.apps.googleusercontent.com,點選 搜尋,然後在搜尋結果中點選應用程式。
  5. 對於 範圍,請選擇最頂端的組織單位以設定所有使用者的存取權限,或點選 選擇組織單位 以選擇特定的組織單位。 按一下繼續。
  6. 要存取 Google 資料,請選擇「可信」。 若要只允許連接器請求的範圍,請選擇 特定 Google 資料 ,並新增管理 OAuth 提供者中列出的範圍。 按一下繼續。
  7. 檢視設定並點擊 完成。

應用程式會出現在 已設定的應用程式 清單中,並顯示你選擇的存取權限等級。 請參閱 控制哪些應用程式存取 Google Workspace 資料。

批准 Microsoft 365 權限

Microsoft 365 連接器會在單一同意中請求其所有 Microsoft Graph 權限。 有些,例如 ChannelMessage.Read.All 和 OnlineMeetingTranscript.Read.All,需要管理員同意。 在系統管理員同意該組織之前,使用者會看到 「需要管理員核准」,且無法登入。 完整清單請參見 Microsoft 365 範圍。

可授予全租戶同意的 Microsoft Entra ID 管理員(如雲端應用程式管理員或應用程式管理員)需對所有人同意一次:

  1. 在 Unity Gateway 中,選擇 MCP 並開啟 system.ai.microsoft_365。
  2. 點選「 登入 」並以管理員帳戶登入。
  3. 選取 代表您的組織同意,然後點選 「接受」。

其他使用者接著可以在不會出現同意提示的情況下登入。 當 Azure Databricks 新增權限時,管理員必須再次授與同意。 有關管理員同意的詳細資訊,請參閱 Microsoft 文件中的 「授予整個租戶的應用程式管理員同意」。

為了限制連接器的功能,對 system.ai.microsoft_365 具有 MANAGE 的使用者可以移除其寫入工具。 請參閱 選擇可用工具。 這不會改變同意畫面上的權限。

啟用 GitHub 寫入權限與私人倉庫存取權限

預設情況下,GitHub 連接器system.ai.github()只能讀取公開的倉庫。 若要存取私人儲存庫,或進行如提交檔案、建立 Issue 與提取要求等變更,儲存庫擁有者或 GitHub 組織管理員必須:

  1. 安裝 Databricks 的 GitHub 連接器應用程式,並授權它存取所需的倉庫。

  2. 如果組織使用 IP 允許清單,請為你工作空間的雲端和區域新增 Azure Databricks 的無伺服器輸出 IP。

應用程式安裝完成後,使用者可以透過連接器,在自己的 GitHub 權限內操作已授權的倉庫。