Beginnen Sie mit dem Foundry MCP Server (Vorschau) in Visual Studio Code

Foundry MCP Server (Vorschau) ist eine in der Cloud gehostete Implementierung des Model Context Protocol (MCP). Es macht kuratierte Tools verfügbar, mit denen Ihre Agents Lese- und Schreibvorgänge für Foundry-Dienste ausführen können, ohne back-End-APIs direkt aufzurufen. Sie müssen keine Infrastruktur bereitstellen – der Server bietet einen sicheren, skalierbaren Endpunkt mit integrierter Authentifizierung über Microsoft Entra ID.

Verwenden Sie einen MCP-kompatiblen Client wie Visual Studio Code, um eine Verbindung mit dem öffentlichen Endpunkt herzustellen, sich mit Entra-ID zu authentifizieren und LLMs den Zugriff auf die Tools zu ermöglichen. Nachdem Sie eine Verbindung hergestellt haben, können Sie Agents erstellen, die diese Tools mit Aufforderungen in natürlicher Sprache aufrufen.

In diesem Artikel erfahren Sie, wie Sie:

• Herstellen einer Verbindung mit dem Foundry MCP-Server mit GitHub Copilot in Visual Studio Code
• Ausführen von Eingabeaufforderungen zum Testen von Foundry MCP Server-Tools und Interagieren mit Azure Ressourcen

Dieser Leitfaden dauert ca. 5 Minuten.

Hinweis

Dieses Feature ist zurzeit als öffentliche Preview verfügbar. Diese Vorschauversion wird ohne Vereinbarung zum Servicelevel bereitgestellt und sollte nicht für Produktionsworkloads verwendet werden. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar. Weitere Informationen finden Sie unter Supplementale Nutzungsbedingungen für Microsoft Azure Previews.

Voraussetzungen

• Azure Konto mit einem aktiven Abonnement. Wenn Sie kein Konto haben, create a free Azure account.
• Ein Foundry-Projekt. Wenn Sie kein Projekt haben, erstellen Sie eines mit dem Microsoft Foundry SDK Quickstart.
• Visual Studio Code (Version 1.99 oder höher).
• Ein GitHub Copilot-Abonnement (Individual, Business oder Enterprise).
• GitHub Copilot Visual Studio Codeerweiterung.
• Mitwirkender oder höhere Rolle bei dem Foundry-Projekt, auf das Sie zugreifen möchten.

Installieren und Starten von Foundry MCP Server

Wählen Sie eine Option aus, um foundry MCP Server in Visual Studio Code zu installieren.

Benutzerprofil

Installieren Sie Foundry MCP Server in Ihrem Benutzerprofil, damit sie für alle Arbeitsbereiche in Visual Studio Code verfügbar ist.

1. Öffnen Sie die Befehlspalette (STRG+UMSCHALT+P).

2. Suchen Sie nach MCP: Server hinzufügen.

3. Wählen Sie die HTTP-Option (HTTP- oder Server-Sent-Ereignisse) aus.

4. Geben Sie https://mcp.ai.azure.com als URL ein.

5. Geben Sie einen freundlichen Namen wie foundry-mcp-remote ein und drücken Sie dann die Enter-Taste. Visual Studio Code fügt den folgenden Servereintrag unter Ihrem Benutzerprofil hinzu:

   { 
     "servers": { 
       "foundry-mcp-remote": { 
         "type": "http", 
         "url": "https://mcp.ai.azure.com" 
       } 
     } 
   }
   

6. Öffnen Sie die Befehlspalette (STRG+UMSCHALT+P).

7. Suchen Sie nach MCP, und wählen Sie " MCP: Server auflisten" aus.

8. Wählen Sie "Foundry MCP Server", den Sie hinzugefügt haben, und wählen Sie "Startserver" aus.

9. Ein grünes Symbol wird neben dem Servernamen in MCP angezeigt: Listenserver, wobei bestätigt wird, dass die Verbindung aktiv ist.

10. Melden Sie sich bei Azure an, damit der MCP-Server mit Diensten in Ihrem Abonnement interagieren kann.

11. Öffnen Sie GitHub Copilot, und wählen Sie Agent Mode aus.

12. Wählen Sie das Tools-Symbol aus, suchen Sie nach Foundry , um die Liste zu filtern, und bestätigen Sie, dass der Server angezeigt wird.

    

    Weitere Informationen zum Agentmodus finden Sie in der Visual Studio Codedokumentation.

Arbeitsbereichsinstallation

Installieren Sie Foundry MCP Server für einen bestimmten Arbeitsbereich, um ihn auf diesen Ordner zu beschränken:

1. Öffnen Sie einen leeren Ordner oder einen vorhandenen project Ordner in Visual Studio Code.

2. Erstellen Sie im Stammordner einen .vscode Ordner, falls er nicht vorhanden ist.

3. Erstellen Sie innerhalb des .vscode Ordners eine Datei mit dem Namen mcp.json, und fügen Sie den folgenden JSON-Code hinzu.

   { 
     "servers": { 
       "foundry-mcp-remote": { 
         "type": "http", 
         "url": "https://mcp.ai.azure.com" 
       } 
     } 
   }
   

4. Speichern Sie Ihre Änderungen in mcp.json.

5. Wählen Sie die Schaltfläche "Start " oberhalb des neuen Servereintrags aus.

6. Neben dem Servernamen wird ein grüner Indikator angezeigt, der bestätigt, dass die Verbindung aktiv ist.

7. Wenn Sie dazu aufgefordert werden, melden Sie sich an, damit der MCP-Server mit Diensten in Ihrem Abonnement interagieren kann.

8. Öffnen Sie GitHub Copilot, und wählen Sie den Agentmodus aus.

9. Wählen Sie das Symbol "Tools" aus, suchen Sie nach Foundry , um die Ergebnisse zu filtern, und bestätigen Sie, dass der Server angezeigt wird.

   

   Weitere Informationen zum Agentmodus finden Sie in der Visual Studio Codedokumentation.

Verwenden von Eingabeaufforderungen zum Testen von Foundry MCP Server

1. Öffnen Sie den GitHub Copilot-Chatbereich, und bestätigen Sie, dass Agent Mode ausgewählt ist.

2. Geben Sie eine Eingabeaufforderung ein, die Foundry MCP Server-Tools verwendet, z. B. "Informieren Sie mich über die neuesten Modelle auf Foundry".

3. Copilot fordert die Berechtigung zum Ausführen des erforderlichen Foundry MCP Server-Vorgangs an. Wählen Sie "Weiter" aus, oder verwenden Sie den Pfeil, um ein spezifisches Verhalten auszuwählen:

   • Current session führt immer den Vorgang in der aktuellen GitHub Copilot Agent Mode-Sitzung aus.
   • Aktueller Arbeitsbereich führt immer den Befehl für den aktuellen Visual Studio Codearbeitsbereich aus.
   • Always allow legt fest, dass der Vorgang immer für jede GitHub Copilot Agent Mode-Sitzung oder einen Visual Studio Codearbeitsbereich ausgeführt wird.

   

   Die Antwort ähnelt der folgenden gekürzten Ausgabe. Ihre tatsächlichen Ergebnisse variieren je nach aktueller Modellverfügbarkeit.

   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. Erkunden und testen Sie Foundry MCP Server-Vorgänge mit anderen Eingabeaufforderungen, z. B.:

   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
   

Problembehandlung

Thema	Beschluss
Server startet nicht	Stellen Sie sicher, dass Sie die URL https://mcp.ai.azure.com richtig eingegeben haben. Öffnen Sie die Befehlspalette , und führen Sie MCP aus: Listenserver , um den Serverstatus zu überprüfen.
Authentifizierungsaufforderung wird nicht angezeigt	Stellen Sie sicher, dass die GitHub Copilot-Erweiterung installiert ist und Sie bei Visual Studio Code mit einem Microsoft-Konto angemeldet sind, das Zugriff auf Ihr Azure-Abonnement hat.
Gießereitools werden nicht im Agentmodus angezeigt	Vergewissern Sie sich, dass der Server ausgeführt wird (grüner Indikator in MCP: Listenserver). Überprüfen Sie, ob Sie den Agent-Modus im Chatbereich "Copilot" ausgewählt haben, und wählen Sie dann das Symbol "Tools" aus, und suchen Sie nach Foundry.
"Access verweigert" oder Berechtigungsfehler	Stellen Sie sicher, dass Sie über die Rolle "Mitwirkender" oder eine höhere Rolle im Foundry-Projekt verfügen. Der Server verwendet den On-Behalf-Of-Fluss mit Ihren Entra-ID-Zugangsdaten.

Bereinigen von Ressourcen

So entfernen Sie die Serverkonfiguration:

• Benutzerprofil: Öffnen Sie die Befehlspalette, führen Sie MCP aus: Listenserver, wählen Sie den Foundry-Server aus, und wählen Sie "Server entfernen" aus.
• Workspace: Löschen Sie den Servereintrag aus der Datei .vscode/mcp.json in Ihrem project Ordner.

Verwandte Inhalte

Foundry MCP Server Tools und Beispielaufforderungen

• Foundry MCP Server-Sicherheit und bewährte Methoden
• Foundry MCP Server Tools und Beispielaufforderungen