Azure Boards MCP

azure-board-mcp

适用于 Azure DevOps 的 MCP 服务。可直接通过 Claude、Cursor 或任何兼容 MCP 的 AI 处理任务、迭代、Bug、拉取请求、代码库和管道。

---

快速开始

# 1. Configure your editors (Claude Code, Cursor, VS Code, Claude Desktop)
npx azure-board-mcp install

# 2. Sign in once
npx azure-board-mcp authenticate

# 3. Restart your editor — done

首次使用时，AI 会询问要使用哪个 Azure DevOps 项目，并记住该项目。

---

安装与身份验证

浏览器登录（默认）

npx azure-board-mcp authenticate

打开浏览器以登录 Microsoft。从列表中选择组织。无需设置 Azure AD 应用——使用的是内置于软件包中的共享应用注册。

PAT — 个人访问令牌

适用于无头 / CI 环境，或阻止第三方 OAuth 的组织：

npx azure-board-mcp authenticate --pat

在 https://dev.azure.com/{org}/_usersSettings/tokens 创建 PAT，并授予以下范围：工作项（读取和写入）、生成（读取）、代码（读取）。

---

编辑器设置

选项 A — 自动（推荐）

npx azure-board-mcp install

自动检测并配置 Claude Code、Cursor、VS Code 和 Claude Desktop。

选项 B — 手动

Claude Code（~/.claude/settings.json）：

{
  "mcpServers": {
    "azure": {
      "command": "npx",
      "args": ["-y", "azure-board-mcp@latest"]
    }
  }
}

Cursor（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "azure": {
      "command": "npx",
      "args": ["-y", "azure-board-mcp@latest"]
    }
  }
}

VS Code（用户 settings.json）：

{
  "mcp": {
    "servers": {
      "azure": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "azure-board-mcp@latest"]
      }
    }
  }
}

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "azure": {
      "command": "npx",
      "args": ["-y", "azure-board-mcp@latest"]
    }
  }
}

---

Claude Code 技能

安装技能，让 Claude 自动了解何时使用此 MCP：

npx azure-board-mcp skills

此操作会安装 ~/.claude/skills/azure-board-mcp/SKILL.md。重启 Claude Code 后，每当你询问任务、迭代、PR、构建等内容时，它都会主动使用 Azure DevOps 工具。

---

CLI 参考

npx azure-board-mcp <command>

COMMANDS
  install               Auto-configure MCP in detected editors
  skills                Install the Claude Code skill
  authenticate          Browser OAuth sign-in
  authenticate --pat    Personal Access Token sign-in
  check                 Validate stored credentials
  logout                Clear stored credentials
  help                  Show help

AUTHENTICATE FLAGS
  --pat                 Use PAT instead of browser OAuth
  --read-only           Request read-only OAuth scopes
  --client-id <id>      Use your own Azure AD app
  --tenant-id <id>      Specify tenant (single-tenant apps only)

---

工具（30）

工作项、提交和 PR 列表支持分页——每次返回紧凑的页面， 默认 15 条，最多 50 条，并附带 Showing X–Y of N 标题。传入 skip 可翻页 浏览结果，而无需请求较大的 top。列表视图仅获取其显示所需的 字段，因此速度快且占用的上下文少。

身份验证与项目

工具	使用场景
auth_status	排查身份验证问题，检查当前激活的项目
switch_project	更改当前激活的项目，或列出可用项目

工作项

工具	使用场景
list_work_items	查看我的任务、迭代看板，按状态 / 类型 / 关键词筛选（分页）
get_work_item	查看特定工单的完整详情——字段、评论、PR
create_work_item	创建任务、Bug、用户故事、史诗、功能
update_work_item	关闭、重新分配、移至迭代、更新估算
add_comment	在工单上发布备注或状态更新
link_work_items	设置父子、相关或依赖关系链接
query_wiql	使用自定义 WIQL 进行高级查询（分页）
get_work_item_history	审计记录——哪些字段在何时由谁更改
get_backlog	按优先级排序的有序产品待办列表

看板、迭代与团队

工具	使用场景
get_sprint	查看当前迭代日期和团队容量
list_sprints	查看所有迭代及其开始 / 结束日期
get_board	查看 Kanban 列、状态映射和 WIP 限制
list_team_members	查看团队成员（姓名、电子邮件、管理员标记）
list_paths	获取创建 / 更新时有效的区域 / 迭代路径值

代码库

工具	使用场景
list_repos	查找代码库名称和 URL
list_files	浏览目录结构
get_file	读取文件内容（最多 500 行）
list_commits	查看分支上的近期提交（分页）
list_pull_requests	查看未关闭的 PR、审阅者投票和合并状态（分页）
create_pr	创建 PR，可选添加审阅者并关联工作项

流水线、构建与发布

工具	适用场景
list_pipelines	查找流水线定义
list_builds	查看近期构建，包括状态、结果、分支和链接
run_pipeline	触发流水线运行
get_build_timeline	查看失败的阶段／作业／任务，以及错误和警告数量
get_build_logs	诊断构建失败（构建输出）
cancel_build	取消正在进行的构建
list_releases	查看近期发布及各环境的部署状态
create_release	根据定义创建并触发发布

---

环境变量

覆盖已存储的凭据——适用于 CI/Docker：

AZURE_ORG=my-org
AZURE_PROJECT=my-project
AZURE_PAT=my-pat        # PAT auth
AUTH_TOKEN=my-token     # OAuth bearer token

---

使用自己的 Azure AD 应用

默认情况下，所有人共用内置的应用注册。如果你的组织阻止使用该应用，或者你需要完全掌控：

1. 注册应用

1. Azure Portal → 应用注册 → 新注册
2. 名称：任意（例如 azure-board-mcp）
3. 支持的帐户类型：“任何组织目录”（多租户）或**“仅限我的组织”**
4. 点击注册

2. 配置应用

在身份验证中：

1. 添加平台 → 移动和桌面应用程序 → 勾选 http://localhost → 配置
2. 允许公共客户端流 → 是 → 保存

在API 权限中：

1. 添加权限 → 组织使用的 API → 搜索 Azure DevOps
2. 选择 user_impersonation（委托）→ 添加
3. 点击授予管理员同意（可选——跳过针对每位用户的同意提示）

3. 使用应用

npx azure-board-mcp authenticate --client-id <your-app-id>

# Single-tenant:
npx azure-board-mcp authenticate --client-id <your-app-id> --tenant-id <your-tenant-id>

面向组织管理员——为组织中的所有人预先批准：

https://login.microsoftonline.com/{tenant-id}/adminconsent
  ?client_id=e2ba32e7-6d24-4919-ba7b-37199c495247
  &redirect_uri=http://localhost

---

许可证

MIT