De externe Azure DevOps MCP-server instellen (preview)

Azure DevOps Services

Belangrijk

De externe Azure DevOps MCP-server is momenteel beschikbaar als openbare preview. Preview-functies hebben mogelijk beperkte functionaliteit en kunnen vóór algemene beschikbaarheid worden gewijzigd.

Ondersteuning

De externe Azure DevOps MCP-server is een gehoste versie van de Azure DevOps MCP-server waarvoor geen lokale installatie is vereist. In plaats van de server op uw computer uit te voeren, verbindt u uw AI-assistent rechtstreeks met het door Azure DevOps gehoste eindpunt met behulp van streambaar HTTP-transport.

De externe server biedt dezelfde mogelijkheden als de lokale server, waaronder toegang tot werkitems, pull-aanvragen, pijplijnen en meer, terwijl lokale configuratiecomplexiteit wordt geëlimineerd.

Externe versus lokale MCP-server

Feature Externe MCP-server (voorbeeldweergave) Lokale MCP-server
Installation Geen installatie vereist Vereist Node.js 20.0+ en npx
Vervoer Streamable HTTP Studio
Authentication Microsoft Entra ID (OAuth) Azure DevOps PAT of Microsoft Entra ID
Hostingdiensten Azure DevOps-gehoste service Wordt lokaal uitgevoerd op uw computer
Configuration Minimale mcp.json Omgevingsspecifieke installatie
Status Openbare preview Algemeen beschikbaar

Vereiste voorwaarden

Categorie Requirements
Azure DevOps Een actieve Azure DevOps organisatie verbonden met Microsoft Entra ID
toestemmingen Lidmaatschap van het project en toegang tot de resources die u wilt opvragen
Milieu Een ondersteunde AI-assistentomgeving (zie Ondersteunde omgevingen)

configuratie van mcp.json

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

U kunt ook de naam van de organisatie weglaten uit de URL. Als u echter de naam van de organisatie weglaat, moet u deze opgeven als context in elke aanroep van het hulpprogramma.

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

Hulpmiddelensets

Geef hulpprogramma's op om de hulpprogramma's te beperken die beschikbaar zijn voor de MCP-server. Mag niet worden gecombineerd met X-MCP-Tools.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Toolsets": "repos,wiki,wit"
      }
    }
  },
  "inputs": []
}
Waarde van toolset Inbegrepen hulpprogramma's
all (standaard) Alle hulpprogramma's uit elke toolset
repos Hulpprogramma's voor repositories en pull requests (repo_*)
wit Hulpmiddelen voor werkitems (wit_*) en search_workitem
pipelines Hulpprogramma's voor pijplijnen en bouwen (pipelines_*)
wiki Wikihulpprogramma's (wiki, wiki_upsert_page) en search_wiki
work Iteratie- en capaciteitstools (work_*)
testplan Hulpprogramma's voor testplannen (testplan_*)

Hulpmiddelen voor alleen-lezen

Gebruik de X-MCP-Readonly header om de server te beperken tot alleen-lezenbewerkingen. Deze beperking is handig als u wijzigingen in Azure DevOps resources wilt voorkomen.

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

Hulpmiddelensets en alleen-lezenfilters combineren

{
  "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": []
}

Afzonderlijke hulpprogramma's

Gebruik de X-MCP-Tools header om alleen specifieke hulpprogramma's in te schakelen. Mag niet worden gecombineerd met 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": []
}

Insiders

Wanneer we experimenteren en nieuwe hulpprogramma's en updates voor bestaande hulpprogramma's introduceren, kunt u vroegtijdig toegang krijgen tot deze wijzigingen met behulp van de X-MCP-Insiders header.

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

Beschikbare hulpmiddelen

Opmerking

Deze lijst geeft mogelijk niet altijd de meest recente hulpprogramma-updates weer.

Basis hulpprogramma's

Kerntools zijn altijd beschikbaar.

Tool Beschrijving
core_list_projects Projecten in een organisatie vermelden
core_list_project_teams Teams in een project weergeven

Werk

Tool Beschrijving Read-only
work_list_team_iterations Iteraties voor een team weergeven. ✅
work_list_iterations Alle iteraties in een project weergeven. ✅
work_get_team_capacity Krijg teamcapaciteit voor een iteratie. ✅
work_create_iterations Iteraties maken. ❌
work_assign_iterations Iteraties toewijzen aan een team. ❌

Repos

De repository-tools worden gegroepeerd in dispatchers met behulp van een action parameter, volgens hetzelfde patroon als de wikihulpprogramma's. De vorige namen van afzonderlijke hulpprogramma's blijven werken als aliassen. Gebruik repo_create_branch en repo_search_commits rechtstreeks — ze zijn niet samengevoegd.

Tool Action Beschrijving Read-only
repo_pull_request get Een pull request ophalen met ID ✅
repo_pull_request list Pull-aanvragen weergeven in een opslagplaats of project ✅
repo_pull_request list_by_commits Pull-aanvragen zoeken die specifieke doorvoer-id's bevatten ✅
repo_pull_request_thread list Discussielijnen voor opmerkingen weergeven in een pull-aanvraag ✅
repo_pull_request_thread list_comments Opmerkingen weergeven in een specifieke thread ✅
repo_repository get Een opslagplaats ophalen op naam of id ✅
repo_repository list Opslagplaatsen in een project vermelden ✅
repo_branch get Een vertakking ophalen op naam ✅
repo_branch list Vertakkingen in een repository lijst tonen ✅
repo_branch list_mine Lijst de vertakkingen waar de huidige gebruiker naar heeft gepusht ✅
repo_file get_content De tekstinhoud van een bestand ophalen op een specifieke branch, tag of commit ✅
repo_file list_directory Bestanden en mappen in een map weergeven, met optionele recursieve vermelding ✅
repo_search_commits N/A Commits zoeken door filters toe te passen op tekst, auteur, datumbereik en meer ✅
repo_pull_request_write create Een pull-aanvraag maken ❌
repo_pull_request_write update Een pull-aanvraag bijwerken, inclusief het instellen van automatisch aanvullen ❌
repo_pull_request_write update_reviewers Revisoren voor pull-aanvragen toevoegen of verwijderen ❌
repo_pull_request_write vote Een stem uitbrengen op een pull-aanvraag ❌
repo_pull_request_thread_write create Een nieuwe thread voor opmerkingen maken voor een pull-aanvraag ❌
repo_pull_request_thread_write reply Een opmerking beantwoorden in een thread ❌
repo_pull_request_thread_write update_status De status van een thread met opmerkingen bijwerken ❌
repo_create_branch Een tak aanmaken ❌

Wit

De werkitemtools worden samengevoegd in gegroepeerde dispatchers met behulp van een action parameter, volgens hetzelfde patroon als de repository en pijplijnhulpprogramma's. De vorige namen van afzonderlijke hulpprogramma's blijven werken als aliassen. Rechtstreeks gebruiken search_workitem : het is niet samengevoegd.

Tool Action Beschrijving Read-only
wit_work_item get Werkitem ophalen op ID ✅
wit_work_item get_batch Meerdere werkitems ophalen aan de hand van ID's ✅
wit_work_item list_comments Opmerkingen weergeven voor een werkitem ✅
wit_work_item my Werkitems ophalen die relevant zijn voor de geverifieerde gebruiker ✅
wit_work_item list_revisions Revisies van een werkitem weergeven ✅
wit_work_item list_for_iteration Lijst werkitems voor een teamiteratie ✅
wit_work_item get_type Metagegevens ophalen voor een werkitemtype ✅
wit_query get Een query ophalen op basis van ID of pad ✅
wit_query get_results Een opgeslagen query uitvoeren ✅
wit_backlog list Achterstandsniveaus voor een team vermelden ✅
wit_backlog list_work_items Werkitems weergeven in een specifiek achterstandsniveau ✅
search_workitem N/A Zoeken naar werkitems in volledige tekst ✅
wit_work_item_write create Een nieuw werkitem maken ❌
wit_work_item_write update Velden voor een werkitem bijwerken ❌
wit_work_item_write update_batch Meerdere werkitems in één aanroep bijwerken ❌
wit_work_item_write add_child Kindwerkitems aan een bovenliggend werkitem toevoegen ❌
wit_work_item_comment_write add Een opmerking toevoegen aan een werkitem ❌
wit_work_item_comment_write update Een bestaande opmerking bijwerken voor een werkitem ❌
wit_work_item_link_write link Twee werkitems koppelen ❌
wit_work_item_link_write unlink Koppelingen verwijderen uit een werkitem ❌
wit_work_item_link_write link_to_pull_request Een werkitem koppelen aan een pull-aanvraag ❌
wit_work_item_link_write add_artifact_link Een koppeling voor een opslagplaats, vertakking, doorvoer of buildartefact toevoegen aan een werkitem ❌

Opmerking

wit_query_by_wiql is momenteel alleen beschikbaar voor MCP Insiders met behulp van de X-MCP-Insiders header.

Pipelines

De pijplijntools worden samengevoegd in gegroepeerde dispatcherfuncties met behulp van een action parameter, volgens hetzelfde patroon als de wiki- en opslagplaatstools. De vorige namen van afzonderlijke hulpprogramma's blijven werken als aliassen.

Tool Action Beschrijving Read-only
pipelines_build list Builds weergeven met optionele filters ✅
pipelines_build get_status Status, problemen en metagegevens voor een build ophalen ✅
pipelines_build get_changes Commits en werkitems ophalen die zijn gekoppeld aan een build ✅
pipelines_build_log list Beschikbare logboeken voor een build weergeven ✅
pipelines_build_log get_content De tekstinhoud van een specifiek logboek ophalen op basis van id ✅
pipelines_definition list Pijplijndefinities weergeven met optionele filters ✅
pipelines_definition list_revisions Revisiegeschiedenis voor een pijplijndefinitie vermelden ✅
pipelines_run get Een enkele pijplijnuitvoering ophalen ✅
pipelines_run list Voer lijst van uitvoeringen voor een pijplijn uit ✅
pipelines_artifact list Artefacten voor een build vermelden ✅
pipelines_artifact download Een benoemd build-artefact downloaden ✅
pipelines_write run_pipeline Een nieuwe pijplijnrun in de wachtrij plaatsen ❌
pipelines_write create_pipeline Een nieuwe YAML-pijplijndefinitie maken ❌
pipelines_write update_build_stage Een fase annuleren, opnieuw proberen of uitvoeren tijdens een lopende build. ❌

Wiki

De wikileesbewerkingen worden samengevoegd tot één wiki hulpprogramma. Gebruik de action parameter om de bewerking te selecteren.

Tool Action Beschrijving Read-only
wiki list_wikis Wiki's weergeven in een project of organisatie ✅
wiki get_wiki Een wiki ophalen op id ✅
wiki list_pages Pagina's weergeven in een wiki ✅
wiki get_page Pagina-inhoud en metagegevens ophalen ✅
search_wiki Zoeken in wiki's in volledige tekst ✅
wiki_upsert_page Een wikipagina maken of bijwerken ❌

Testplannen

Tool Beschrijving Read-only
testplan_list_test_plans Lijst met test plans in een project. ✅
testplan_list_test_suites Lijst testsuites op in een testplan. ✅
testplan_list_test_cases Testgevallen in een suite opsommen. ✅
testplan_show_test_results_from_build_id Testresultaten ophalen uit een build. ✅
testplan_create_test_plan Maak een testplan. ❌
testplan_create_test_suite Maak een testpakket. ❌
testplan_create_test_case Maak een testcase. ❌
testplan_update_test_case_steps Stappen van de testcase bijwerken. ❌
testplan_add_test_cases_to_suite Voeg testcases toe aan een suite. ❌
Tool Beschrijving Read-only
search_code Zoeken in code in volledige tekst. ✅
search_wiki Zoeken in wiki's in volledige tekst. ✅
search_workitem Zoeken naar werkitems in volledige tekst. ✅

Ondersteunde omgevingen

Voor de externe Azure DevOps MCP-server moeten uw gebruikersaccount en Azure DevOps organisatie verbinding maken met Microsoft Entra ID.

Niet alle MCP-clients ondersteunen standaard Entra-verificatie. Voor sommige omgevingen zijn extra stappen vereist om de clienttoepassing te registreren.

Momenteel ondersteunde omgevingen zijn onder andere:

  • Visual Studio Code
  • Visual Studio

Visual Studio Code

De externe MCP-server configureren in Visual Studio Code:

  1. Voeg een .vscode/mcp.json bestand toe aan uw opslagplaats met de mcp.json configuratie die eerder is weergegeven.
  2. Sla het bestand op.
  3. Open GitHub Copilot in VS Code.
  4. Wanneer u hierom wordt gevraagd, moet u zich verifiëren met behulp van uw Microsoft Entra-account en uw account selecteren.

Nadat de verificatie is voltooid, wordt er een lijst met beschikbare hulpprogramma's weergegeven.

Visual Studio (2022 en hoger)

Configureer de externe MCP-server in Visual Studio door de server-URL toe te voegen aan uw MCP-instellingen. Zie Gebruik MCP-servers in Visual Studio voor meer informatie.

De verbinding controleren

Controleer na de installatie of de externe MCP-server werkt door uw AI-assistent een vraag te stellen over uw Azure DevOps gegevens.

Voorbeelden:

  • "Geef de projecten in mijn Azure DevOps organisatie weer."
  • 'Mijn toegewezen werkitems weergeven'.
  • "Welke pull requests vereisen mijn recensie?"

Als de AI-assistent resultaten van uw Azure DevOps organisatie retourneert, is de externe MCP-server correct geconfigureerd.

Troubleshooting

Issue Resolutie / Besluit
Verificatie mislukt Controleer uw Microsoft Entra referenties en bevestig dat u toegang hebt tot de Azure DevOps organisatie.
Server is niet gevonden Controleer de URL-indeling van de server: https://mcp.dev.azure.com/{organization}.
Er worden geen gegevens geretourneerd Controleer of u over de juiste machtigingen beschikt voor het project of de resources waarop een query wordt uitgevoerd.
Voorbeeld niet beschikbaar De preview wordt geleidelijk uitgerold. Kom later terug of neem contact op met de beheerder van uw organisatie.

Voor ondersteuning kunt u een probleem maken in de lokale MCP-serveropslagplaats . Zorg ervoor dat je de sjabloon Remote probleem gebruikt.

Veelgestelde vragen

Hoe zit het met andere clients, zoals GitHub Copilot CLI, Claude Desktop, Claude Code, CodeX of Cursor?

Voor extra clienthulpprogramma's zoals CodeX, Claude Desktop, Claude Code en ChatGPT is dynamische registratie van een OAuth-client-id in Entra vereist voordat ze kunnen worden gebruikt met de MCP-server. We werken nauw samen met het Entra-team om deze mogelijkheid mogelijk te maken. Voorlopig worden alleen Visual Studio en Visual Studio Code ondersteund.

Welke services kunnen Azure DevOps MCP-server gebruiken?

Ondersteuning voor andere services, waaronder Azure AI Foundry, Microsoft 365 Copilot en Copilot Studio, is nog niet beschikbaar, maar wordt binnenkort toegevoegd.

Ondersteunt de Azure DevOps MCP Server AgentId?

Ondersteuning voor AgentId is binnenkort beschikbaar.

Verwante inhoud

  • Last updated on