Delen via

Quickstart: SQL MCP Server gebruiken met Azure AI Foundry

Belangrijk

SQL MCP Server bevindt zich in de preview-fase en deze documentatie en de implementatie van de engine kan tijdens deze evaluatieperiode worden aangepast.

Deze quickstart laat zien hoe u een geïmplementeerde SQL MCP-server verbindt met Azure AI Foundry met behulp van een aangepast MCP-hulpprogramma. U test alles met behulp van de Chat Playground met een chatmodel zoals GPT-5-mini - geen codering vereist.

Opmerking

De nieuwe Foundry-ervaring is in de previewversie. U moet de voorbeeldschakelaar selecteren in de koptekst wanneer u https://ai.azure.com opent.

Diagram met een geïmplementeerde SQL MCP-server die is verbonden met Azure AI Foundry.

Vereiste voorwaarden

Geïmplementeerde SQL MCP-server

U hebt een SQL MCP-server nodig die is geïmplementeerd in Azure Container Apps waarvoor openbaar inkomend verkeer is ingeschakeld. Als u nog geen implementatie hebt, voltooit u eerst de quickstart SQL MCP Server implementeren in Azure Container Apps .

U hebt de MCP-eindpunt-URL van die implementatie nodig (bijvoorbeeld https://your-app.azurecontainerapps.io/mcp).

Azure AI Foundry-project

U hebt toegang nodig tot Azure AI Foundry met een bestaand project en toegang tot een chatmodel (bijvoorbeeld GPT-5-mini).

Stap 1: Toegang krijgen tot Azure AI Foundry

  1. Navigeer naar https://ai.azure.com.
  2. Selecteer in de koptekst de nieuwe Foundry-ervaring (preview-wisselknop).
  3. Selecteer uw Foundry-project.
  4. Selecteer Playground in het linkernavigatievenster.

Opmerking

Tekst en navigatie in de gebruikersinterface kunnen variëren naarmate Azure AI Foundry zich ontwikkelt. Zie MCP-hulpprogramma's in Azure AI Foundry voor de nieuwste richtlijnen.

Stap 2: Een agent maken of openen

  1. Selecteer een bestaande agent of maak een nieuwe.
  2. Zoek in de agentconfiguratie de sectie Tools in het linkerdeelvenster.

Stap 3: Voeg een Model Context Protocol-hulpmiddel toe

  1. In de Extra sectie, selecteer Toevoegen (de knop kan een vervolgkeuzelijst of + pictogram weergeven).
  2. Selecteer Een nieuw hulpprogramma toevoegen in de vervolgkeuzelijst.
  3. Het dialoogvenster Een hulpmiddel selecteren wordt geopend met drie tabbladen: Geconfigureerd, Catalogus en Aangepast.
  4. Selecteer het tabblad Aangepast bovenaan.
  5. Selecteer Model Context Protocol (MCP) in de beschikbare opties.
  6. Selecteer Maken om door te gaan.

Stap 4: uw MCP-verbinding configureren

Het dialoogvenster Modelcontextprotocol toevoegen wordt weergegeven. Vul de volgende informatie in:

Naam (vereist)

Voer een beschrijvende naam in: products-mcp.

Extern MCP-servereindpunt (vereist)

Voer de URL van uw MCP-server in: https://<your-container-app-url>/mcp (vanuit uw Azure Container Apps-implementatie).

Verificatie (vereist)

Selecteer Niet-geverifieerd in de vervolgkeuzelijst.

Opmerking

Deze configuratie werkt omdat in de quickstart van Azure Container Apps anonieme machtigingen zijn geconfigureerd (bijvoorbeeld anonymous:read). Op het moment van schrijven gebruikt deze snelstart de modus Niet-geverifieerd. Als u verificatie inschakelt op uw MCP-server, configureert u het MCP-hulpprogramma dienovereenkomstig (de verificatieconfiguratie wordt niet behandeld in deze quickstart).

Selecteer Verbinding maken om het hulpprogramma toe te voegen.

Stap 5: Agentinstructies configureren

Voeg in de sectie Instructies boven aan de agentconfiguratie de tekst toe of vervang deze door:

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.

Stap 6: Uw agent testen

Probeer deze aanwijzingen in de chat:

Voorbeeld 1: Schemadetectie

What tables or entities are available in the database?

De agent moet een hulpprogramma voor schemadetectie (zoals describe_entities) aanroepen om de entiteitsstructuur Producten te zien.

Voorbeeld 2: Eenvoudige query

List all products

De agent moet een queryhulpprogramma (zoals read_records) aanroepen om productgegevens op te halen.

Voorbeeld 3: Prijsquery

Show me products under $20

De agent moet query's uitvoeren op producten waarvoor prijs 20 is.<

Voorbeeld 4: Inventariscontrole

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

De agent moet Inventaris < 30 filteren.

Voorbeeld 5: Complexe query

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

De agent moet:

  • Query's uitvoeren op producten gesorteerd op prijs aflopend
  • Het bovenste resultaat retourneren met het aantal inventarissen

Stap 7: Hulpprogrammaaanroepen weergeven

In de chatspeeltuin ziet u aanroepen van hulpprogramma's en hun argumenten/antwoorden:

  • Hulpprogramma genoemd: het hulpprogramma voor schemadetectie of queries dat wordt gebruikt
  • Argumenten: De doorgegeven parameters (filters, velden, enzovoort)
  • Antwoord: De gegevens die zijn geretourneerd uit uw SQL-database

Probleemoplossingsproces

Tool wordt niet weergegeven in Azure AI Foundry

  • Controleer of de MCP-URL juist en toegankelijk is.
  • Controleer of de Container App wordt uitgevoerd met openbare toegang ingeschakeld (zie bewakingsrichtlijnen).
  • Test het /mcp eindpunt met behulp van curl of een REST-client om de bereikbaarheid te controleren.

Voor aanroepen van hulpprogramma's is goedkeuring vereist

  • Controleer in de configuratie van het MCP-hulpprogramma of Goedkeuring vereisen is ingesteld op never.

Agent gebruikt het hulpprogramma niet

  • Controleer of uw systeembericht duidelijke instructies bevat over het gebruik van het hulpprogramma.
  • Probeer specifiekere vragen te stellen die betrekking hebben op de gegevens van Producten.

Zie de sectie probleemoplossing in de implementatiehandleiding voor Azure Container Apps voor implementatieproblemen.

Verwante inhoud

  • Last updated on