Partager via


Prise en main d’Azure MCP Server à l’aide de Visual Studio

Le serveur Azure MCP utilise le protocole MCP (Model Context Protocol) pour normaliser les intégrations entre les applications IA et les outils externes et les sources de données, ce qui permet aux systèmes IA d’effectuer des opérations qui prennent en compte le contexte de vos ressources Azure.

Dans cet article, vous allez apprendre à effectuer les tâches suivantes :

  • Installez et authentifiez-vous auprès du serveur Azure MCP.
  • Connectez-vous au serveur Azure MCP à l’aide du mode agent GitHub Copilot dans Visual Studio.
  • Exécutez des invites pour tester les opérations azure MCP Server et interagir avec les ressources Azure.

Prerequisites

Installer le serveur Azure MCP

Visual Studio utilise un fichier nommé mcp.json pour rechercher les configurations du serveur MCP, y compris les configurations configurées par d’autres environnements de développement. Les configurations de serveur MCP sont lues à partir des répertoires suivants, dans l’ordre suivant :

  1. %USERPROFILE%\.mcp.json: sert de configuration globale du serveur MCP pour un utilisateur spécifique. Ajoutez un serveur MCP ici pour le charger pour toutes les solutions Visual Studio.
  2. <SOLUTIONDIR>\.vs\mcp.json: spécifique à Visual Studio et charge uniquement les serveurs MCP spécifiés pour un utilisateur spécifique, pour la solution spécifiée.
  3. <SOLUTIONDIR>\.mcp.json: configuration MCP au niveau de la solution que vous pouvez suivre dans le contrôle de code source pour un dépôt.
  4. <SOLUTIONDIR>\.vscode\mcp.json: étendue au référentiel/solution et généralement pas incluse dans le contrôle de code source.
  5. <SOLUTIONDIR>\.cursor\mcp.json: étendue au référentiel/solution et généralement pas incluse dans le contrôle de code source.

Note

Certains de ces emplacements nécessitent .mcp.json tandis que d’autres nécessitent mcp.json.

Le serveur Azure MCP est disponible en tant que package NuGet ou en tant que package NPM. Les options suivantes illustrent deux des approches les plus courantes pour se connecter à Azure MCP Server à partir de Visual Studio.

Note

Vous pouvez également utiliser l’extension GitHub Copilot pour Azure pour installer Azure MCP

Effectuez les étapes suivantes pour installer le serveur Azure MCP pour un répertoire spécifique :

  1. Créez un fichier à la racine de votre solution nommée .mcp.json. Utilisez Visual Studio pour modifier ce fichier afin que son schéma JSON soit appliqué automatiquement.

  2. Dans le .mcp.json fichier, ajoutez le code JSON suivant pour votre package préféré :

    NuGet :

    {
      "servers": {
          "Azure MCP Server": {
              "command": "dnx",
              "args": [
                  "Azure.Mcp",
                  "--source",
                  "https://api.nuget.org/v3/index.json",
                  "--yes",
                  "--",
                  "azmcp",
                  "server",
                  "start"
              ],
              "type": "stdio"
          }
      }
    }
    

    NPM :

    {
      "servers": {
        "Azure MCP Server": {
          "command": "npx",
          "args": [
            "-y",
            "@azure/mcp@latest",
            "server",
            "start"
          ]
        }
      }
    }
    
  3. Enregistrez vos modifications.

  4. Ouvrez GitHub Copilot et sélectionnez Mode agent.

  5. Sélectionnez l’icône outils pour afficher les outils disponibles. Recherchez azure MCP Server pour filtrer les résultats.

Capture d’écran montrant comment configurer Azure MCP Server dans Visual Studio.

Visual Studio 2026 inclut les outils Azure MCP Server avec la charge de travail de développement Azure et IA. Pour les rendre disponibles :

  1. Ouvrez l’outil Visual Studio Installer.

  2. Sélectionnez Modifier pour afficher les charges de travail disponibles.

  3. Sous l’onglet Charges de travail , sélectionnez Le développement Azure et IA.

  4. Dans le panneau Détails de l’installation , vérifiez que GitHub Copilot est sélectionné, ce qui inclut les composants suivants :

    • GitHub Copilot, outil d'assistance au codage
    • GitHub Copilot pour Azure
    • Serveur Azure MCP
  5. Sélectionnez Installer lors du téléchargement pour terminer le processus d’installation.

Capture d’écran montrant comment installer Copilot à l’aide de charges de travail Visual Studio.

S’authentifier auprès d’Azure

Azure MCP Server offre une expérience d’authentification transparente à l’aide de comptes Azure et de Microsoft Entra ID. Pour utiliser azure MCP Server, vous devez d’abord vous authentifier auprès d’Azure à l’aide d’outils de développement locaux tels que Azure CLI, Azure Developer CLI, Visual Studio ou Visual Studio Code. Azure MCP Server découvre automatiquement vos informations d’identification à partir de ces outils et les utilise pour s’authentifier auprès des services Azure.

  1. Par exemple, pour vous connecter à l’aide d’Azure CLI :

    az login
    
  2. Vérifiez votre état d’authentification en exécutant la commande suivante pour voir le compte et l’abonnement avec lesquels vous êtes actuellement connecté :

    az account show
    
  3. Vérifiez que votre compte d’utilisateur dispose des attributions de rôles appropriées pour les services Azure avec lesquels vous souhaitez interagir. Les ressources Azure auxquelles vous envisagez d’accéder avec le serveur Azure MCP doivent déjà exister dans votre abonnement Azure. Par exemple, les attributions de rôles courantes sont les suivantes :

    • Contributeur de données BLOB du stockage - Lire et écrire des données BLOB dans des comptes de stockage.
    • Contributeur de compte de stockage - Gérer les configurations de compte de stockage.
    • Contributeur - Gestion générale des ressources dans votre abonnement.
    • Lecteur : accès en lecture seule aux ressources Azure.

    Pour plus d’informations sur les attributions de rôles et l’authentification de développement local, consultez Authentifier les applications .NET auprès des services Azure pendant le développement local.

Utiliser des invites pour tester le serveur Azure MCP

  1. Ouvrez GitHub Copilot et sélectionnez Mode agent.

  2. Entrez une invite qui amène l’agent à utiliser les outils azure MCP Server, tels que répertorier mes groupes de ressources Azure.

  3. Pour authentifier Azure MCP Server, Copilot vous invite à vous connecter à Azure à l’aide du navigateur.

    Note

    Copilot ne vous invite pas à vous connecter à Azure si vous êtes déjà authentifié via d’autres outils locaux tels que l’interface de ligne de commande Azure.

  4. Copilot demande l’autorisation d’exécuter l’opération de serveur Azure MCP nécessaire pour votre invite. Sélectionnez Autoriser cette heure ou utilisez la flèche pour sélectionner un comportement plus spécifique :

    • Toujours autoriser l’exécution de l’opération pour n’importe quelle session en mode Agent Copilot GitHub ou tout espace de travail Visual Studio Code.
    • Autoriser cette session exécute toujours l’opération dans la session en mode agent Copilot GitHub actuelle.

    Capture d’écran montrant comment exécuter les outils Azure MCP Server dans Visual Studio.

    La sortie de l’invite précédente doit ressembler au texte suivant :

    The following resource groups are available for your subscription:
    
    1. **DefaultResourceGroup-EUS** (Location: `eastus`)
    2. **rg-testing** (Location: `centralus`)
    3. **rg-azd** (Location: `eastus2`)
    4. **msdocs-sample** (Location: `southcentralus`)
    5. **ai-testing** (Location: `eastus2`)
    
    Let me know if you need further details or actions related to any of these resource groups!
    
  5. Explorez et testez les opérations Azure MCP à l’aide d’autres invites pertinentes, telles que :

    List all of the storage accounts in my subscription
    Get the available tables in my storage accounts
    

Étapes suivantes