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 et Codex. Cursor et Claude Code nécessitent un enregistrement d’application Microsoft Entra personnalisé 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
• l’application de bureau Cursor, les agents cloud de Cursor ou Claude Code avec un enregistrement d’application Microsoft Entra personnalisé

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.

Choisir des étendues OAuth pour les clients personnalisés

Lorsque vous inscrivez un client MCP personnalisé, accordez uniquement les autorisations déléguées requises pour les opérations de Azure DevOps effectuées par le client. Les étendues OAuth déterminent quelles Azure DevOps ressources et opérations auxquelles le client peut accéder. L’activation d’un outil ou ensemble d’outils MCP n’accorde pas d’autorisations supplémentaires.

Suivez le principe du privilège minimum :

• N’accordez des portées de lecture que lorsque le client utilise uniquement des outils MCP en mode lecture seule.
• N’accordez des autorisations en écriture ou en gestion que lorsque le client doit effectuer les opérations d’écriture correspondantes.
• Passez en revue les étendues héritées pour éviter d’accorder des autorisations redondantes.

Pour connaître les étendues disponibles et leurs relations, consultez les étendues OAuth.

Les étendues OAuth ne remplacent pas les autorisations de l’utilisateur connecté. Une opération MCP réussit uniquement lorsque l'étendue de l'application et les autorisations Azure DevOps de l'utilisateur l'autorisent.

Cursor

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

Enregistrer l’application pour la version de bureau de Cursor

1. Vérifiez que l’application d’entreprise Azure DevOps MCP est bien provisionnée dans votre locataire. Si vous ne la trouvez pas, consultez 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 client, en suivant les instructions d’étendue OAuth, 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 l’application de bureau Cursor

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.

Configurer les agents Cursor Cloud

Les agents Cursor Cloud nécessitent un URI de redirection web et un secret client, en plus de l’inscription d’application Microsoft Entra personnalisée.

1. Dans le centre d’administration Microsoft Entra, ouvrez l’inscription de l’application que vous avez créée pour Cursor.

2. Sélectionnez Authentification (Aperçu)>Ajouter une URI de redirection>Web.

3. Entrez https://www.cursor.com/agents/mcp/oauth/callback l’URI de redirection, puis enregistrez vos modifications.

4. Sélectionnez Certificats et secrets>Secrets client>Nouveau secret client.

5. Entrez une description, sélectionnez une période d’expiration, puis sélectionnez Ajouter.

6. Copiez la valeur du secret client. La valeur n’apparaît qu’une seule fois.

7. Dans Cursor, ouvrez la configuration du serveur MCP agents cloud, puis ajoutez ou modifiez le serveur MCP personnalisé.

8. Définissez l’URL du serveur sur https://mcp.dev.azure.com.

9. Entrez l’ID d’application (client) de votre inscription d’application dans l’ID client et la valeur de clé secrète client dans la clé secrète client.

   Vous pouvez également modifier la configuration JSON et remplacer les espaces réservés par les valeurs d’inscription de votre application :

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

10. Enregistrez la configuration, puis sélectionnez Se connecter dansCursor Cloud Agents pour terminer l’authentification Microsoft Entra.

Si Microsoft Entra retourne une erreurAADSTS50011, vérifiez que l’URI de redirection web correspond https://www.cursor.com/agents/mcp/oauth/callbackexactement . Si l’échange de jetons échoue avec l’erreur AADSTS7000218, vérifiez que la valeur actuelle du secret client est configurée dans Cursor Cloud Agents.

Claude Code

Claude Code nécessite une inscription d’application Microsoft Entra personnalisée 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 la trouvez pas, consultez 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:3118/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 client, en suivant les instructions d’étendue OAuth, 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 Claude Code.

Configurer Claude Code

1. Exécutez la commande suivante, en remplaçant {client-id} par l’ID d’application (client) que vous avez copié et {organization} par le nom de votre organisation Azure DevOps :

   claude mcp add --transport http ado https://mcp.dev.azure.com/{organization} \
     --client-id {client-id} --callback-port 3118
   

   Vous pouvez également créer un .mcp.json fichier à la racine de votre référentiel avec la configuration suivante :

   {
     "mcpServers": {
       "ado": {
         "type": "http",
         "url": "https://mcp.dev.azure.com/{organization}",
         "oauth": {
           "clientId": "{client-id}",
           "callbackPort": 3118
         }
       }
     }
   }
   

2. Démarrez Claude Code en exécutant claude.

3. Exécutez /mcp, puis suivez la procédure de connexion dans le navigateur pour vous authentifier avec votre compte Microsoft Entra.

Pour plus d’informations sur ces options, consultez Connecter Claude Code à des outils via MCP.

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)

Qu’en est-il d’autres clients comme Claude Desktop ou Codex ?

Claude Desktop 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