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.
Baue einen MCP-Server auf Databricks Apps , damit dein Agent deine eigenen Tools aufrufen kann. Databricks Apps stellt die Rechenleistung bereit, um den Server zu betreiben, sowie eine HTTPS-URL für Agenten, die sich darauf verbinden können.
Wählen Sie Ihren Pfad aus.
Wählen Sie eine dieser drei Möglichkeiten, einen MCP-Server auf Databricks Apps zu hosten:
- Baue einen Server aus der Starter-Vorlage, um eigene Python-Tools zu schreiben.
- Stelle eine REST-API als MCP-Tools bereit, wenn du bereits eine HTTP-API hast.
- Stelle einen bestehenden MCP-Server bereit, falls du bereits Servercode hast.
Baue einen Server aus der Starter-Vorlage
Die MCP Server (Starter)-Vorlage enthält ein funktionierendes Health-Tool, das du aufrufen kannst, bevor du deinen eigenen Python-Code hinzufügst.
Finde und stelle die Vorlage bereit
Verwenden Sie einen Arbeitsbereich, der die Anforderungen der Databricks Apps erfüllt.
- Öffne in deinem Arbeitsbereich Unity Gateway und wähle MCPs aus.
- Klicke + MCP und wähle Neuen MCP-Server erstellen. Die Seite zur Erstellung von Databricks Apps öffnet sich.
- Suchen Sie nach Von einer Vorlage installieren. In dieser Vorlagengalerie wählen Sie den Reiter Agents und dann MCP Server (Starter).
- Überprüfen Sie die Ressourcen-, Berechnungs- und Autorisierungseinstellungen. Klicken Sie auf Weiter, um mit der Einrichtung fortzufahren.
- Nenne die App
mcp-my-serverund klicke auf App erstellen. Verwenden Sie einen anderen Namen, der mitmcp-beginnt, wenn dieser Name vergeben ist. Dieses Präfix ermöglicht es dem AI Playground, den MCP-Server zu erkennen.
Das Erstellen der App stellt auch den Vorlagencode bereit. Warte auf der Übersichtsseite der App, bis die Bereitstellung abgeschlossen ist; hier findest du die URL und den Bereitstellungsstatus.
Rufen Sie das erste Tool auf
Kopieren Sie die App-URL von der Übersichtsseite und hängen Sie /mcp an:
https://<app-hostname>/mcp
Verbinde deinen Agenten mit dieser URL.
Fragen Sie Ihren Agent: „Rufe das Integritätstool auf.“ Vergewissern Sie sich, dass das Tool "status": "healthy" zurückgibt.
Füge dein eigenes Tool hinzu
Füge ein Tool hinzu, das Text in Großbuchstaben umwandelt:
Auf der Übersichtsseite der App klicken Sie auf In Ihrer IDE bearbeiten, um den Quellcode auf Ihren Computer zu kopieren und die Bearbeitungen mit dem Arbeitsbereich zu synchronisieren.
Öffnen Sie
server/tools.py. Füge diese Funktion inload_tools(mcp_server), neben den vorhandenen Werkzeugen:@mcp_server.tool def uppercase(text: str) -> str: """Convert a string to uppercase.""" return text.upper()Synchronisieren Sie Ihre Änderungen, und stellen Sie die App erneut bereit.
Verbinden Sie Ihren Agenten erneut, um die aktualisierten Tools zu laden. Fordere es auf,
uppercasemithelloaufzurufen und zu bestätigen, dass das ErgebnisHELLOist.
Siehe den Starter-Template-Quellcode für den kompletten Server.
Stellen Sie eine REST-API als MCP-Tools bereit
Nutzen Sie diese Option, wenn Sie bereits eine HTTP-API, wie zum Beispiel eine Kundensuch-API, haben und möchten, dass Ihr Agent sie aufruft. Die MCP Server (OpenAPI) -Vorlage bietet Werkzeuge, um die Endpunkte Ihrer API zu entdecken und aufzurufen.
Bereite die API vor
Die Vorlage benötigt zwei Dinge:
-
Eine API-Beschreibung: Speichere die OpenAPI 3.x-Spezifikation deiner API als
spec.jsonund lade sie auf ein Volume hoch. Platziere es im Stammverzeichnis des Volumes, außerhalb eines beliebigen Unterordners. Siehe die Beispielspezifikation. -
Eine HTTP-Verbindung:eine Verbindung erstellen, die die Authentifizierungsdaten Ihrer API speichert, oder eine bestehende verwenden. Speichere das Backend-Token oder die OAuth-Client-Zugangsdaten in dieser Verbindung. Kopiere den Verbindungsnamen. Für die Erstellung benötigen Sie
CREATE CONNECTION.
Wählen Sie die Authentifizierungsmethode der Verbindung für die Identität, die Ihre API erhalten soll:
- Das Provider-Konto jedes Nutzers: Wählen Sie OAuth User-to-Machine Per User und konfigurieren Sie die OAuth-Einstellungen des Anbieters.
- Ein gemeinsames Konto: Wählen SieBearer-Token, OAuth Machine-to-Machine oder OAuth User-to-Machine Shared, je nachdem, was die API unterstützt.
Siehe HTTP-Verbindungsauthentifizierungsmethoden für die unterstützten Optionen und Verbindungseigenschaften für die erforderlichen Zugangsdaten und OAuth-Endpunkte.
Erstellen der App
- In Unity Gateway wählen Sie MCPs, klicken Sie auf + MCP und wählen Neuen MCP-Server erstellen.
- Auf der Seite zur Erstellung von Apps wählen Sie unter Installieren aus einer VorlageAgents aus und dann MCP Server (OpenAPI).
- Für die uc-volume-Ressource wählen Sie das Volume aus, das
spec.jsonenthält. Dadurch erhält die App Zugriff auf deine API-Beschreibung. - Gehen Sie die Compute- und Autorisierungseinstellungen durch. Nenne die App
mcp-my-apiund klicke auf App erstellen.
Konfigurieren Sie die Authentifizierung und die Verbindung
Die Vorlage verwendet das Azure Databricks-Token des Anrufers, um auf die HTTP-Verbindung zuzugreifen. Die Verbindung liefert die Zugangsdaten der externen API. Dies gilt sogar, wenn alle Anrufer ein gemeinsames Backend-Konto nutzen.
Unter Benutzerautorisierung überprüfen Sie, dass die App den von der Vorlage deklarierten Scope anfordert
catalog.connections.Gewähren SIe jedem Aufrufer CAN USE in der App und
USE CONNECTIONfür die HTTP-Verbindung. Um Verbindungszugriff zu gewähren, öffnen Sie Katalog>Verbindungen, wählen Sie die Verbindung aus und verwenden Sie die Registerkarte Berechtigungen.Auf der Übersichtsseite der App klicken Sie auf Bearbeiten in Ihrer IDE, um den Quellcode auf Ihren Computer zu kopieren und die Synchronisierung mit dem Arbeitsbereich einzurichten.
Öffnen Sie
app.yaml. Suchen Sie im AbschnittenvnachUC_CONNECTION_NAME, und legen Sie den Wert auf den Namen Ihrer Verbindung fest:- name: UC_CONNECTION_NAME value: my_api_connectionErsetze
my_api_connectiondurch den Namen deiner Verbindung. Lassen Sie die anderen Vorlageneinstellungen unverändert.Synchronisiere die aktualisierte Datei und deploye dann die App neu. Warte, bis die Bereitstellung auf Übersicht abgeschlossen ist.
Mach den ersten Anruf
Verbinden Sie sich mit einem Azure Databricks OAuth-Token, das die Benutzerautorisierungsbereiche der App enthält. Siehe OAuth-Scopes für App-Aufrufe. Für eine Verbindung pro Benutzer muss jeder Anrufer außerdem sein Provider-Konto über den OAuth-Anmeldefluss der HTTP-Verbindung autorisieren.
- Kopieren Sie die App-URL aus der Übersicht, hängen Sie
/mcpan, und verbinden Sie Ihren Agent. - Bitten Sie Ihren Agent,
list_api_endpointsaufzurufen. Überprüfen Sie, ob das Ergebnis die Endpunkte in Ihrer Spezifikation enthält. - Bitten Sie den Agenten, einen schreibgeschützten Endpunkt aufzurufen und zu bestätigen, dass Daten von Ihrer API zurückgegeben werden.
Die Vorlage liest das Benutzertoken aus x-forwarded-access-token und ruft serving_endpoints.http_request mit dem Verbindungsnamen auf. Siehe die Authentifizierungshilfe und den API-Anforderungshandler.
Für neuen Code, der die API außerhalb dieser Vorlage aufruft, empfiehlt Databricks den HTTP-Verbindungsproxy.
Beispiel für OpenAPI-Spezifikation
Diese Spezifikation beschreibt GET /widgets. Ersetzen Sie die URL und die Operationen durch die Werte Ihrer API:
{
"openapi": "3.1.0",
"info": { "title": "Example API", "version": "1.0.0" },
"servers": [{ "url": "https://api.example.com" }],
"paths": {
"/widgets": {
"get": {
"summary": "List widgets",
"responses": { "200": { "description": "A list of widgets" } }
}
}
}
}
Einen bestehenden MCP-Server bereitstellen
Betreibe deinen bestehenden MCP-Server auf Databricks Apps.
Bereite deinen Server vor
Ihr Quellordner benötigt:
Ein HTTP-Server: Konfigurieren Sie Streamable HTTP. Überwachen Sie
0.0.0.0und den Port inDATABRICKS_APP_PORT(Standard:8000). Beachte deinen MCP-Pfad, zum Beispiel/mcp.Abhängigkeiten: Fügen Sie die entsprechende Abhängigkeitsdatei ein, zum Beispiel
requirements.txtfür Python oderpackage.jsonfür Node.js.Ein Startbefehl: Fügen Sie
app.yamlmit dem Befehl hinzu, der Ihren Server startet. Für einen Python-Entry-Point namensserver.py, verwende:command: ['python', 'server.py']
Bereitstellen und verbinden
- In Unity Gateway wählen Sie MCPs, klicken Sie auf + MCP und wählen Neuen MCP-Server erstellen.
- Auf der Seite zur Erstellung von Apps wählen Sie Benutzerdefinierte App erstellen. Benennen Sie es mit dem
mcp-Präfix und schließen Sie die App-Einrichtung ab. - Folgen Sie auf der Übersichtsseite der App dem Link In Ihrer IDE bearbeiten, um Ihren Quellordner mit dem Arbeitsbereich zu synchronisieren.
- Klicken Sie auf Deploy, wählen Sie den Arbeitsbereichsordner aus und klicken Sie dann auf Select und Deploy. Warten Sie, bis die Bereitstellung abgeschlossen ist. Siehe Bereitstellungsanweisungen.
- Kopiere die App URL und füge deinen MCP-Pfad hinzu. Verbinde deinen Agenten mit dieser URL und ruf eines der Tools deines Servers an, um die Verbindung zu überprüfen.
Agent verbinden
Verwenden Sie die MCP-URL für den gewählten Pfad. Für die Starter- und OpenAPI-Vorlagen hängen Sie /mcp an die App-URL an. Für einen bestehenden Server verwenden Sie den MCP-Pfad, der in Ihrem Server konfiguriert ist.
Wählen Sie die Einrichtungsanleitung Ihres Agenten:
-
Coding-Agents:Füge die App mit
ug mcp add --names "app:mcp-my-server"hinzu. Ersetzen Siemcp-my-serverdurch den Namen Ihrer App. - Python-Agents: Folgen Sie MCP-Tools verwenden mit der MCP-URL der App.
- Andere Clients:Registrieren Sie einen OAuth-Client mit der Redirect-URL des Clients und den Benutzerautorisierungsbereichen der App. Konfigurieren Sie den Client mit der MCP-URL Ihrer App.
Aufrufer benötigen CAN USE für die App und ein OAuth-Token. Persönliche Zugangstoken werden nicht unterstützt. Siehe Apps-Berechtigungen und Token-Authentifizierung für Apps.
Preisgestaltung und Monitoring
Apps verwenden die Preisgestaltung von Databricks Apps. Für Bereitstellungs- und Anfrageprotokolle siehe Logging und Überwachung für Databricks-Apps.