Stelle einen MCP-Server auf Databricks Apps bereit

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

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.

  1. Öffne in deinem Arbeitsbereich Unity Gateway und wähle MCPs aus.
  2. Klicke + MCP und wähle Neuen MCP-Server erstellen. Die Seite zur Erstellung von Databricks Apps öffnet sich.
  3. Suchen Sie nach Von einer Vorlage installieren. In dieser Vorlagengalerie wählen Sie den Reiter Agents und dann MCP Server (Starter).
  4. Überprüfen Sie die Ressourcen-, Berechnungs- und Autorisierungseinstellungen. Klicken Sie auf Weiter, um mit der Einrichtung fortzufahren.
  5. Nenne die App mcp-my-server und klicke auf App erstellen. Verwenden Sie einen anderen Namen, der mit mcp- 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:

  1. 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.

  2. Öffnen Sie server/tools.py. Füge diese Funktion in load_tools(mcp_server), neben den vorhandenen Werkzeugen:

        @mcp_server.tool
        def uppercase(text: str) -> str:
            """Convert a string to uppercase."""
            return text.upper()
    
  3. Synchronisieren Sie Ihre Änderungen, und stellen Sie die App erneut bereit.

  4. Verbinden Sie Ihren Agenten erneut, um die aktualisierten Tools zu laden. Fordere es auf, uppercase mit hello aufzurufen und zu bestätigen, dass das Ergebnis HELLO ist.

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.json und 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

  1. In Unity Gateway wählen Sie MCPs, klicken Sie auf + MCP und wählen Neuen MCP-Server erstellen.
  2. Auf der Seite zur Erstellung von Apps wählen Sie unter Installieren aus einer VorlageAgents aus und dann MCP Server (OpenAPI).
  3. Für die uc-volume-Ressource wählen Sie das Volume aus, das spec.json enthält. Dadurch erhält die App Zugriff auf deine API-Beschreibung.
  4. Gehen Sie die Compute- und Autorisierungseinstellungen durch. Nenne die App mcp-my-api und 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.

  1. Unter Benutzerautorisierung überprüfen Sie, dass die App den von der Vorlage deklarierten Scope anfordert catalog.connections.

  2. Gewähren SIe jedem Aufrufer CAN USE in der App und USE CONNECTION fü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.

  3. 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.

  4. Öffnen Sie app.yaml. Suchen Sie im Abschnitt env nach UC_CONNECTION_NAME, und legen Sie den Wert auf den Namen Ihrer Verbindung fest:

    - name: UC_CONNECTION_NAME
      value: my_api_connection
    

    Ersetze my_api_connection durch den Namen deiner Verbindung. Lassen Sie die anderen Vorlageneinstellungen unverändert.

  5. 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.

  1. Kopieren Sie die App-URL aus der Übersicht, hängen Sie /mcp an, und verbinden Sie Ihren Agent.
  2. Bitten Sie Ihren Agent, list_api_endpoints aufzurufen. Überprüfen Sie, ob das Ergebnis die Endpunkte in Ihrer Spezifikation enthält.
  3. 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.0 und den Port in DATABRICKS_APP_PORT (Standard: 8000). Beachte deinen MCP-Pfad, zum Beispiel /mcp.

  • Abhängigkeiten: Fügen Sie die entsprechende Abhängigkeitsdatei ein, zum Beispiel requirements.txt für Python oder package.json für Node.js.

  • Ein Startbefehl: Fügen Sie app.yaml mit dem Befehl hinzu, der Ihren Server startet. Für einen Python-Entry-Point namens server.py, verwende:

    command: ['python', 'server.py']
    

Bereitstellen und verbinden

  1. In Unity Gateway wählen Sie MCPs, klicken Sie auf + MCP und wählen Neuen MCP-Server erstellen.
  2. 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.
  3. Folgen Sie auf der Übersichtsseite der App dem Link In Ihrer IDE bearbeiten, um Ihren Quellordner mit dem Arbeitsbereich zu synchronisieren.
  4. 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.
  5. 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:

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.