Azure Boards MCP

azure-board-mcp

Azure DevOps用のMCP サーバーです。Claude、Cursor、またはMCP互換のAIから、タスク、スプリント、バグ、プルリクエスト、リポジトリ、パイプラインを直接操作できます。

---

クイックスタート

# 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というヘッダーが表示されます。大量のtopを指定する代わりに、skipを渡して結果を ページ分割してください。一覧表示では描画に必要なフィールドのみを取得するため、高速でコンテキストの負荷も軽くなります。

認証とプロジェクト

ツール	使用する場面
auth_status	認証の問題を診断し、現在のプロジェクトを確認する
switch_project	アクティブなプロジェクトを変更する、または利用可能なプロジェクトを一覧表示する

作業項目

ツール	使用する場面
list_work_items	自分のタスク、スプリントボード、状態／種類／キーワードによる絞り込み（ページネーション対応）
get_work_item	特定のチケットの詳細（フィールド、コメント、PR）を取得する
create_work_item	タスク、バグ、ユーザーストーリー、エピック、機能を作成する
update_work_item	クローズ、再割り当て、スプリントの移動、見積もりの更新を行う
add_comment	チケットにメモやステータス更新を投稿する
link_work_items	親子、関連、依存関係のリンクを設定する
query_wiql	カスタムWIQLを使った高度なクエリ（ページネーション対応）
get_work_item_history	監査履歴（変更されたフィールド、変更日時、変更者）を取得する
get_backlog	順序付けされ、優先度が設定されたプロダクトバックログを取得する

ボード、スプリント、チーム

ツール	使用する場面
get_sprint	現在のスプリントの日程とチームのキャパシティを確認する
list_sprints	開始日／終了日とともにすべてのスプリントを一覧表示する
get_board	カンバンの列、状態のマッピング、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 → App registrations → New registration
2. 名前：任意の名前（例：azure-board-mcp）
3. サポートされているアカウントの種類：「任意の組織ディレクトリ」（マルチテナント）または**「自分の組織のみ」**
4. 登録をクリックします

2. アプリを構成する

Authenticationで：

1. Add a platform → Mobile and desktop applications → http://localhost にチェックを入れる → Configure
2. Allow public client flows → Yes → Save

API permissionsで：

1. Add a permission → APIs my organization uses → Azure DevOps を検索します
2. user_impersonation（委任）を選択 → Add
3. Grant admin consentをクリックします（任意。ユーザーごとの同意プロンプトを省略できます）

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