Quickstart: SQL MCP Server gebruiken met Azure AI Foundry

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

Belangrijk

SQL Model Context Protocol (MCP) Server is beschikbaar in Data API Builder versie 1.7 en hoger. Gebruik de nieuwste versie van 2.0 voor de nieuwste mogelijkheden en oplossingen voor fouten.

In deze quickstart ziet u 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.

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 Deploy SQL MCP Server naar Azure Container Apps quickstart.

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

Ui-tekst en -navigatie kunnen variëren naarmate Azure AI Foundry zich ontwikkelt. Zie MCP-hulpprogramma's in Azure AI Foundry voor de meest recente 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 de Azure Container Apps quickstart anonieme machtigingen machtigingen heeft 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 roubleshooting in de implementatiehandleiding voor Azure Container Apps voor implementatieproblemen.

Verwante inhoud

  • Last updated on