Verbinden von Genie Code mit MCP-Servern

Genie Code verbindet sich mit externen Werkzeugen, Dokumenten und Daten über Model Context Protocol (MCP)-Server und native Connectoren für Google Drive, Gmail, Google Kalender, Microsoft 365, Atlassian, Glean, Slack und GitHub. Verwenden Sie die nativen Connectors für allgemeine SaaS-Quellen, oder fügen Sie eigene externe oder benutzerdefinierte MCP-Server aus dem Arbeitsbereich hinzu. Sie wählen aus, welche Tools in den Genie Code-Einstellungen aktiviert werden sollen.

Was ist MCP?

MCP ist ein Open Source Standard, der Agents mit Tools, Ressourcen, Eingabeaufforderungen und anderen kontextbezogenen Informationen verbindet. MCP bietet eine standardisierte Möglichkeit, Tools, Daten und Workflows für Genie Code verfügbar zu machen, ohne diesen Kontext direkt in Eingabeaufforderungen oder Anweisungen einzubetten.

MCP ist für Fälle konzipiert, in denen bereits ein wichtiger Kontext vorhanden ist, aber schwierig ist, von einem Agenten wie Genie Code zuzugreifen. MCP bietet eine sichere Möglichkeit, Genie Code Zugriff auf Kontext wie die folgenden zu gewähren:

• Dokumentationssysteme: Teams behalten häufig Runbooks oder betriebsbereite Dokumente in Tools wie Confluence. Anstatt Abschnitte in Eingabeaufforderungen zu kopieren, können diese Inhalte einmal über einen externen MCP-Server verfügbar gemacht und bei Relevanz referenziert werden. Ihre Dokumente befinden sich möglicherweise auch bereits in Databricks als KI-Suchindex, den Genie Code zum Abfragen relevanter Dokumente verwenden kann.
• Tools und Dienste: Plattformteams verwalten möglicherweise APIs oder Skripts für Setup, Validierung oder Bereitstellung. MCP stellt diese Funktionen direkt für Genie Code zur Verfügung.
• Datenquellen: Wenn Sie bereits Daten in Databricks haben, können Sie Genie Code mit einem Genie Agent verbinden, um Die Daten mithilfe natürlicher Sprache zu analysieren. Für Daten, die außerhalb von Databricks gespeichert sind, können Sie Genie Code sicheren Zugriff über externe MCP-Server gewähren.
• Benutzerdefinierte Apps: Sie können auch benutzerdefinierte Funktionen hinzufügen, die über Databricks-Apps gehostet werden. Auf diese Weise können Sie Genie Code mit proprietären Tools, Workflows oder Integrationen verbinden, die speziell für Sie oder Ihre Organisation erstellt wurden und alle sicher in Ihrem Databricks-Arbeitsbereich verwaltet werden.

In diesen Fällen ersetzt MCP manuelles Kopieren und Einfügen durch einen strukturierten, wiederverwendbaren Ansatz, sodass der richtige Kontext nur verfügbar ist, wenn er benötigt wird.

Sie können Genie Code mit allen MCP-Servern in Ihrem Arbeitsbereich verbinden, die Sie verwenden dürfen. Arbeitsbereichsadministratoren steuern, welche Server verfügbar sind, während Benutzer nach Bedarf aus diesen genehmigten Quellen auswählen können.

Um mehr über MCP-Server in Databricks zu erfahren und eigene zu erstellen, siehe MCPs und Agent-Tools.

Verwenden von nativen Connectors für Datenquellen von Drittanbietern

Genie Code bietet integrierte Verbinder für gängige Unternehmensdatenquellen:

• Google Drive: Google Docs, Sheets und Slides suchen und erstellen; erstellte Docs bearbeiten.
• Gmail: E-Mails suchen, lesen und verfassen.
• Google Kalender: Suche und erstelle Kalenderereignisse.
• Microsoft 365: Suche in SharePoint, Teams, Outlook und Kalender; Entwurf einer Outlook-E-Mail.
• Atlassian: Suche und aktualisiere Jira und Confluence.
• Glean (Beta): Durchsuchen Sie die verbundenen Apps Ihrer Organisation mit Glean.
• Slack: Durchsuche Slack-Nachrichten und -Kanäle und sende Nachrichten.
• GitHub: Suche und aktualisiere Repositories, Issues und Pull Requests.

Die Verbindung zu diesen Datenquellen ermöglicht es Genie Code, Ihre Dokumente zu durchsuchen und Aktionen in verbundenen Tools beim Beantworten von Fragen durchzuführen. Jeder Benutzer authentifiziert sich individuell, und OAuth-Token werden nicht zwischen den Benutzern geteilt.

Diese Verbindungen verwenden von Databricks bereitgestellte MCP-Connectors, sodass es keinen Server zum Hosten und keine OAuth-App zur Registrierung gibt. Azure Databricks steuert jede Verbindung über Unity Catalog und Unity Gateway. Das Gateway autorisiert jeden Toolaufruf gegen Ihre Unity-Katalog-Berechtigungen, wendet integrierte Richtlinien und Genehmigungsanforderungen an und erfasst Nutzungs- und Audit-Logs in Systemtabellen. Siehe Registrieren eines externen MCP-Servers.

So verbinden Sie eine Drittanbieterdatenquelle:

1. Klicken Sie in Ihrem Arbeitsbereich auf Genie Code in der oberen rechten Ecke, um einen Chat zu öffnen.
2. Klicken Sie in der Eingabeaufforderungsleiste auf das Das Plussymbol.
3. Klicken Sie neben der Datenquelle, mit der Sie eine Verbindung herstellen möchten, auf "Verbinden".
4. Führen Sie die Schritte zum Anmelden aus.

Nach der Authentifizierung kann Genie Code Ihre Dokumente durchsuchen, wenn Sie Fragen beantworten. Metastoreadministratoren und Verbindungsbesitzer können Benutzerberechtigungen für die Verbindung verwalten oder widerrufen. Siehe Schritt 4. Gewähren Sie Zugang zu einem MCP-Service.

Hinweis

Datenquellentools werden nicht immer automatisch ausgelöst. Wenn die Dokumentsuche nicht gestartet wird, versuchen Sie, Genie Code explizit aufzufordern, das Tool zu verwenden, z. B. "Google Docs verwenden" oder "SharePoint verwenden".

Um andere Datenquellen zu verbinden, fügen Sie sie manuell zu Genie Code hinzu. Siehe manuelles Hinzufügen von MCP-Servern zu Genie Code.

Geplante Aufgaben und Authentifizierung

• Genie Code warnt dich nicht, wenn die Authentifizierung einer Verbindung abläuft. Vielleicht erfährst du es erst, wenn ein Tool-Call fehlschlägt oder wenn du die Verbindungsliste öffnest. Erneut authentifizieren, um das Problem zu beheben.
• Das Ändern der Berechtigungen einer Verbindung erfordert, dass jeder Nutzer sich erneut authentifiziert. Geplante Aufgaben, die die Verbindung nutzen, schlagen fehl, bis der Benutzer sich erneut authentifiziert.

Google Drive-Einschränkungen

• Wenn Sie Google Drive autorisieren, wird Ihnen möglicherweise ein Bildschirm mit der Meldung "Nicht überprüfte App" angezeigt. Klicken Sie auf "Erweitert" , und setzen Sie den Autorisierungsprozess fort.
• Die maximale Dateigröße beträgt 25 MB.
• Es werden nur native Google Workspace-Dateien (Docs, Sheets, Slides) unterstützt. PDFs, Bilder und andere Binärformate werden nicht unterstützt.
• Genie Code kann Google Docs, Sheets und Slides erstellen und die von ihm erstellten Google Docs über den Connector bearbeiten. Es kann keine außerhalb des Connectoren erstellten Dokumente bearbeiten oder bestehende Sheets oder Folien bearbeiten.
• Das Lesen eines sehr großen Dokuments kann langsam sein.

Hinweis

Die Verwendung und Übertragung von rohen oder abgeleiteten Benutzerdaten, die von Google Workspace-APIs empfangen werden, entsprechen der Google API-Dienste-Benutzerdatenrichtlinie, einschließlich der Anforderungen für die eingeschränkte Nutzung.

Gmail-Einschränkungen

• Genie Code kann E-Mails suchen, lesen und entwerfen, aber er kann keine E-Mails senden oder bestehende Nachrichten bearbeiten.
• Genie Code kann keine Drive-Dateien als native Gmail-Anhänge hinzufügen. Als Workaround fügen Sie Links zu den Dateien im E-Mail-Text ein.

Microsoft 365-Einschränkungen

• Umfasst SharePoint, Teams, Outlook und Kalender.
• Genie Code kann eine Outlook-E-Mail entwerfen, kann sie aber nicht verschicken.
• Die maximale Dateigröße beträgt 25 MB für SharePoint-Dateien.
• Unterstützte SharePoint Dateitypen umfassen Office-Dokumente (.docx, .xlsx, .pptx) sowie gängige textbasierte Formate wie .txt, .csv, .json, , .mdund andere. PDFs, Bilder und andere Binärformate werden nicht unterstützt.

Glean (Beta) Einschränkungen

• Glean ist nur für die Suche gedacht. Es kann ein Dokument nicht über einen direkten Link lesen.
• Ein Metastore-Administrator muss zunächst die Glean-Tenant-ID konfigurieren, bevor Nicht-Administratoren die Verbindung nutzen können. Der Administrator kann beim ersten Herstellen einer Verbindung mit Glean die Mandanten-ID eingeben.
• Um sich mit einem bestimmten Glean MCP-Server zu verbinden, kann ein Metastore-Administrator optional den MCP-Serverpfad (zum Beispiel /mcp/eng) beim Einrichten der Verbindung festlegen. Lassen Sie dieses Feld frei, um den Standardpfad (/mcp/default) zu verwenden. Nicht-Administrator-Benutzer können den Glean MCP-Serverpfad nicht angeben oder ändern.

Slack-Einschränkungen

• Genie Code kann eine Nachricht nach dem Absenden nicht bearbeiten oder löschen.

GitHub Einschränkungen

• Schreibvorgänge sind auf Dateiinhalte, Probleme und Pull Requests beschränkt.
• Standardmäßig kann der Databricks-GitHub MCP-Connector nur auf öffentliche Repositorys zugreifen. Um dem Connector Lesezugriff auf Ihre privaten Unternehmensrepositorys zu gewähren, muss ein GitHub Organisationsadministrator zusätzliche Einrichtung durchführen. Siehe Aktivieren des Zugriffs auf private Repositorys.
• GitHub Enterprise Server (die selbst gehostete Version von GitHub) wird nicht unterstützt.

Manuelles Hinzufügen von MCP-Servern zu Genie Code

Um Genie Code mit einem MCP-Server zu verbinden, fügen Sie ihn in Ihren Genie Code-Einstellungen hinzu:

1. Öffnen Sie die Einstellungen von Genie Code. Klicken Sie im Bereich "Genie Code" auf Einstellungen.
2. Klicken Sie unter MCP-Server auf Server hinzufügen.
3. Wählen Sie die MCP-Server aus, die Sie hinzufügen möchten. Sie können von Databricks verwaltete MCP-Server oder externe MCP-Server auswählen:
   • Unity Catalog-Funktion: Wählen Sie das Schema für die Funktion aus. Auf diese Weise kann Genie Code Funktionen verwenden, um vordefinierte SQL-Abfragen auszuführen.
     • Hilfe zum Erstellen eines benutzerdefinierten GitHub MCP-Servers finden Sie unter Search GitHub Code mit Genie Code.
   • AI Search: Wählen Sie das Schema für den Index aus. Auf diese Weise kann Genie Code den KI-Suchindex abfragen, um relevante Dokumente zu finden.
   • Genie Agent: Wählen Sie den Genie Agent aus. Der Genie MCP ruft Genie als Werkzeug auf, sodass Sie den Genie Agent abfragen können, um Daten mit natürlicher Sprache zu analysieren.
   • Externer MCP-Server: Wählen Sie die Unity Catalog-Verbindung aus, die als externer MCP-Server verwendet werden soll. Sie müssen sich zuerst bei der Verbindung anmelden, bevor sie verwendet werden kann.
   • Benutzerdefinierter MCP-Server: Wählen Sie die Databricks-App aus, die als benutzerdefinierter MCP-Server verwendet werden soll. Auf diese Weise können Sie alle benutzerdefinierten Tools verwenden. Die folgenden Anforderungen gelten:
     • Ihre App muss im selben Arbeitsbereich bereitgestellt werden, von dem Aus sie eine Verbindung herstellen möchten.
     • Der Zugang zum MCP-Server muss erfolgen über https://<server-url>/mcp.
     • Ihre App muss zustandslos sein. Legen Sie z. B. fest mcp_app = mcp_server.http_app(stateless_http=True).
     • Wenn CORS-Fehler auftreten, müssen Sie möglicherweise Ihre Arbeitsbereichs-URL zur Liste der zulässigen Ursprünge Ihrer App hinzufügen. Legen Sie z. B. fest app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).
4. Klicke auf Speichern.

Nachdem sie hinzugefügt wurden, sind MCP-Server sofort für Genie Code verfügbar. Sie können mit der Verwendung beginnen, ohne Ihre Eingabeaufforderungen oder Anweisungen zu ändern. Genie Code greift bei Bedarf automatisch auf diese Server zurück.

Sie können auswählen, welche Tools und Server in Ihren Genie Code-Einstellungen aktiviert oder deaktiviert werden sollen.

Einschränkungen

Für Compliance-Richtlinien für verbundene Anwendungen siehe Databricks-bereitgestellte MCP Service-Einschränkungen.

• Externe MCP-Server sind nur in Regionen verfügbar, in denen Model Serving unterstützt wird. Siehe Verfügbarkeit der Bereitstellungsfunktionen des Modells.