Configurer le serveur MCP Azure DevOps distant

Azure DevOps Services

Le serveur MCP distant Azure DevOps est une version hébergée du serveur MCP Azure DevOps MCP qui ne nécessite pas d'installation locale. Au lieu d’exécuter le serveur sur votre ordinateur, vous connectez directement votre assistant IA au point de terminaison hébergé par Azure DevOps à l’aide du transport HTTP streamable.

Choisissez d’abord le mode à distance

Utilisez le serveur MCP distant lorsque votre environnement le prend en charge. Le serveur distant est l’option recommandée, car Azure DevOps l’héberge et le met à jour, et vous n’avez pas besoin d’installer Node.js ni de gérer un processus serveur local.

Utilisez le serveur MCP local lorsque votre client ne peut pas s'authentifier auprès du serveur distant avec Microsoft Entra ID. Cette limitation s’applique actuellement aux clients tels que Claude Desktop, Claude Code et Codex. Le curseur nécessite une inscription d’application Microsoft Entra personnalisée pour s’authentifier. Pour obtenir des instructions d’installation locales, consultez Activer l’aide à l’IA avec le serveur MCP Azure DevOps.

Prerequisites

configuration de mcp.json

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http"
    }
  },
  "inputs": []
}

Vous pouvez également omettre le nom de l’organisation à partir de l’URL. Toutefois, si vous omettez le nom de l’organisation, vous devez le fournir comme contexte dans chaque appel d’outil.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/",
      "type": "http"
    }
  },
  "inputs": []
}

Ensembles d’outils

Spécifiez des ensembles d’outils pour restreindre les outils disponibles pour le serveur MCP. Ne doit pas être combiné avec X-MCP-Tools.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Toolsets": "repos,wiki,wit"
      }
    }
  },
  "inputs": []
}

Outils en mode lecture seule

Utilisez l’en-tête X-MCP-Readonly pour restreindre le serveur aux opérations en lecture seule. Cette restriction est utile lorsque vous souhaitez empêcher les modifications apportées aux ressources Azure DevOps.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Readonly": "true"
      }
    }
  },
  "inputs": []
}

Combiner des ensembles d’outils et un filtrage en lecture seule

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Toolsets": "repos,wiki,wit",
        "X-MCP-Readonly": "true"
      }
    }
  },
  "inputs": []
}

Outils individuels

Utilisez l’en-tête X-MCP-Tools pour activer uniquement des outils spécifiques. Ne doit pas être combiné avec X-MCP-Toolsets.

Spécifiez les noms d’outils qui apparaissent dans la liste des outils disponibles . Pour les outils consolidés tels que wit_work_item, choisissez l’opération à l’aide du paramètre action de l’outil au moment de l’appel.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "core_list_projects, wit_work_item"
      }
    }
  },
  "inputs": []
}

Membres du programme Insider

À mesure que nous expérimentons et introduisons de nouveaux outils et mises à jour pour les éléments existants, vous pouvez accéder rapidement à ces modifications à l’aide de l’en-tête X-MCP-Insiders .

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Insiders": "true"
      }
    }
  },
  "inputs": []
}

Outils disponibles

Outils de base

Les outils de base sont toujours disponibles, sauf indication contraire.

Travail

Les outils de travail sont consolidés dans des répartiteurs groupés à l’aide d’un paramètre action.

Repos

Les outils de référentiel sont consolidés dans des répartiteurs groupés à l’aide d’un paramètre action.

Esprit

Les outils de travail sont consolidés dans des répartiteurs groupés à l’aide d’un paramètre action.

Pipelines

Les outils de pipeline sont consolidés dans des répartiteurs groupés à l’aide d’un paramètre action.

Wiki

Les opérations de lecture wiki sont consolidées dans un seul wiki outil. Utilisez le action paramètre pour sélectionner l’opération.

Plans de test

Les outils de plan de test sont consolidés dans des répartiteurs groupés à l’aide d’un paramètre action.

Sécurité avancée

Les outils de sécurité avancée sont regroupés dans un répartiteur regroupé qui utilise un paramètre action.

Enterprise Live Migration (préversion)

Les outils Enterprise Live Migration utilisent un action paramètre pour regrouper et distribuer des tâches. En savoir plus sur la préversion de Enterprise Live Migration.

Pour rendre uniquement les outils Enterprise Live Migration disponibles, utilisez l’en-tête X-MCP-Toolsets avec la elm valeur :

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Toolsets": "elm"
      }
    }
  },
  "inputs": []
}

Environnements pris en charge

Le serveur MCP à distance Azure DevOps nécessite que votre compte d’utilisateur et votre organisation Azure DevOps se connectent à Microsoft Entra ID.

Tous les clients MCP ne prennent pas en charge l’authentification Microsoft Entra par défaut. Certains environnements nécessitent des étapes supplémentaires pour inscrire l’application cliente.

Les environnements pris en charge pour le point de terminaison distant, lorsque l’authentification Microsoft Entra est disponible, incluent :

• Visual Studio avec GitHub Copilot
• Visual Studio
• Microsoft Foundry
• Microsoft Copilot Studio
• GitHub Copilot CLI
• GitHub application Copilot
• Curseur avec une inscription d’application Microsoft Entra personnalisée

Visual Studio Code

Pour configurer le serveur MCP distant dans Visual Studio Code :

1. Ajoutez un fichier .vscode/mcp.json à votre référentiel avec la configuration mcp.json indiquée précédemment.
2. Enregistrez le fichier.
3. Ouvrez GitHub Copilot dans VS Code.
4. Lorsque vous y êtes invité, authentifiez-vous à l’aide de votre compte Microsoft Entra et sélectionnez votre compte.

Une fois l’authentification terminée, une liste d’outils disponibles s’affiche.

Visual Studio (2022 et versions ultérieures)

Configurez le serveur MCP distant dans Visual Studio en ajoutant l’URL du serveur à vos paramètres MCP. Pour plus d’informations, consultez Utiliser des serveurs MCP dans Visual Studio.

Cursor

Cursor nécessite un enregistrement d’application Microsoft Entra personnalisé pour accéder au serveur MCP Azure DevOps distant.

Enregistrement de l’application

1. Vérifiez que l’application d’entreprise Azure DevOps MCP est bien provisionnée dans votre locataire. Si vous ne le trouvez pas, voir Impossible de trouver l'application d'entreprise MCP Azure DevOps dans le locataire.
2. Dans le centre d’administration Microsoft Entra, accédez à inscriptions d'applications, puis créez une inscription d’application.
3. Dans l’inscription de l’application, sélectionnez Authentification (Aperçu)>Ajouter un URI de redirection>.
4. Entrez http://localhost:8787/callback l’URI de redirection, puis enregistrez vos modifications.
5. Dans la page Authentification (préversion), sélectionnez l’onglet Paramètres , puis activez Autoriser les flux clients publics.
6. Dans la page Autorisations de l’API , sélectionnez Ajouter une API d’autorisation>que mon organisation utilise.
7. Recherchez Azure DevOps MCP ou l’ID d’application2a72489c-aab2-4b65-b93a-a91edccf33b8, puis sélectionnez l’application.
8. Sélectionnez les autorisations déléguées requises par votre application, puis sélectionnez Ajouter des autorisations.
9. Sélectionner Accorder le consentement administrateur. Selon votre rôle, un administrateur de locataire peut avoir besoin d’effectuer cette étape.

Copiez l’ID d’application (client) depuis l’enregistrement de l’application. Vous avez besoin de cette valeur pour configurer Cursor.

Configurer le curseur

1. Dans Curseur, ouvrez Paramètres>Tools &MCP.

2. Sélectionnez Nouveau serveur MCP.

3. Ajoutez la configuration suivante, en remplaçant {client-id} par l’ID d’application (client) que vous avez copié :

   {
     "mcpServers": {
       "ado": {
         "url": "https://mcp.dev.azure.com",
         "type": "http",
         "auth": {
           "CLIENT_ID": "{client-id}"
         }
       }
     }
   }
   

4. Enregistrez la configuration, puis revenez à Paramètres>Tools &MCP.

5. Recherchez le serveur ado , puis sélectionnez Authentifier.

Vérifier la connexion

Après l’installation, vérifiez que le serveur MCP distant fonctionne en posant à votre assistant IA une question sur vos données Azure DevOps.

Exemples :

• « Répertorier les projets dans mon organisation Azure DevOps. »
• « Afficher mes tâches assignées. »
• « Quelles pull requests nécessitent ma révision ? »

Si l’Assistant IA retourne les résultats de votre organisation Azure DevOps, le serveur MCP distant est configuré correctement.

Utiliser l’IA pour valider et résoudre les problèmes d’installation de MCP à distance

Les exemples d’invites ci-dessous pour Copilot Chat vous aident à choisir la bonne approche MCP, à configurer et valider la configuration à distance, à améliorer vos invites pour l’usage quotidien et à résoudre les problèmes en cas de besoin. Copiez et collez ces prompts dans Copilot Chat, puis remplacez les espaces réservés par les informations réelles concernant votre organisation, votre client et l’erreur.

Copilot est alimenté par l’IA, donc les surprises et les erreurs sont possibles. Pour plus d’informations, consultez les FAQ sur l’utilisation générale de Copilot.

Résolution des problèmes

Pour la prise en charge, vous pouvez soumettre un problème dans le dépôt MCP du serveur local. Veillez à utiliser le modèle de problème distant.

Questions fréquentes (FAQ)

Et d’autres clients comme Claude Desktop, Claude Code ou Codex ?

Claude Desktop, Claude Code et Codex nécessitent l’inscription dynamique d’un ID client OAuth dans Microsoft Entra ID avant de pouvoir utiliser le serveur MCP distant. Microsoft Entra ID ne prend actuellement pas en charge le flux d'inscription dynamique du client requis par ces clients. Utilisez le serveur MCP local avec ces clients.

Contenu connexe

• Azure DevOps vue d’ensemble du serveur MCP
• dépôt GitHub Azure DevOps MCP Server