Aan de slag met Foundry MCP Server (preview) met behulp van Visual Studio Code

Foundry MCP Server (preview) is een in de cloud gehoste implementatie van het Model Context Protocol (MCP). Er worden gecureerde hulpprogramma's weergegeven waarmee uw agents lees- en schrijfbewerkingen kunnen uitvoeren op Foundry-services zonder back-end-API's rechtstreeks aan te roepen. U hoeft geen infrastructuur te implementeren. De server biedt een beveiligd, schaalbaar eindpunt met ingebouwde verificatie via Microsoft Entra ID.

Gebruik een MCP-compatibele client, zoals Visual Studio Code om verbinding te maken met het openbare eindpunt, te verifiëren met Entra ID en LLM's toegang te geven tot de hulpprogramma's. Nadat u verbinding hebt gemaakt, kunt u agents bouwen die deze hulpprogramma's aanroepen met prompts voor natuurlijke taal.

In dit artikel leert u het volgende:

  • Verbinding maken met Foundry MCP Server met GitHub Copilot in Visual Studio Code
  • Prompts uitvoeren om Foundry MCP Server-hulpprogramma's te testen en te communiceren met Azure resources

Het duurt ongeveer 5 minuten voordat deze handleiding is voltooid.

Opmerking

Deze functie is momenteel beschikbaar als openbare preview. Deze preview wordt aangeboden zonder een service level agreement en we raden deze niet aan voor productieworkloads. Bepaalde functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure previews voor meer informatie.

Voorwaarden

Foundry MCP-server installeren en starten

Selecteer een optie voor het installeren van Foundry MCP Server in Visual Studio Code.

Installeer Foundry MCP Server in uw gebruikersprofiel, zodat deze beschikbaar is voor alle werkruimten in Visual Studio Code.

  1. Open het opdrachtenpalet (Ctrl+Shift+P).

  2. Zoek naar MCP: Server toevoegen.

  3. Selecteer de HTTP-optie (HTTP of Server-Sent Events).

  4. Voer https://mcp.ai.azure.com in als de URL.

  5. Voer een beschrijvende naam in, zoals foundry-mcp-remote en druk op Enter. Visual Studio Code voegt de volgende serververmelding toe onder uw gebruikersprofiel:

    { 
      "servers": { 
        "foundry-mcp-remote": { 
          "type": "http", 
          "url": "https://mcp.ai.azure.com" 
        } 
      } 
    }
    
  6. Open het opdrachtenpalet (Ctrl+Shift+P).

  7. Zoek en selecteer MCP: Lijstservers.

  8. Selecteer Foundry MCP Server die u hebt toegevoegd en kies Server starten.

  9. Er wordt een groene indicator weergegeven naast de servernaam in MCP: Lijstservers, waarbij wordt bevestigd dat de verbinding actief is.

  10. Meld u aan bij Azure wanneer u hierom wordt gevraagd, zodat de MCP-server kan communiceren met services in uw abonnement.

  11. Open GitHub Copilot en selecteer Agentmodus.

  12. Selecteer het pictogram Hulpprogramma's, zoek naar Foundry om de lijst te filteren en bevestig dat de server wordt weergegeven.

    Schermafbeelding van de lijst met hulpprogramma's voor GitHub Copilot agentmodus met het hulpprogramma Foundry MCP Server.

    Meer informatie over de agentmodus vindt u in de documentatie Visual Studio Code.

Prompts gebruiken om Foundry MCP Server te testen

  1. Open het GitHub Copilot chatvenster en bevestig Agent mode is geselecteerd.

  2. Voer een prompt in die gebruikmaakt van Foundry MCP Server-hulpprogramma's, bijvoorbeeld Vertel me over de nieuwste modellen in Foundry.

  3. Copilot vraagt toestemming voor het uitvoeren van de vereiste Foundry MCP Server-bewerking. Selecteer Doorgaan of gebruik de pijl om een specifieker gedrag te kiezen:

    • Current session voert de bewerking altijd uit in de huidige GitHub Copilot Agent-modussessie.
    • Current workspace voert altijd de opdracht uit voor de huidige Visual Studio Code werkruimte.
    • Always toestaan stelt de bewerking zo in dat deze altijd wordt uitgevoerd voor elke GitHub Copilot agent-modus session en een Visual Studio Code werkruimte.

    Schermopname van opties voor het uitvoeren van Foundry MCP Server-bewerkingen.

    Het antwoord lijkt op de volgende verkorte uitvoer. De werkelijke resultaten variëren op basis van de beschikbaarheid van het huidige model.

    Latest / Notable Foundry Models (Preview Snapshot)
    
    1. Frontier & Reasoning Models
    gpt-4o (2024-11-20) – Flagship multimodal model; strong multi-turn coherence.
    o3 (2025-04-16) – Balanced reasoning with good accuracy/quality trade-off.
    o4-mini (2025-04-16) – Strong quality with better latency than o3.
    Phi-4 – Microsoft small frontier open model; competitive quality at lower cost.
    
    // Further output omitted
    
  4. Verken en test Foundry MCP Server-bewerkingen met andere prompts, zoals:

    What tools can I use from Foundry MCP Server (preview)?
    Tell me about the latest models on Foundry
    Show me details about the GPT-4o model on Foundry
    

Probleemoplossing

Probleem Resolutie
Server wordt niet gestart Controleer of u de URL https://mcp.ai.azure.com correct hebt ingevoerd. Open het opdrachtenpalet en voer MCP uit: Lijstservers om de serverstatus te controleren.
Verificatieprompt wordt niet weergegeven Zorg ervoor dat de GitHub Copilot-extensie is geïnstalleerd en u bent aangemeld bij Visual Studio Code met een Microsoft-account die toegang heeft tot uw Azure-abonnement.
Foundry-hulpprogramma's worden niet weergegeven in de agentmodus Controleer of de server actief is (groene indicator in MCP: Servers lijst). Controleer of u Agent Mode hebt geselecteerd in het Copilot chatvenster en selecteer vervolgens het pictogram Hulpprogramma's en zoek naar Foundry.
'Toegang geweigerd' of machtigingsfouten Controleer of u inzender of een hogere rol hebt voor het Foundry-project. De server gebruikt de On-Behalf-Of flow met uw Entra ID inloggegevens.

Resources opschonen

De serverconfiguratie verwijderen:

  • Gebruikersprofiel: Open het opdrachtenpalet, voer MCP uit: Lijstservers, selecteer de Foundry-server en kies Server verwijderen.
  • Werkruimte: Verwijder de serververmelding uit het .vscode/mcp.json bestand in de projectmap.