Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Von Databricks bereitgestellte MCPs für externe Dienste wie system.ai.github und system.ai.slack rufen Apps von Drittanbietern auf. Die meisten funktionieren, sobald jeder Benutzer einen einmaligen OAuth-Login abgeschlossen hat. Manche erfordern außerdem, dass ein Administrator zuerst die Drittanbieter-App oder Ihr Arbeitsumfeld konfiguriert.
Diese Seite behandelt die Administrator-Einrichtung und die Compliance-Prüfung, die erforderlich ist, bevor Sie ein von Databricks bereitgestelltes MCP aktivieren. Es ist getrennt von dem pro Nutzer durchgeführten OAuth-Login, das jeder Benutzer vor seinem ersten Aufruf abschließt, sowie von den OAuth-Scopes, die jeder MCP anfordert.
Compliance-Anforderungen überprüfen
Bevor Sie einen von Databricks bereitgestellten MCP aktivieren, überprüfen Sie die Drittanbieter-App, die vom MCP aufgerufen wird, und vergewissern Sie sich, dass die App und Ihre beabsichtigte Nutzung die Anforderungen Ihrer Organisation erfüllen, einschließlich der Complianceanforderungen.
Von Databricks bereitgestellte MCPs senden Anfragen, einschließlich der darin enthaltenen Daten, an Drittanbieter-Apps. Einige leiten Anfragen an den eigenen MCP-Server der Drittanbieter-App weiter, wie Slack, GitHub und Atlassian. Andere laufen auf Azure Databricks und rufen die API der Drittanbieter-App auf, wie Google Drive, Gmail und Google Calendar. In beiden Fällen verarbeitet die Drittanbieter-App diese Daten gemäß ihren eigenen Bedingungen, einschließlich ihrer Richtlinien zur Compliance, Datenaufbewahrung und Datenresidenz. Daten, die die Drittanbieter-App zurückgibt, stehen dem Agenten und dem verwendeten Modell zur Verfügung.
Tools können auch Aktionen in der Drittanbieter-App mit den Berechtigungen des angemeldeten Benutzers ausführen, wie etwa das Senden von Nachrichten oder das Erstellen von Pull-Requests. Um zu begrenzen, was ein MCP tun kann, wählen Sie aus, welche Werkzeuge es bereitstellt , und wenden Sie Servicerichtlinien an.
- Für die App oder API eines Drittanbieters, die von jedem MCP aufgerufen wird, siehe Externe Dienste.
- Für die Berechtigungen, die jeder MCP anfordert, siehe Managed OAuth providers.
- Um zu begrenzen, wer einen MCP verwenden kann, siehe Einen MCP teilen. Wenn Sie begrenzen möchten, welche externen Ziele MCPs erreichen können, lesen Sie Externe Ziele.
Allgemeine Konfiguration
Die folgenden Schritte gelten für jeden von Databricks bereitgestellten MCP. Füllen Sie jeden Schritt aus, der zu Ihrem Arbeitsbereich und der Konfiguration der Drittanbieter-App passt.
Erlauben Sie ausgehenden Zugriff aus Ihrem Arbeitsbereich
MCPs leiten ihre ausgehenden Anfragen über die serverlose Rechenebene Ihres Arbeitsbereichs weiter. Wenn Ihr Arbeitsbereich serverlose Ausstiegssteuerung mit eingeschränktem Zugriff verwendet, fügen Sie den vollständig qualifizierten Domänennamen (FQDN) jedes MCP-Servers zur Liste der erlaubten Domänen der Richtlinie hinzu. Für die Schritte und dafür, wie Sie das Ziel jedes Dienstes finden, siehe Workspace to external MCP server.
Databricks in der Drittanbieter-App erlauben
Wenn Ihre Organisation den eingehenden Datenverkehr an die Drittanbieter-App auf einen erlaubten Satz von IP-Adressen beschränkt, wie etwa eine IP-Allowlist der GitHub Organisation, fügen Sie die serverlosen ausgehenden IPs von Azure Databricks für die Cloud und Region Ihres Arbeitsbereichs zur Allowlist der App hinzu, damit Aufrufe von Azure Databricks akzeptiert werden. Die Liste der IP-Adressen finden Sie unter IP-Adressen und Domänen für Azure Databricks Dienste und Objekte. Weitere Informationen zum serverlosen ausgehenden Netzwerk von Azure Databricks finden Sie unter Konfigurieren einer Firewall für serverlosen Rechenzugriff.
Zusätzliche Drittanbieter-App-Konfiguration
Zwei Gruppen von Administratoren steuern, ob Benutzer einen Connector verwenden können und was die Verbindung bewirken kann:
- Provider-Administratoren: Die Slack-, Google Workspace-, Microsoft Entra ID- oder GitHub-Administratoren Ihrer Organisation entscheiden, ob Nutzer die App autorisieren können und welche Berechtigungen sie erhält, wie etwa OAuth-Scopes oder Zugriff auf GitHub-Repositories. Sie sind oft nicht deine Azure Databricks-Administratoren.
-
Azure Databricks-Administratoren: Benutzer mit dem
MANAGEPrivileg auf dem MCP eines Connectors entscheiden, welche Tools verfügbar sind und wer sie aufrufen kann. Siehe Govern an MCP.
Wenn ein Anbieter die Anmeldung blockiert oder den Zugriff eines Connectors einschränkt, teilen Sie die Schritte für diesen Anbieter mit seinem Administrator. Nachdem der Administrator die App genehmigt hat, melden Sie sich über den Connector ab und melden Sie sich erneut an, um die genehmigten Berechtigungen zu erhalten. Siehe Anmeldung für Anbieter verwalten.
Die Databricks Genie-App in Slack genehmigen
Wenn dein Slack-Arbeitsbereich eine App-Genehmigung benötigt, warnt der Slack-Anmeldebildschirm, dass die App wahrscheinlich gesperrt ist. Slack kann auch Berechtigungen streichen, die ein Administrator nicht genehmigt hat. Zum Beispiel gelingt die Anmeldung, aber der Connector kann keine Nachrichten senden.
Ein Slack Workspace-Besitzer oder App-Manager muss die Databricks Genie-App genehmigen:
- Klicken Sie in Slack in der Seitenleiste auf Admin.
- Wählen Sie Apps and workflows aus, um den Slack Marketplace zu öffnen.
- Klicken Sie auf Durchsuchen, suchen Sie nach und wählen Sie Databricks Genie aus.
- Überprüfen Sie die angeforderten Berechtigungen und klicken Sie auf Genehmigen. Die Berechtigung „Im Namen eines Benutzers senden“ (
chat:write) ermöglicht es Benutzern, Nachrichten über den Connector zu senden.
Wenn ein Nutzer die App bereits angefordert hat, kann der Workspace Owner oder App-Manager die ausstehende Anfrage genehmigen. Siehe App-Genehmigung für Ihren Arbeitsbereich verwalten.
Wenn Azure Databricks dem Connector eine Berechtigung hinzufügt, bittet Slack erneut um eine Genehmigung. Bis die neue Berechtigung genehmigt ist, schlägt die Anmeldung fehl oder Slack verwirft die neue Berechtigung.
Wenn du dich erneut anmeldest, überprüfe die Aktionen, die Databricks Genie auf dem Slack-Anmeldebildschirm ausführen kann. Die Liste sollte auch das Absenden von Nachrichten enthalten. Wenn der Connector immer noch keine Nachrichten senden kann, bitten Sie einen Metastore-Admin oder einen anderen Benutzer mit MANAGE für system.ai.slack, seine Tools zu überprüfen:
- Wählen Sie in Unity GatewayMCPs aus und öffnen Sie
system.ai.slack. - Auf der Übersicht klicken Sie auf Tools bearbeiten.
- Stellen Sie sicher, dass die Tools, die Nachrichten senden, ausgewählt sind, und klicken Sie dann auf Änderungen speichern.
Weitere Informationen unter Verfügbare Tools auswählen.
Erlauben Sie die Connectors in Google Workspace
Wenn die Google-Anmeldung einen Zugriff blockiert-Fehler zeigt oder besagt, dass die Richtlinie Ihres Administrators die App sperrt, schränkt Ihr Google Workspace-Administrator ein, welche Drittanbieter-Apps Zugriff auf Google-Daten haben können. Die Google-Drive-, Gmail- und Google-Kalender-Konnektoren verwenden dieselbe Google-OAuth-App, sodass eine Konfiguration für alle drei ausreicht.
Ein Google Workspace-Administrator mit der Administratorberechtigung für Diensteinstellungen muss die App konfigurieren:
- In der Google Admin-Konsole gehen Sie zu Sicherheit>Zugriffs- und Datenkontrolle>API-Steuerungen.
- Klicken Sie auf App-Zugriff verwalten.
- Für Konfigurierte Apps klicke auf Neue App konfigurieren.
- Gib die Client-ID
645306276512-s5jbhbhff6irpdq1fpt2f21pcrf4agqs.apps.googleusercontent.comein, klicke auf Suchen und klicke in den Suchergebnissen auf die App. - Für Scope lassen Sie die oberste Organisationseinheit ausgewählt, um Zugriff für alle Benutzer zu konfigurieren, oder klicken Sie auf Organisationseinheiten auswählen , um bestimmte Organisationseinheiten auszuwählen. Klicken Sie auf Weiter.
- Für Zugriff auf Google-Daten wählen Sie Trusted. Um nur die Scopes zuzulassen, die die Connectors anfordern, wählen Sie stattdessen Specific Google data und fügen Sie die in Managed OAuth providers aufgeführten Scopes hinzu. Klicken Sie auf Weiter.
- Überprüfen Sie die Einstellungen und klicken Sie auf Beenden.
Die App erscheint in der Liste der konfigurierten Apps mit der ausgewählten Zugriffsstufe. Weitere Informationen finden Sie unter Steuern, welche Apps auf Google Workspace-Daten zugreifen.
Microsoft 365-Berechtigungen genehmigen
Der Microsoft 365-Connector fordert alle seine Microsoft Graph-Berechtigungen in einer einzigen Einwilligung an. Einige, wie ChannelMessage.Read.All und OnlineMeetingTranscript.Read.All, erfordern die Zustimmung des Administrators. Solange kein Administrator für die Organisation zustimmt, sehen Benutzer Administratorgenehmigung erforderlich und können sich nicht anmelden. Die vollständige Liste finden Sie unter Microsoft 365 Scopes.
Ein Microsoft Entra ID-Administrator, der mandantenweite Zustimmung erteilen kann, etwa ein Cloudanwendungsadministrator oder Anwendungsadministrator, erteilt die Zustimmung einmal für alle:
- Wählen Sie in Unity GatewayMCPs aus und öffnen Sie
system.ai.microsoft_365. - Klicken Sie auf Anmelden und melden Sie sich mit dem Administratorkonto an.
- Wählen Sie Zustimmung im Namen Ihrer Organisation aus und klicken Sie dann auf Akzeptieren.
Andere Nutzer können sich dann ohne die Einwilligungsaufforderung anmelden. Wenn Azure Databricks eine Berechtigung hinzufügt, muss ein Administrator erneut seine Zustimmung erteilen. Weitere Informationen zur Admin-Einwilligung finden Sie unter "Mandantenweite Admin-Einwilligung für eine Anwendung erteilen" in der Microsoft-Dokumentation.
Um zu begrenzen, was der Connector tun kann, kann ein Benutzer mit MANAGE auf system.ai.microsoft_365 seine Schreibwerkzeuge entfernen. Weitere Informationen unter Verfügbare Tools auswählen. Dies ändert die Berechtigungen auf dem Einwilligungsbildschirm nicht.
Aktivieren Sie GitHub-Schreibzugriff und Zugriff auf private Repositorien
Standardmäßig kann der GitHub-Connector (system.ai.github) nur öffentliche Repositorien lesen. Um auf private Repositories zuzugreifen oder Änderungen wie das Committen von Dateien oder das Erstellen von Issues und Pull Requests vorzunehmen, muss der Repository-Eigentümer oder ein GitHub-Organisationsadministrator:
Installiere die Databricks GitHub Connector-App und gewähre ihr Zugriff auf die erforderlichen Repositories.
Wenn die Organisation eine IP-Zulassungsliste verwendet, fügen Sie die serverlosen ausgehenden IPs von Azure Databricks für die Cloud und Region Ihres Arbeitsbereichs hinzu.
Nachdem die App installiert ist, können Nutzer mit den gewährten Repositories über den Connector arbeiten, innerhalb ihrer eigenen GitHub-Berechtigungen.