Configurer le serveur MCP à distance Azure DevOps (préversion)

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.

Le serveur distant offre les mêmes fonctionnalités que le serveur local, notamment l’accès aux éléments de travail, aux demandes de tirage, aux pipelines et bien plus encore, tout en éliminant la complexité de la configuration locale.

Serveur MCP local et distant

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.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "core_list_projects, wit_my_work_items, wit_get_work_items_batch_by_ids"
      }
    }
  },
  "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.

Travail

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

Repos

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

Esprit

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

Pipelines

Les outils du pipeline sont regroupés dans des répartiteurs regroupés à l’aide du 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 du plan de test sont regroupés dans des répartiteurs regroupés à l’aide du 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.

Les outils Enterprise Live Migration sont désactivés par défaut. Pour les activer, 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 actuellement pris en charge sont les suivants :

• Visual Studio Code
• Visual Studio

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.

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 des autres clients tels que GitHub Copilot CLI, Claude Desktop, Claude Code, CodeX ou Cursor ?

D’autres outils clients tels que CodeX, Claude Desktop, Claude Code et ChatGPT nécessitent l’inscription dynamique d’un ID client OAuth dans Microsoft Entra avant de pouvoir être utilisés avec le serveur MCP. Nous travaillons en étroite collaboration avec l'équipe Microsoft Entra pour activer cette fonctionnalité. Pour l’instant, seules les Visual Studio et les Visual Studio Code sont prises en charge.

Quels services peuvent utiliser Azure DevOps serveur MCP ?

La prise en charge d'autres services, notamment Azure AI Foundry, Microsoft 365 Copilot et Copilot Studio, n'est pas encore disponible, mais sera bientôt ajoutée.

Le serveur MCP Azure DevOps prend-il en charge l’AgentId ?

AgentId sera bientôt pris en charge.

Contenu connexe

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