Nastavení vzdáleného serveru Azure DevOps MCP

Služby Azure DevOps

Vzdálený Azure DevOps MCP Server je hostovaná verze serveru Azure DevOps MCP Server, která nevyžaduje místní instalaci. Místo spuštění serveru na počítači připojíte asistenta AI přímo ke koncovému bodu hostovaného Azure DevOps pomocí streamovatelného přenosu HTTP.

Výběr vzdáleného přístupu jako první

Vzdálený server MCP použijte, když ho vaše prostředí podporuje. Doporučuje se vzdálený server, protože Azure DevOps hostitele a aktualizuje ho a nemusíte instalovat Node.js ani spravovat proces místního serveru.

Místní server MCP použijte, když se váš klient nemůže ověřit na vzdáleném serveru pomocí Microsoft Entra ID. Toto omezení se v současné době vztahuje na klienty, jako je Claude Desktop, Claude Code, Cursor a Codex. Pokyny k místnímu nastavení najdete v tématu Povolení pomoci s AI se serverem Azure DevOps MCP.

funkce Vzdálený server MCP Místní server MCP
Installation Nevyžaduje se žádná instalace. Vyžaduje Node.js 20,0+ a npx
Přeprava Streamovatelné HTTP stdio
Autentizace Microsoft Entra ID (OAuth) Azure DevOps PAT nebo Microsoft Entra ID
Hostování hostovaná služba Azure DevOps Spustí se místně na vašem počítači.
Configuration Minimální mcp.json Nastavení specifické pro prostředí

Předpoklady

Kategorie Požadavky
Azure DevOps Aktivní Azure DevOps organizace podporovaná tenantem Microsoft Entra. Samostatné organizace účet Microsoft (MSA) nejsou podporované pro vzdálené využití serveru MCP.
Permissions Členství v projektu a přístup k prostředkům, které chcete dotazovat
Prostředí Podporované prostředí pomocníka s AI (viz Podporované prostředí)

konfigurace mcp.json

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

Název organizace můžete také vynechat z adresy URL. Pokud však název organizace vynecháte, musíte ho zadat jako kontext v každém volání nástroje.

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

Nástrojové sady

Zadejte sady nástrojů, které omezí nástroje dostupné pro server MCP. Nemělo by se kombinovat s X-MCP-Tools.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Toolsets": "repos,wiki,wit"
      }
    }
  },
  "inputs": []
}
Hodnota sady nástrojů Zahrnuté nástroje
all (výchozí) Všechny nástroje kromě sad nástrojů, které vyžadují explicitní výslovný souhlas, například elm
repos Nástroje pro repozitáře a pull requesty
advsec Pokročilé nástroje pro výstrahy zabezpečení
wit Nástroje pro pracovní položky a search_workitem
pipelines Nástroje pro kanály a sestavení
wiki Nástroje wiki a search_wiki
work Iterace a nástroje pro plánování kapacity
testplan Nástroje testovacího plánu
elm Podnikové nástroje pro migraci za provozu (privátní verze Preview, explicitní výslovný souhlas)

Nástroje jen pro čtení

Pomocí hlavičky X-MCP-Readonly omezte server na operace jen pro čtení. Toto omezení je užitečné, pokud chcete zabránit změnám Azure DevOps prostředků.

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

Kombinování sad nástrojů a filtrování pouze pro čtení

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

Jednotlivé nástroje

X-MCP-Tools Záhlaví slouží k povolení pouze konkrétních nástrojů. Nemělo by se kombinovat s X-MCP-Toolsets.

Zadejte názvy nástrojů, které se zobrazí v seznamu dostupných nástrojů . U konsolidovaných nástrojů, jako wit_work_itemje například , zvolte operaci pomocí parametru action nástroje při jeho volání.

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

Zasvěcenci

Když experimentujeme a zavádíme nové nástroje a aktualizace stávajících, můžete k těmto změnám získat přednostní přístup pomocí hlavičky X-MCP-Insiders .

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

Dostupné nástroje

Poznámka:

Tento seznam nemusí vždy odrážet nejnovější aktualizace nástrojů.

Základní nástroje

Základní nástroje jsou vždy dostupné, pokud není uvedeno jinak.

nástroj Description
core_list_orgs Seznam Azure DevOps organizací, ke které má ověřený uživatel přístup
core_list_projects Výpis projektů v organizaci
core_list_project_teams Zobrazení seznamu týmů v projektu
core_list_group_members Zobrazení seznamu přímých členů a podřízených skupin skupiny Azure DevOps

Poznámka:

Hlavičku core_list_group_members můžou používat X-MCP-Insiders jenom členové programu MCP Insider.

Práce

Pracovní nástroje jsou konsolidovány do seskupených dispatcherů pomocí parametru action.

nástroj Action Description Jen pro čtení
work list_iterations Výpis všech iterací v projektu ✅
work list_team_iterations Zobrazení seznamu iterací přiřazených týmu ✅
work get_team_settings Získání nastavení týmu, včetně výchozí iterace, iterace backlogu a výchozí cesty k oblasti ✅
work get_team_capacity Získat týmovou kapacitu pro iteraci ✅
work get_iteration_capacities Získat kapacitu iterace pro všechny týmy v iteraci a projektu ✅
work_iteration_write create Vytváření iterací ❌
work_iteration_write assign Přiřazení iterací týmu ❌
work_capacity_write update Aktualizovat kapacitu člena týmu pro konkrétní iteraci ❌

Repos

Nástroje úložiště jsou sloučeny do seskupených dispatcherů pomocí parametru action.

nástroj Action Description Jen pro čtení
repo_pull_request get Získání žádosti o přijetí změn podle ID ✅
repo_pull_request list Seznam pull requestů v úložišti nebo projektu ✅
repo_pull_request list_by_commits Vyhledejte pull requesty obsahující konkrétní commit ID. ✅
repo_pull_request get_changes Získání změn souboru a volitelných rozdílů po řádcích pro iteraci žádosti o přijetí změn ✅
repo_pull_request_thread list Seznam vláken komentářů v žádosti o přijetí změn ✅
repo_pull_request_thread list_comments Výpis komentářů v určitém vlákně ✅
repo_repository get Získat úložiště podle názvu nebo ID ✅
repo_repository list Výpis úložišť v projektu ✅
repo_branch get Získejte větev podle názvu ✅
repo_branch list Seznam větví v úložišti ✅
repo_branch list_mine Zobrazit větve, do kterých aktuální uživatel nahrál změny ✅
repo_file get_content Získání textového obsahu souboru v konkrétní větvi, značce nebo potvrzení ✅
repo_file list_directory Výpis souborů a složek v adresáři s volitelným rekurzivním výpisem ✅
repo_search_commits Hledání potvrzení pomocí filtrování podle textu, autora, rozsahu dat a dalších ✅
search_code Fulltextové vyhledávání kódu ✅
repo_pull_request_write create Vytvořte pull request ❌
repo_pull_request_write update Aktualizace pull requestu, včetně nastavení automatického doplňování ❌
repo_pull_request_write update_reviewers Přidání nebo odebrání recenzentů žádostí o přijetí změn ❌
repo_pull_request_write vote Hlasovat o pull requestu ❌
repo_pull_request_thread_write create Vytvořte nové vlákno komentářů u pull requestu ❌
repo_pull_request_thread_write reply Odpověď na komentář ve vlákně ❌
repo_pull_request_thread_write update_status Aktualizace stavu vlákna komentáře ❌
repo_create_branch Vytvoření větve ❌

Duchaplnost

Nástroje pracovních položek jsou sdruženy do skupinových dispatcherů pomocí parametru action.

nástroj Action Description Jen pro čtení
wit_work_item get Získání pracovní položky podle ID ✅
wit_work_item get_batch Získání více pracovních položek podle ID ✅
wit_work_item list_comments Zobrazení komentářů k pracovní položce ✅
wit_work_item my Získání pracovních položek relevantních pro ověřeného uživatele ✅
wit_work_item list_revisions Výpis revizí pracovní položky ✅
wit_work_item list_for_iteration Seznam pracovních prvků pro iteraci týmu ✅
wit_work_item get_type Získání metadat pro typ pracovní položky ✅
wit_query get Získejte dotaz podle ID nebo cesty ✅
wit_query get_results Spustit uložený dotaz ✅
wit_query search Vyhledávací dotazy podle názvu ✅
wit_query list Výpis složek kořenových dotazů a jejich podřízených položek ✅
wit_query_by_wiql Spuštění dotazu WIQL a vrácení odpovídajících pracovních položek ✅
wit_backlog list Výpis úrovní backlogu pro tým ✅
wit_backlog list_work_items Výpis pracovních položek na konkrétní úrovni backlogu ✅
search_workitem Fulltextové vyhledávání pracovních položek ✅
wit_work_item_write create Vytvoření nové pracovní položky ❌
wit_work_item_write update Aktualizace polí u pracovní položky ❌
wit_work_item_write update_batch Aktualizace více pracovních položek v jednom volání ❌
wit_work_item_write add_child Vytvořte podřízené pracovní položky pod nadřazenou položkou ❌
wit_work_item_comment_write add Přidání komentáře k pracovní položce ❌
wit_work_item_comment_write update Aktualizace existujícího komentáře k pracovní položce ❌
wit_work_item_link_write link Propojení dvou pracovních položek ❌
wit_work_item_link_write unlink Odebrání odkazů z pracovní položky ❌
wit_work_item_link_write link_to_pull_request Propojit pracovní položku s pull requestem ❌
wit_work_item_link_write add_artifact_link Přidání odkazu na artefakty úložiště, větve, potvrzení, sestavení nebo wikiwebu k pracovní položce ❌
wit_work_item_attachment Stažení přílohy pracovní položky podle ID; vrátí obsah kódovaný v base64 včetně názvu souboru a typu MIME. ✅

Poznámka:

wit_query_by_wiql v současné době je k dispozici pouze pro účastníky programu MCP Insider pomocí hlavičky X-MCP-Insiders .

Pipelines

Nástroje pipeline jsou sloučeny do sdružených dispatcherů pomocí parametru action.

nástroj Action Description Jen pro čtení
pipelines_build list Výpis buildů s volitelnými filtry ✅
pipelines_build get_status Získejte stav, problémy a metadat sestavení pro kompilaci. ✅
pipelines_build get_changes Získání potvrzení a pracovních položek přidružených k sestavení ✅
pipelines_build_log list Seznam dostupných logů pro sestavení ✅
pipelines_build_log get_content Získání textového obsahu konkrétního protokolu podle ID ✅
pipelines_definition list Výpis definic kanálů s volitelnými filtry ✅
pipelines_definition list_revisions Výpis historie revizí pro definici kanálu ✅
pipelines_run get Získejte jednotlivé spuštění potrubí ✅
pipelines_run list Zobrazení seznamu spuštění pro kanál ✅
pipelines_artifact list Seznam artefaktů pro sestavení ✅
pipelines_artifact download Stažení pojmenovaného artefaktu sestavení ✅
pipelines_write run_pipeline Zařaďte do fronty nové spuštění kanálu. ❌
pipelines_write create_pipeline Vytvoření nové definice kanálu YAML ❌
pipelines_write update_build_stage Zrušení, opakování nebo spuštění fáze v sestavení v testovacím prostředí ❌

Wiki

Operace čtení wikiwebu se konsolidují do jednoho wiki nástroje. Pomocí parametru action vyberte operaci.

nástroj Action Description Jen pro čtení
wiki list_wikis Výpis wikiwebů v projektu nebo organizaci ✅
wiki get_wiki Získejte wiki podle identifikátoru ✅
wiki list_pages Výpis stránek na wikiwebu ✅
wiki get_page Získání obsahu a metadat stránky ✅
search_wiki Fulltextové vyhledávání wikiwebu ✅
wiki_upsert_page Vytvoření nebo aktualizace stránky wikiwebu ❌

Testovací plány

Nástroje testovacího plánu jsou sloučeny do seskupených dispečerů pomocí parametru action .

nástroj Action Description Jen pro čtení
testplan list_plans Výpis testovacích plánů v projektu ✅
testplan list_suites Výpis testovacích sad v rámci testovacího plánu ✅
testplan list_cases Vypište testovací případy v rámci testovací sady ✅
testplan_show_test_results_from_build_id Získat výsledky testů ze sestavení ✅
testplan_test_run get_results Získání výsledků pro testovací běh s volitelnými podrobnostmi a filtry výsledků ✅
testplan_test_plan_write create Vytvořte testovací plán ❌
testplan_test_suite_write create Vytvoření sady testů ❌
testplan_test_suite_write add_test_cases Přidání testovacích případů do sady ❌
testplan_test_case_write create Vytvoření testovacího případu ❌
testplan_test_case_write update_steps Aktualizace kroků testovacího případu ❌
testplan_test_run_write create_run Vytvoření testovacího spuštění pro ruční spuštění testu ❌
testplan_test_run_write update_results Aktualizace výsledků a podrobností o výsledcích testů při spuštění ❌
testplan_test_run_write complete_run Dokončení nebo přerušení testovacího spuštění na základě výsledků ❌
testplan_test_run_write update_test_point_outcome Aktualizace nebo resetování výsledků pro testovací body ❌

Pokročilé zabezpečení

Nástroje rozšířeného zabezpečení jsou sloučeny do seskupeného dispečera, který používá action parametr.

nástroj Action Description Jen pro čtení
advsec_alerts list Zobrazení seznamu upřesňujících výstrah zabezpečení pro úložiště s volitelnými filtry ✅
advsec_alerts get Získání výstrahy rozšířeného zabezpečení podle ID ✅

Podniková živá migrace (ve verzi Preview)

Nástroje Enterprise Live Migration používají parametr action ke seskupování a odesílání úloh. Přečtěte si další informace o verzi Enterprise Live Migration Preview.

Důležité

Podpora ELM na vzdáleném serveru Azure DevOps MCP je aktuálně ve verzi Preview. Tyto nástroje vyžadují, aby vaše organizace měla přístup k verzi ELM Limited Public Preview. Pokud potřebujete přístup, další informace najdete v přehledu migrace za provozu organizace .

nástroj Action Description Jen pro čtení
enterprise_live_migration list Výpis migrací pro organizaci; volitelný filtr projektu a příznak includeAllMigrations ✅
enterprise_live_migration get Získání stavu migrace pro úložiště ✅
enterprise_live_migration get_cutover_review Získat neúspěšné nebo blokované položky před přepnutím ✅
enterprise_live_migration get_device_flow_config Získání konfigurace toku zařízení pro aplikaci GitHub ✅
enterprise_live_migration list_pipelines Seznam pipeline a stav přepojení ✅
enterprise_live_migration_write create Vytvoření nové migrace ❌
enterprise_live_migration_write pause Pozastavení aktivní migrace ❌
enterprise_live_migration_write resume Obnovení pozastavené migrace ❌
enterprise_live_migration_write cutover_set Naplánujte datum přepnutí ❌
enterprise_live_migration_write cutover_cancel Zrušit plánované přepnutí ❌
enterprise_live_migration_write approve_cutover Přijmout selhání a pokračovat v přepnutí ❌
enterprise_live_migration_write abandon Trvalé odstranění migrace ❌
enterprise_live_migration_pipelines_write submit Odeslat kanály k přepojení ❌
enterprise_live_migration_pipelines_write update Aktualizace konfigurace přepojení pipeline ❌
enterprise_live_migration_pipelines_write delete Odstraňte všechny klony kanálů v rámci migrace terminálu ❌

Nástroje Enterprise Live Migration jsou ve výchozím nastavení zakázány. Vzhledem k tomu, že podpora ELM na vzdáleném serveru MCP je ve verzi Preview, vyžadují, aby vaše organizace měla přístup k verzi PUBLIC Preview s omezeným přístupem k ELM. Pokud chcete povolit nástroje ELM, použijte hlavičku X-MCP-Toolsetselm s hodnotou:

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

Podporovaná prostředí

Vzdálený Azure DevOps MCP Server vyžaduje, aby se váš uživatelský účet a Azure DevOps organizace připojila k Microsoft Entra ID.

Ne všichni klienti MCP ve výchozím nastavení podporují ověřování Microsoft Entra. Některá prostředí vyžadují k registraci klientské aplikace další kroky.

Podporovaná prostředí pro vzdálený koncový bod, pokud je k dispozici Microsoft Entra ověřování, patří:

  • Visual Studio s GitHub Copilot
  • Visual Studio
  • Microsoft Foundry
  • Microsoft Copilot Studio
  • rozhraní příkazového řádku GitHub Copilot
  • Aplikace GitHub Copilot

Důležité

Claude Desktop, Claude Code, Cursor a Codex v současné době nepodporují tok ověřování Microsoft Entra vyžadovaný vzdáleným Azure DevOps MCP Serverem. Použijte místní server MCP s těmito klienty.

Visual Studio Code

Konfigurace vzdáleného serveru MCP v Visual Studio Code:

  1. .vscode/mcp.json Přidejte do úložiště soubor s konfigurací mcp.json zobrazenou dříve.
  2. Uložte soubor.
  3. Otevřete GitHub Copilot v editoru VS Code.
  4. Po zobrazení výzvy se ověřte pomocí účtu Microsoft Entra a vyberte svůj účet.

Po dokončení ověřování se zobrazí seznam dostupných nástrojů.

Visual Studio (2022 a novější)

Nakonfigurujte vzdálený server MCP v Visual Studio přidáním adresy URL serveru do nastavení MCP. Další informace najdete v tématu Použití serverů MCP v Visual Studio.

Ověření připojení

Po nastavení ověřte, že vzdálený server MCP funguje, a to tak, že asistentovi AI položíte otázku týkající se vašich Azure DevOps dat.

Příklady:

  • V mé organizaci Azure DevOps vypište projekty.
  • Zobrazit přiřazené pracovní položky
  • Jaké pull requesty vyžadují moji recenzi?

Pokud pomocník s AI vrátí výsledky z vaší organizace Azure DevOps, je vzdálený server MCP správně nakonfigurovaný.

Použití AI k ověření a řešení potíží se vzdáleným nastavením MCP

Následující ukázkové prompty pro Copilot Chat vám pomohou zvolit správný přístup k MCP, nakonfigurovat a ověřit vzdálenou konfiguraci, vylepšit prompty pro každodenní používání a v případě potřeby řešit selhání. Tyto výzvy zkopírujte a vložte do Copilot Chat a zástupné symboly nahraďte skutečnými podrobnostmi o organizaci, klientovi a chybě.

Task Příklad výzvy
Volba vzdáleného a místního prostředí For my environment and client tools, help me decide whether to use the remote Azure DevOps MCP Server or the local server, and explain the tradeoffs.
Sestavení konfigurace s nejnižšími oprávněními Generate a remote mcp.json configuration for organization <contoso> that uses only the needed toolsets and read-only mode.
Ověřit nastavení mcp.json Review this remote Azure DevOps MCP server configuration and tell me whether anything is missing or incorrect for Visual Studio Code.
Ověření předpokladů ověřování Help me verify whether this remote MCP setup can authenticate with Microsoft Entra ID for organization <contoso>.
Vylepšení výzev k dotazům pro každodenní práci Give me better prompt wording to reliably fetch fresh Azure DevOps data from remote MCP for project <project-name>, including how to avoid stale results.
Diagnostikovat odmítnuté připojení I'm getting Connection Refused when connecting to https://mcp.dev.azure.com/<organization>. Give me step-by-step network, proxy, and firewall checks to fix it.
Diagnostika chybějících dat The remote MCP server connects, but queries return no data. Help me determine whether this is a permissions issue or missing project context.
Záhlaví filtrování nástrojů pro ladění Check my X-MCP-Toolsets and X-MCP-Tools header configuration and explain why expected tools are not appearing.

Copilot využívá AI, takže překvapení a chyby jsou možné. Další informace najdete v tématu Copilot nejčastější dotazy k obecnému použití.

Troubleshooting

Issue Resolution
Selhání ověřování Ověřte přihlašovací údaje Microsoft Entra a ověřte, že máte přístup k organizaci Azure DevOps.
Server nebyl nalezen. Zkontrolujte formát adresy URL serveru: https://mcp.dev.azure.com/{organization}.
Připojení odmítnuto Ověřte, že vaše síť umožňuje odchozí https do mcp.dev.azure.com. Pokud používáte firemní proxy server nebo firewall, požádejte správce, aby přidal koncový bod na seznam povolených, a zkuste to znovu bez VPN, abyste vyloučili problémy v síťové trase.
Nevracená žádná data Ověřte, že máte odpovídající oprávnění pro dotazovaný projekt nebo zdroje.
Nástroje ELM nejsou po nastavení k dispozici X-MCP-Toolsets: elm Podpora ELM na vzdáleném serveru MCP je v privátní verzi Preview a není povolená pro všechny organizace. Nastavení X-MCP-Toolsets: elm je nezbytné, ale nestačí – vaše organizace musí být také zaregistrovaná v privátní verzi Preview ELM. Chcete-li požádat o přístup, obraťte se na správce vaší organizace nebo si přečtěte Přehled podnikových migrací za provozu.

Pokud potřebujete podporu, můžete vytvořit problém v místním úložišti serveru MCP . Nezapomeňte použít šablonu Remote issue.

časté otázky

A co ostatní klienti, jako je Claude Desktop, Claude Code, Codex nebo Cursor?

Claude Desktop, Claude Code, Codex a Cursor vyžadují dynamickou registraci ID klienta OAuth v Microsoft Entra ID předtím, než budou moct používat vzdálený server MCP. Microsoft Entra ID aktuálně nepodporuje tok dynamické registrace klientů, které tito klienti vyžadují. Použijte místní server MCP s těmito klienty.

Související obsah

  • Last updated on