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

Repos

Les outils de référentiel sont consolidés dans des dispatchers groupés avec le paramètre action, en suivant le même modèle que les outils wiki. Les noms d’outils individuels précédents continuent de fonctionner en tant qu’alias. Utiliser repo_create_branch et repo_search_commits directement — ils n’ont pas été consolidés.

Esprit

Les outils liés aux éléments de travail sont consolidés dans des répartiteurs regroupés en utilisant un paramètre action, suivant le même modèle que celui des outils de dépôt et de pipeline. Les noms d’outils individuels précédents continuent de fonctionner en tant qu’alias. Utiliser search_workitem directement : elle n’a pas été consolidée.

Pipelines

Les outils de pipeline sont consolidés dans des répartiteurs regroupés à l’aide d’un action paramètre, en suivant le même modèle que les outils wiki et de dépôt. Les noms d’outils individuels précédents continuent de fonctionner en tant qu’alias.

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

Recherche

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 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.

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 Entra avant de pouvoir être utilisés avec le serveur MCP. Nous travaillons en étroite collaboration avec l’équipe Entra pour permettre 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