🔷 Azure Devops MCP Replacement For OpenClaw — 管理Azure DevOps
v1.0.1通过直接 REST API 调用与 Azure DevOps 交互,可列出项目、团队、仓库、工作项、冲刺/迭代,支持项目级或团队级范围查询,并新增成员与站立会议功能。
0· 370·1 当前·1 累计
安全扫描
OpenClaw
安全
high confidence技能代码、所需二进制文件与环境变量均与其声明的调用 Azure DevOps REST API 目的一致,未请求无关凭据或安装任意第三方代码,仅存在关于 PAT 作用域与打包的轻微文档不一致。
安全有层次,运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.12026/3/8
**Added support for team member and people operations in Azure DevOps skill.** - Added `scripts/people.js` for team member tracking, workloads, and daily standup summaries. - Introduced `team-config.json` for persistent team member configuration. - Updated usage docs with new commands for standup and capacity tracking by person or team. - Expanded documentation and endpoint references for all new people-related features.
● 无害
安装命令
点击复制官方npx clawhub@latest install azure-devops-mcp-replacement-for-openclaw
🇨🇳 镜像加速npx clawhub@latest install azure-devops-mcp-replacement-for-openclaw --registry https://cn.longxiaskill.com
技能文档
此技能通过使用 Node.js 脚本直接调用 Azure DevOps REST API 将 OpenClaw 连接到 Azure DevOps。无需 MCP 服务器,无需 npm install — 仅使用 Node.js 内置模块。
设置
必需的环境变量
| 变量 | 描述 |
|---|---|
AZURE_DEVOPS_ORG | 仅填写组织名称 — 例如 contoso(不要填写完整 URL) |
AZURE_DEVOPS_PAT | 个人访问令牌(请参阅下方的 scopes) |
export AZURE_DEVOPS_ORG=contoso
export AZURE_DEVOPS_PAT=your-pat-here
所需的 PAT scopes
在 Azure DevOps 中创建 PAT(用户设置 → 个人访问令牌)时,请启用以下选项:
| PAT scope 标签 | 覆盖范围 |
|---|---|
| Work Items – Read (vso.work) | 迭代、冲刺、看板、工作项、WIQL 查询 |
| Project and Team – Read (vso.project) | 项目列表、团队列表 |
| Code – Read (vso.code) | 代码仓库、Pull Request |
| Build – Read (vso.build) | 流水线、构建 |
| Test Management – Read (vso.test) | 测试计划、测试套件 |
| Wiki – Read & Write (vso.wiki) | Wiki 页面 |
⚠️ "Team Dashboard" scope 不包含冲刺或迭代。你需要 Work Items – Read 才能访问这些内容。
ADO 层级结构参考
了解层级结构可避免 401 错误:
Organization (AZURE_DEVOPS_ORG)
└── Project 例如 "B2B Pharmacy Mob"
└── Team 例如 "B2B_New_Design" ← 团队存在于项目内部
└── Sprint/Iteration 例如 "F09-03 T26-03-26"
└── Work Items(用户故事、Bug、任务……)
- 团队不是子项目。它们是项目内的命名组,有自己订阅的冲刺和区域路径集。
- 项目有一个项目级迭代树(所有曾经定义的冲刺路径)。每个团队订阅这些路径的子集。
- 要获取特定团队(如
B2B_New_Design)的冲刺或工作项,你必须在 API 调用中同时传递project和team。
外部端点
| 端点 | 使用者 |
|---|---|
https://dev.azure.com/{org}/_apis/projects | projects.js |
https://dev.azure.com/{org}/_apis/projects/{project}/teams | teams.js list |
https://dev.azure.com/{org}/{project}/_apis/wit/classificationnodes/iterations | teams.js sprints(项目级) |
https://dev.azure.com/{org}/{project}/{team}/_apis/work/teamsettings/iterations | teams.js sprints --team, iterations |
https://dev.azure.com/{org}/{project}/_apis/wit/wiql | workitems.js list, query |
https://dev.azure.com/{org}/{project}/{team}/_apis/wit/wiql | workitems.js list --team, query --team |
https://dev.azure.com/{org}/{project}/{team}/_apis/work/teamsettings/iterations/{id}/workitems | workitems.js current-sprint, sprint-items |
https://dev.azure.com/{org}/{project}/_apis/git/repositories | repos.js |
https://dev.azure.com/{org}/{project}/_apis/pipelines | pipelines.js |
https://dev.azure.com/{org}/{project}/_apis/build/builds | builds.js |
https://dev.azure.com/{org}/{project}/_apis/wiki/wikis | wiki.js |
https://dev.azure.com/{org}/{project}/_apis/testplan/plans | testplans.js |
常见错误
| 错误 | 原因 | 修复方法 |
|---|---|---|
团队列表返回 HTTP 401 | 端点错误 — 旧代码使用 /{project}/_apis/teams | 正确应为 /_apis/projects/{project}/teams?api-version=7.1-preview.3 |
迭代返回 HTTP 401 | PAT 缺少 Work Items – Read 作用域 | 使用 vso.work 重新创建 PAT |
团队列表返回 HTTP 401 | PAT 缺少 Project and Team – Read 作用域 | 使用 vso.project 重新创建 PAT |
| 未找到活动冲刺 | 团队没有订阅 timeframe=current 的迭代 | 在 ADO 中检查冲刺日期 → 项目设置 → 团队配置 |
| 团队名称错误 | ADO 中的团队名称区分大小写 | 运行 teams.js list 获取准确名称 |
| 未找到组织 | AZURE_DEVOPS_ORG 设置为完整 URL | 只使用组织名称,例如 contoso 而不是 https://dev.azure.com/contoso |
team-config.json not found | people.js 找不到配置文件 | 运行 node people.js setup 获取准确路径,然后编辑它 |
| 某人的事项显示为 0 | 配置中的邮箱与 ADO 不匹配 | 在 ADO 中打开分配给该人员的工作事项,将鼠标悬停在头像上获取准确的邮箱 |
utilisationPct 为 null | 工作事项未设置原始估算 | 请团队在 ADO 中估算事项;容量计算需要小时数 |
数据来源:ClawHub ↗ · 中文优化:龙虾技能库