Prise en main de Foundry MCP Server (préversion) à l’aide de Visual Studio Code

Foundry MCP Server (préversion) est une implémentation hébergée dans le cloud du protocole MCP (Model Context Protocol). Il expose des outils organisés qui permettent à vos agents d’effectuer des opérations de lecture et d’écriture sur les services Foundry sans appeler directement des API back-end. Vous n'avez pas besoin de déployer l'infrastructure : le serveur fournit un point de terminaison sécurisé et évolutif avec l'authentification intégrée via Microsoft Entra ID.

Utilisez un client compatible MCP tel que Visual Studio Code pour vous connecter au point de terminaison public, s’authentifier auprès de Entra ID et permettre aux machines virtuelles d’accéder aux outils. Une fois connecté, vous pouvez créer des agents qui appellent ces outils avec des invites en langage naturel.

Dans cet article, vous allez apprendre à :

Se connecter au serveur MCP Foundry avec GitHub Copilot dans Visual Studio Code
Exécuter des invites pour tester les outils Foundry MCP Server et interagir avec les ressources Azure

Ce guide prend environ 5 minutes.

Note

Cette fonctionnalité est actuellement en préversion publique. Cette préversion est fournie sans contrat de niveau de service et nous ne la recommandons pas pour les environnements de production. Certaines fonctionnalités peuvent ne pas être prises en charge ou avoir des fonctionnalités contraintes. Pour plus d’informations, consultez Conditions d'utilisation supplémentaires pour les versions préliminaires de Microsoft Azure.

Conditions préalables

Compte Azure ayant un abonnement actif. Si vous n'en avez pas, créez un compte de Azure gratuit.
Un projet nommé Foundry. Si vous n'avez pas de projet, créez-en un avec le guide de démarrage rapide Microsoft Sdk Foundry.
Visual Studio Code (version 1.99 ou ultérieure).
Un abonnement GitHub Copilot (Individuel, Professionnel ou Entreprise).
Extension Visual Studio Code de GitHub Copilot.
Rôle de contributeur ou supérieur sur le projet Foundry auquel vous souhaitez accéder.

Installer et démarrer Le serveur MCP Foundry

Sélectionnez une option pour installer Foundry MCP Server dans Visual Studio Code.

Profil utilisateur
Installation de l’espace de travail

Installez Foundry MCP Server dans votre profil utilisateur afin qu'il soit disponible pour tous les espaces de travail dans Visual Studio Code.

Ouvrez la palette de commandes (Ctrl+Maj+P).
Recherchez MCP : Ajouter un serveur.
Sélectionnez l’option HTTP (HTTP ou événements envoyés par le serveur).
Entrez https://mcp.ai.azure.com en tant qu'URL.
Entrez un nom convivial tel que foundry-mcp-remote, puis appuyez sur Entrée. Visual Studio Code ajoute l’entrée de serveur suivante sous votre profil utilisateur :
```
{ 
  "servers": { 
    "foundry-mcp-remote": { 
      "type": "http", 
      "url": "https://mcp.ai.azure.com" 
    } 
  } 
}
```
Ouvrez la palette de commandes (Ctrl+Maj+P).
Recherchez et sélectionnez MCP : Répertorier les serveurs.
Sélectionnez Foundry MCP Server que vous avez ajouté et choisissez Démarrer le serveur.
Un indicateur vert apparaît en regard du nom du serveur dans MCP : Répertorier les serveurs, confirmant que la connexion est active.
Lorsque vous y êtes invité, connectez-vous à Azure afin que le serveur MCP puisse interagir avec les services de votre abonnement.
Ouvrez GitHub Copilot et sélectionnez ModeAgent.
Sélectionnez l’icône outils, recherchez Foundry pour filtrer la liste et confirmez que le serveur s’affiche.

En savoir plus sur le mode agent dans la documentation Visual Studio Code.

Installez Foundry MCP Server pour un espace de travail spécifique pour l’étendre à ce dossier :

Ouvrez un dossier vide ou un dossier de projet existant dans Visual Studio Code.
Dans la racine du dossier, créez un .vscode dossier s’il n’existe pas.

Dans le .vscode dossier, créez un fichier nommé mcp.jsonet ajoutez le code JSON suivant.

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

Enregistrez vos modifications dans mcp.json.
Sélectionnez le bouton Démarrer au-dessus de la nouvelle entrée de serveur.
Un indicateur vert apparaît en regard du nom du serveur, confirmant que la connexion est active.
Lorsque vous y êtes invité, connectez-vous afin que le serveur MCP puisse interagir avec les services de votre abonnement.
Ouvrez GitHub Copilot et sélectionnez Mode Agent.
Sélectionnez l’icône outils, recherchez Foundry pour filtrer les résultats, puis vérifiez que le serveur s’affiche.

Une capture d'écran montrant Foundry MCP Server en tant qu'outil GitHub Copilot.

Pour en savoir plus sur le mode agent, consultez la documentation Visual Studio Code.

Utiliser des requêtes afin de tester le serveur Foundry MCP

Ouvrez le panneau de conversation GitHub Copilot et confirmez ModeAgent est sélectionné.
Entrez une invite qui utilise les outils de serveur MCP Foundry, par exemple parlez-moi des derniers modèles sur Foundry.
Copilot demande l’autorisation d’exécuter l’opération de serveur McP Foundry requise. Sélectionnez Continuer ou utiliser la flèche pour choisir un comportement plus spécifique :
- sessioncurrente exécute toujours l’opération dans la session en mode agent GitHub Copilot en cours.
- Espace de travailcurrent exécute toujours la commande pour l’espace de travail Visual Studio Code actuel.
- Always allow définit l’opération à toujours s’exécuter pour n’importe quelle session en mode agent GitHub Copilot ou tout espace de travail Visual Studio Code.
La réponse ressemble à la sortie abrégée suivante. Vos résultats réels varient en fonction de la disponibilité actuelle du modèle.
```
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
```

Explorez et testez les opérations du serveur MCP Foundry à l'aide de commandes telles que :

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

Dépannage

Problème	Résolution
Le serveur ne démarre pas	Vérifiez que vous avez entré l’URL `https://mcp.ai.azure.com` correctement. Ouvrez la palette de commandes et exécutez MCP : Répertorier les serveurs pour vérifier l’état du serveur.
L’invite d’authentification n’apparaît pas	Vérifiez que l'extension GitHub Copilot est installée et que vous êtes connecté à Visual Studio Code avec un compte Microsoft qui a accès à votre abonnement Azure.
Les outils de Foundry n’apparaissent pas en mode Agent	Vérifiez que le serveur est en cours d’exécution (indicateur vert dans MCP : Serveurs de liste). Vérifiez que vous avez sélectionné ModeAgent dans le panneau de conversation Copilot, puis sélectionnez l’icône outils et recherchez Foundry.
Erreurs d'accès refusé ou de permission	Vérifiez que vous disposez d’un rôle Contributeur ou supérieur sur le projet Foundry. Le serveur utilise le flux "On-Behalf-Of" avec vos informations d’identification Entra ID.

Nettoyer les ressources

Pour supprimer la configuration du serveur :

Profil utilisateur : Ouvrez la palette de commandes, exécutez MCP : Répertorier les serveurs, sélectionnez le serveur Foundry, puis choisissez Supprimer le serveur.
Espace de travail : supprimez l’entrée de serveur du fichier .vscode/mcp.json dans le dossier de votre projet.

Outils Foundry MCP et exemples d’invites

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-04-30