Freigeben über

Schnellstart: Verwenden von SQL MCP Server mit Azure AI Foundry

Diagramm, das einen bereitgestellten SQL MCP-Server zeigt, der mit der Azure AI Foundry verbunden ist.

Von Bedeutung

Der SQL Model Context Protocol (MCP)-Server ist in Daten-API-Generator, Version 1.7 und höher, verfügbar.

In dieser Schnellstartanleitung erfahren Sie, wie Sie mithilfe eines benutzerdefinierten MCP-Tools einen bereitgestellten SQL MCP-Server mit Azure AI Foundry verbinden. Sie testen alles mithilfe des Chat-Playgrounds mit einem Chatmodell wie GPT-5-mini – keine Codierung erforderlich.

Hinweis

Die neue Foundry-Erfahrung befindet sich in der Vorschau. Sie müssen den Vorschau-Schalter in der Kopfzeile auswählen, wenn Sie aufrufen.

Voraussetzungen

Bereitgestellter SQL MCP-Server

Sie benötigen einen SQL MCP Server, der für Azure Container Apps mit aktiviertem öffentlichem Eingang bereitgestellt ist. Wenn Sie noch keine Bereitstellung haben, führen Sie zuerst den Schnellstart für das Bereitstellen des SQL MCP-Servers in Azure Container Apps aus.

Sie benötigen die MCP-Endpunkt-URL aus dieser Bereitstellung (z. B . ).

Azure AI Foundry Projekt

Sie benötigen Zugriff auf Azure AI Foundry mit einem vorhandenen Projekt und Zugriff auf ein Chatmodell (z. B. GPT-5-mini).

Schritt 1: Access Azure AI Foundry

  1. Navigiere zu .
  2. Wählen Sie in der Kopfzeile das neue Foundry-Erlebnis aus (Umschalten der Vorschau).
  3. Wählen Sie Ihr Foundry-Projekt aus.
  4. Wählen Sie im linken Navigationsbereich " Playground" aus.

Hinweis

Ui-Text und Navigation können variieren, wenn sich Azure AI Foundry weiterentwickelt. Die neuesten Anleitungen finden Sie unter MCP-Tools in Azure AI Foundry .

Schritt 2: Erstellen oder Öffnen eines Agents

  1. Wählen Sie einen vorhandenen Agent aus, oder erstellen Sie einen neuen Agent.
  2. Suchen Sie in der Agentkonfiguration den Abschnitt Extras in der linken Leiste.

Schritt 3: Hinzufügen eines Modellkontextprotokolltools

  1. Wählen Sie im Abschnitt "Extras" die Option "Hinzufügen" aus (die Schaltfläche zeigt möglicherweise ein Dropdown oder Symbol an).
  2. Wählen Sie im Dropdownmenü "Neues Tool hinzufügen " aus.
  3. Das Dialogfeld "Tool auswählen " wird mit drei Registerkarten geöffnet: "Konfiguriert", " Katalog" und "Benutzerdefiniert".
  4. Wählen Sie oben die Registerkarte "Benutzerdefiniert " aus.
  5. Wählen Sie in den verfügbaren Optionen das Modellkontextprotokoll (MCP) aus.
  6. Wählen Sie "Erstellen" aus, um fortzufahren.

Schritt 4: Konfigurieren Der MCP-Verbindung

Das Dialogfeld " Modellkontextprotokoll hinzufügen " wird angezeigt. Geben Sie die folgenden Informationen ein:

Name (erforderlich)

Geben Sie einen beschreibenden Namen ein: .

Remote-MCP-Serverendpunkt (erforderlich)

Geben Sie Ihre MCP-Server-URL ein: https://<your-container-app-url>/mcp (aus Ihrer Azure Container Apps Bereitstellung).

Authentifizierung (erforderlich)

Wählen Sie im Dropdownmenü " Nicht authentifiziert" aus.

Hinweis

Diese Konfiguration funktioniert, da der Azure Container Apps Schnellstart anonymous-Berechtigungen konfiguriert hat (z. B. anonymous:read). Zum Zeitpunkt des Schreibens verwendet diese Schnellstartanleitung den Modus "Nicht authentifiziert". Wenn Sie die Authentifizierung auf Ihrem MCP-Server aktivieren, konfigurieren Sie das MCP-Tool entsprechend (die Authentifizierungskonfiguration wird in dieser Schnellstartanleitung nicht behandelt).

Wählen Sie "Verbinden" aus, um das Tool hinzuzufügen.

Schritt 5: Konfigurieren von Agentanweisungen

Fügen Sie im Abschnitt "Anweisungen" oben in der Agentkonfiguration den Text hinzu, oder ersetzen Sie den Text durch:

You are a helpful product catalog assistant. When answering questions about products, use the products-mcp tool to query the database. 

The Products entity contains:
- Id: Product identifier
- Name: Product name
- Inventory: Units in stock
- Price: Retail price in USD
- Cost: Store cost in USD

Always use the schema discovery tool first to understand the schema, then use the query tool to retrieve data.

Schritt 6: Testen Ihres Agents

Probieren Sie die folgenden Eingabeaufforderungen im Chat aus:

Beispiel 1: Schemaermittlung

What tables or entities are available in the database?

Der Agent sollte ein Schemaermittlungstool (wie ) aufrufen, um die Entitätsstruktur Products anzuzeigen.

Beispiel 2: Einfache Abfrage

List all products

Der Agent sollte ein Abfragetool (z. B. ) aufrufen, um Produktdaten abzurufen.

Beispiel 3: Preisabfrage

Show me products under $20

Der Agent sollte Produkte abfragen, bei denen Preis 20 ist.

Beispiel 4: Bestandsüberprüfung

Which products are low in stock (less than 30 units)?

Der Agent sollte Inventar 30 filtern.

Beispiel 5: Komplexe Abfrage

What's the most expensive product, and how many do we have in stock?

Der Agent sollte:

  • Nach absteigender Preis sortierte Abfrageprodukte
  • Geben Sie das Top-Ergebnis mit Bestandsanzahl zurück

Schritt 7: Anzeigen von Toolaufrufen

Im Chat-Playground können Sie Toolaufrufe und deren Argumente/Antworten sehen:

  • Tool aufgerufen: Das verwendete Schemaermittlungs- oder Abfragetool
  • Argumente: Die übergebenen Parameter (Filter, Felder usw.)
  • Antwort: Die von Ihrer SQL-Datenbank zurückgegebenen Daten

Problembehandlung

Das Tool wird in Azure AI Foundry nicht angezeigt

  • Überprüfen Sie, ob die MCP-URL korrekt und barrierefrei ist.
  • Überprüfen Sie, ob die Containeranwendung mit aktiviertem öffentlichem Ingress ausgeführt wird (siehe Überwachungsleitfaden).
  • Testen Sie den Endpunkt mithilfe von Curl oder einem REST-Client, um die Reichweite zu überprüfen.

Toolaufrufe erfordern eine Genehmigung

  • Stellen Sie in der MCP-Toolkonfiguration sicher, dass Genehmigung erforderlich auf gesetzt ist.

Agent, der das Tool nicht verwendet

  • Überprüfen Sie, dass die Systemmeldung klare Anweisungen dazu enthält, wann das Tool verwendet werden soll.
  • Versuchen Sie, spezifischere Fragen zu stellen, die sich auf die Produktdaten beziehen.

Informationen zu Bereitstellungsproblemen finden Sie im Abschnitt troubleshooting im Azure Container Apps Bereitstellungshandbuch.

Verwandte Inhalte

  • Übersicht über SQL MCP Server
  • Datenmanipulationstools in SQL MCP Server
  • Hinzufügen von semantischen Beschreibungen zu SQL MCP Server
  • Last updated on