Konfigurera den fjärranslutna Azure DevOps MCP-servern (förhandsversion)

Azure DevOps-tjänster

Viktigt!

Den fjärranslutna Azure DevOps MCP-servern är för närvarande i offentlig förhandsversion. Förhandsgranskningsfunktioner kan ha begränsade funktioner och kan ändras innan den allmänna tillgängligheten.

Stöd

  • Supporten är för närvarande begränsad till problem som skickas via den lokala MCP Server-lagringsplatsen.
  • Om du vill skicka en supportbegäran skapar du ett problem med hjälp av mallen för mcp-fjärrserverproblem.

Den fjärranslutna Azure DevOps MCP-servern är en värdbaserad version av Azure DevOps MCP Server som inte kräver någon lokal installation. I stället för att köra servern på datorn ansluter du AI-assistenten direkt till den Azure DevOps-värdbaserade slutpunkten med hjälp av strömmande HTTP-transport.

Fjärrservern har samma funktioner som den lokala servern, inklusive åtkomst till arbetsobjekt, pull-begäranden, pipelines med mera, samtidigt som den lokala konfigurationskomplexiteten elimineras.

Fjärr- eller lokal MCP-server

Feature Fjärr-MCP Server (förhandsversion) Lokal MCP-server
Installation Ingen installation krävs Kräver Node.js 20.0+ och npx
Transport Strömmande HTTP stdio
autentisering Microsoft Entra ID (OAuth) Azure DevOps PAT eller Microsoft Entra ID
Webbhotell Azure DevOps värdbaserad tjänst Körs lokalt på datorn
Konfiguration Minimal mcp.json Miljöspecifik konfiguration
Status Offentlig förhandsversion Allmänt tillgängligt

Förutsättningar

Kategori Requirements
Azure DevOps En aktiv Azure DevOps organisation ansluten till Microsoft Entra ID
Behörigheter Medlemskap i projektet och åtkomst till de resurser du vill fråga
Miljö En AI-assistentmiljö som stöds (se Miljöer som stöds)

Konfiguration av mcp.json

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

Du kan också utelämna organisationsnamnet från URL:en. Men om du utelämnar organisationsnamnet måste du ange det som kontext i varje verktygsanrop.

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

Verktygsuppsättningar

Ange verktygsuppsättningar för att begränsa de verktyg som är tillgängliga för MCP-servern. Ska inte kombineras med X-MCP-Tools.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Toolsets": "repos,wiki,wit"
      }
    }
  },
  "inputs": []
}
Verktygsvärde Inkluderade verktyg
all (standard) Alla verktyg från varje verktygsuppsättning
repos Verktyg för lagringsplats och pull-begäran
wit Verktyg för arbetsobjekt och search_workitem
pipelines Flödes- och byggverktyg
wiki Wiki-verktyg och search_wiki
work Itererings- och kapacitetsverktyg
testplan Verktyg för testplaner

Skrivskyddade verktyg

Använd X-MCP-Readonly-huvudet för att begränsa servern till skrivskyddade åtgärder. Den här begränsningen är användbar när du vill förhindra ändringar av Azure DevOps resurser.

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

Kombinera verktygsuppsättningar och skrivskyddad filtrering

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

Enskilda verktyg

X-MCP-Tools Använd rubriken om du bara vill aktivera specifika verktyg. Ska inte kombineras med 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

När vi experimenterar och introducerar nya verktyg och uppdateringar för befintliga kan du få tidig åtkomst till dessa ändringar med hjälp X-MCP-Insiders av rubriken.

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

Tillgängliga verktyg

Anmärkning

Den här listan kanske inte alltid återspeglar de senaste verktygsuppdateringarna.

Kärnverktyg

Kärnverktyg är alltid tillgängliga.

Verktyg Beskrivning
core_list_orgs Lista Azure DevOps organisationer som den autentiserade användaren har åtkomst till
core_list_projects Lista projekten i en organisation
core_list_project_teams Lista grupper i ett projekt

Arbete

Arbetsverktygen konsolideras i grupperade dispatchers med hjälp av en action parameter.

Verktyg Action Beskrivning skrivskyddad
work list_iterations Visa en lista över alla iterationer i ett projekt
work list_team_iterations Lista iterationer som tilldelats ett team
work get_team_settings Hämta gruppinställningar, inklusive standarditerationen, backloggiterationen och standardsökvägen för område
work get_team_capacity Hämta teamkapacitet för en iteration
work get_iteration_capacities Hämta kapaciteten för en iteration för alla team i iterationen och projektet
work_iteration_write create Skapa iterationer
work_iteration_write assign Tilldela iterationer till ett team
work_capacity_write update Uppdatera teamkapaciteten för en gruppmedlem för en specifik iteration

Repos

Lagringsplatsverktygen samlas i grupperade anropshanterare med parametern action.

Verktyg Action Beskrivning skrivskyddad
repo_pull_request get Hämta en pull request med ID
repo_pull_request list Lista pull-begäranden i en lagringsplats eller ett projekt
repo_pull_request list_by_commits Hitta pull request som innehåller specifika commit-ID:n
repo_pull_request_thread list Lista kommentarstrådar på en pull-begäran
repo_pull_request_thread list_comments Visa kommentarer i en specifik tråd
repo_repository get Hämta en lagringsplats efter namn eller ID
repo_repository list Lista lagringsplatser i ett projekt
repo_branch get Hämta en gren efter namn
repo_branch list Visa en lista över grenar på en lagringsplats
repo_branch list_mine Lista grenar som den aktuella användaren har pushat till
repo_file get_content Hämta textinnehållet i en fil vid en specifik gren, tagg eller commit.
repo_file list_directory Visa en lista över filer och mappar i en katalog med valfri rekursiv lista
repo_search_commits Sök åtaganden med filtrering efter text, författare, datumintervall och mer
repo_pull_request_write create Skapa en pull-begäran
repo_pull_request_write update Uppdatera en pull-förfrågan, inklusive att ställa in automatisk komplettering
repo_pull_request_write update_reviewers Lägga till eller ta bort granskare av pull-begäranden
repo_pull_request_write vote Rösta på en dragbegäran
repo_pull_request_thread_write create Skapa en ny kommentarstråd i en pull-förfrågan
repo_pull_request_thread_write reply Svara på en kommentar i en tråd
repo_pull_request_thread_write update_status Uppdatera status för en kommentarstråd
repo_create_branch Skapa en gren

Wit

Arbetsobjektverktygen konsolideras i grupperade dispatchers med hjälp av en action parameter.

Verktyg Action Beskrivning skrivskyddad
wit_work_item get Hämta ett arbetsobjekt efter ID
wit_work_item get_batch Hämta flera arbetsobjekt efter ID:t
wit_work_item list_comments Visa en lista med kommentarer om ett arbetsobjekt
wit_work_item my Hämta arbetsobjekt som är relevanta för den autentiserade användaren
wit_work_item list_revisions Visa en lista över revisioner av ett arbetsobjekt
wit_work_item list_for_iteration Visa en lista över arbetsobjekt för en team-iteration
wit_work_item get_type Hämta metadata för en typ av arbetsobjekt
wit_query get Hämta en fråga efter ID eller sökväg
wit_query get_results Köra en sparad fråga
wit_backlog list Lista kvarvarande nivåer för ett team
wit_backlog list_work_items Lista arbetsobjekt på en specifik backlognivå
search_workitem Fulltextsökning av arbetsobjekt
wit_work_item_write create Skapa ett nytt arbetsobjekt
wit_work_item_write update Uppdatera fält på ett arbetsobjekt
wit_work_item_write update_batch Uppdatera flera arbetsobjekt i ett anrop
wit_work_item_write add_child Skapa underordnade arbetsobjekt under en överordnad
wit_work_item_comment_write add Lägga till en kommentar i ett arbetsobjekt
wit_work_item_comment_write update Uppdatera en befintlig kommentar om ett arbetsobjekt
wit_work_item_link_write link Länka två arbetsobjekt
wit_work_item_link_write unlink Ta bort länkar från ett arbetsobjekt
wit_work_item_link_write link_to_pull_request Länka ett arbetsobjekt till en pull-begäran
wit_work_item_link_write add_artifact_link Lägga till en länk för lagringsplats, gren, incheckning eller kompilering av artefakt till ett arbetsobjekt
wit_work_item_attachment Ladda ned en bilaga till ett arbetsobjekt med ID; returnerar base64-kodat innehåll med filnamn och MIME-typ

Anmärkning

wit_query_by_wiql är för närvarande endast tillgängligt för MCP Insiders med hjälp av rubriken X-MCP-Insiders.

Pipelines

Pipelineverktygen konsolideras till grupperade dispatchers med hjälp av parametern action.

Verktyg Action Beskrivning skrivskyddad
pipelines_build list Lista versioner med valfria filter
pipelines_build get_status Hämta status, problem och rapportmetadata för en version
pipelines_build get_changes Hämta incheckningar och arbetsobjekt som är associerade med ett build
pipelines_build_log list Lista tillgängliga loggar för en build
pipelines_build_log get_content Hämta textinnehållet i en specifik logg efter ID
pipelines_definition list Lista pipelinedefinitioner med valfria filter
pipelines_definition list_revisions Visa en lista över revisionshistorik för en pipelinedefinition
pipelines_run get Hämta en enda pipelinekörning
pipelines_run list Lista körningar för en pipeline
pipelines_artifact list Lista artefakter för en build
pipelines_artifact download Ladda ned en namngiven byggartefakt
pipelines_write run_pipeline Schemalägg en ny pipelinekörning
pipelines_write create_pipeline Skapa en ny YAML-pipelinedefinition
pipelines_write update_build_stage Avbryt, försök igen eller kör en fas i ett bygge under flygning

Wiki

Wiki-läsåtgärderna konsolideras till ett enda wiki verktyg. Använd parametern action för att välja åtgärden.

Verktyg Action Beskrivning skrivskyddad
wiki list_wikis Lista wikis i ett projekt eller en organisation
wiki get_wiki Hämta en wiki efter identifierare
wiki list_pages Visa en lista över sidor i en wiki
wiki get_page Hämta sidinnehåll och metadata
search_wiki Wiki-sökning i fulltext
wiki_upsert_page Skapa eller uppdatera en wiki-sida

Testplaner

Testplansverktygen konsolideras i grupperade dispatchers med hjälp av en action parameter.

Verktyg Action Beskrivning skrivskyddad
testplan list_plans Lista testplaner i ett projekt
testplan list_suites Visa en lista över testpaket under en testplan
testplan list_cases Lista testfall i en testsvit
testplan_show_test_results_from_build_id Hämta testresultat från en build
testplan_test_plan_write create Skapa en testplan
testplan_test_suite_write create Skapa en testsvit
testplan_test_suite_write add_test_cases Lägga till testfall i en svit
testplan_test_case_write create Skapa ett testfall
testplan_test_case_write update_steps Uppdatera steg i testfall
Verktyg Beskrivning skrivskyddad
search_code Fulltextkodssökning.
search_wiki Wiki-sökning i fulltext.
search_workitem Fulltextsökning av arbetsobjekt.

Miljötyper som stöds

Den fjärranslutna Azure DevOps MCP-servern kräver att ditt användarkonto och Azure DevOps organisation ansluter till Microsoft Entra ID.

Alla MCP-klienter stöder inte Microsoft Entra autentisering som standard. Vissa miljöer kräver extra steg för att registrera klientprogrammet.

För närvarande stöds miljöer:

  • Visual Studio Code
  • Visual Studio

Visual Studio Code

Så här konfigurerar du den fjärranslutna MCP-servern i Visual Studio Code:

  1. Lägg till en .vscode/mcp.json-fil på lagringsplatsen med den mcp.json-konfiguration som visats tidigare.
  2. Spara filen.
  3. Öppna GitHub Copilot i VS Code.
  4. När du uppmanas till det autentiserar du med ditt Microsoft Entra konto och väljer ditt konto.

När autentiseringen är klar visas en lista över tillgängliga verktyg.

Visual Studio (2022 och senare)

Konfigurera den fjärranslutna MCP-servern i Visual Studio genom att lägga till server-URL:en i MCP-inställningarna. Mer information finns i Använda MCP-servrar i Visual Studio.

Verifiera anslutningen

Efter installationen kontrollerar du att mcp-fjärrservern fungerar genom att ställa en fråga till AI-assistenten om dina Azure DevOps data.

Exempel:

  • "Lista projekten i min Azure DevOps organisation."
  • "Visa mina tilldelade arbetsobjekt."
  • "Vilka pull-begäranden kräver min granskning?"

Om AI-assistenten returnerar resultat från din Azure DevOps organisation är den fjärranslutna MCP-servern korrekt konfigurerad.

Felsökning

Issue Åtgärd
Autentiseringen misslyckas Verifiera dina Microsoft Entra-autentiseringsuppgifter och bekräfta att du har åtkomst till Azure DevOps-organisationen.
Servern hittades inte Kontrollera serverns URL-format: https://mcp.dev.azure.com/{organization}.
Inga data returnerades Bekräfta att du har rätt behörigheter för projektet eller resurserna som efterfrågas.
Förhandsversionen är inte tillgänglig Förhandsversionen lanseras gradvis. Kom tillbaka senare eller kontakta organisationsadministratören.

För support kan du skapa ett problem på den lokala MCP Server-lagringsplatsen. Se till att använda mallen Fjärrproblem .

Vanliga frågor och svar

Hur är det med andra klienter som GitHub Copilot CLI, Claude Desktop, Claude Code, CodeX eller Cursor?

Andra klientverktyg som CodeX, Claude Desktop, Claude Code och ChatGPT kräver dynamisk registrering av ett OAuth-klient-ID i Microsoft Entra innan de kan användas med MCP-servern. Vi har ett nära samarbete med Microsoft Entra-teamet för att aktivera den här funktionen. För tillfället stöds endast Visual Studio och Visual Studio Code.

Vilka tjänster kan använda Azure DevOps MCP Server?

Stöd för andra tjänster, inklusive Azure AI Foundry, Microsoft 365 Copilot och Copilot Studio, är ännu inte tillgängligt men kommer att läggas till snart.

Supporterar Azure DevOps MCP Server AgentId?

AgentId-supporten kommer snart.