适合谁
- 已经在使用 Azure DevOps 管理工作项、代码仓库、Wiki 或管道的团队
- 使用 VS Code + GitHub Copilot(或其他支持 MCP 的客户端)的开发者
- 希望通过自然语言查询/操作 Azure DevOps 而无需手写 REST API 调用的场景
A
64FMRS · C
微软官方维护的 Azure DevOps MCP 服务器,提供远程(推荐)和本地两种接入方式,覆盖项目、工作项、仓库、Wiki、测试计划和管道等核心场景;需要 Microsoft 账号登录且工具集较大,建议按需通过工具域裁剪,并留意近期工具重命名带来的兼容性影响。
由 Microsoft 官方维护的 MCP 服务器,将 AI 代理连接到 Azure DevOps,可访问组织、项目、看板/工作项、代码仓库、Wiki、测试计划和管道。推荐使用无需安装的远程 streamable-HTTP 端点(mcp.dev.azure.com/{organization}),也提供可选的本地 Node.js/npm stdio 服务器,并可通过“域”(domains)按需加载工具分组,如 core、work、work-items、search、test-plans、repositories、wiki、pipelines、advanced-security。
工具能力
暂未整理工具清单。
安装接入
推荐方式(远程,免安装):在 .vscode/mcp.json 中添加类型为 http、地址为 https://mcp.dev.azure.com/{organization} 的服务器配置,在 VS Code 的 MCP 视图中启动即可,首次调用工具时会弹出浏览器要求用匹配组织的 Microsoft 账号登录。
可选方式(本地 stdio):需先安装 Node.js 20+,在 .vscode/mcp.json 中配置 command 为 npx、args 为 ["-y", "@azure-devops/mcp", "${input:ado_org}"] 的 stdio 服务器,保存后在 VS Code 中启动,并在 Agent 模式下选择所需工具;可用 -d 参数(如 "-d", "core", "work", "work-items")限定加载的工具域,建议始终启用 core 域。
claude_desktop_config.json
{
"inputs": [
{
"id": "ado_org",
"type": "promptString",
"description": "Azure DevOps organization name (e.g. 'contoso')"
}
],
"servers": {
"ado": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@azure-devops/mcp", "${input:ado_org}"]
}
}
}
选型与风险
不适合谁
- 不使用 Azure DevOps、仅用 GitHub 或其他项目管理工具的团队
- 需要开箱即用、无需选择工具域或登录授权的极简服务器场景
- 对预览阶段功能稳定性要求很高、无法容忍工具改名等破坏性变更的场景(README 提到近期发生过工具整体重命名)
所需权限
- 需要用与目标 Azure DevOps 组织匹配的 Microsoft 账号完成 OAuth 浏览器登录(远程与本地均适用)
- 本地服务器还支持通过 --authentication azcli 等方式进行身份验证
- 需要提供 Azure DevOps 组织标识符(organization,如 'contoso')
- 本地模式下可通过环境变量设置默认 project 和 team 以跳过选择提示
风险与副作用
- 工具覆盖面广,可能允许修改 Wiki 页面、工作项等组织数据,需确认登录账号权限范围合适
- 远程服务器处于预览阶段,功能和问题跟踪仍在完善中
- 近期发生过工具整体重命名(consolidation),可能对已有 Agent/技能造成破坏性变更,需按文档确认新工具名或临时锁定旧版本
- 本地服务器需要 Node.js 20+ 环境,版本不符会导致安装或运行失败
常见排障
- 确认 mcp.json 中的组织标识符(organization)拼写正确且与登录账号所属组织一致
- 首次使用工具时留意浏览器弹出的登录窗口,确保使用匹配所选组织的 Microsoft 账号登录
- 本地模式下确认已启用所需的工具域(-d 参数),核心信息依赖 core 域
- 若遇到工具找不到或行为异常,检查是否受近期工具重命名影响,参考 docs/TOOLSET.md 或临时锁定 @azure-devops/[email protected]
- 查阅仓库 docs/TROUBLESHOOTING.md 和 docs/FAQ.md 获取常见问题排查步骤
使用场景
列出我的 Azure DevOps 项目
列出某项目的构建(Builds)、代码仓库或测试计划
列出某项目的团队和迭代
查看当前迭代下我的或团队的工作项
列出、创建或更新项目 Wiki 页面并获取其内容
支持客户端
Visual Studio Code完整支持