Azure DevOps (ADO)

Azure DevOps MCP サーバー

重要

このローカルサーバーではなく、リモート MCP サーバーの使用をおすすめします。インストールは不要で、新機能もいち早く利用できます。

詳しくはこちら

このプロジェクトでは、Model Context Protocol（MCP）を通じて、AI エージェントが Azure DevOps にアクセスできます。最も簡単にセットアップするにはホスト型のリモートサーバーを使用し、stdio 接続が必要な場合はローカルサーバーを実行してください。

目次

1. 概要
2. 設計
3. リモート MCP サーバー（推奨）
4. サポートされているツール
5. ローカル MCP サーバーのインストール（任意）
6. ドメインの使用（ローカルサーバー）
7. プロジェクトとチームの既定値（ローカルサーバー）
8. トラブルシューティング
9. 例とベストプラクティス
10. よくある質問
11. コントリビューション

概要

Azure DevOps MCP サーバーは、Azure DevOps のコンテキストをエージェントに提供します。次のようなプロンプトを試してみてください。

• 「自分の ADO プロジェクトを一覧表示して」
• 「'Contoso' の ADO ビルドを一覧表示して」
• 「'Contoso' の ADO リポジトリを一覧表示して」
• 「'Contoso' のテスト計画を一覧表示して」
• 「'Contoso' プロジェクトのチームを一覧表示して」
• 「'Contoso' プロジェクトのイテレーションを一覧表示して」
• 「'Contoso' プロジェクトの自分の作業項目を一覧表示して」
• 「'Contoso' プロジェクトと 'Contoso Team' の現在のイテレーションにある作業項目をすべて一覧表示して」
• 「'Contoso' プロジェクトにあるすべての Wiki を一覧表示して」
• 「システム設計の内容を含む Wiki ページ '/Architecture/Overview' を作成して」
• 「Wiki ページ '/Getting Started' を新しいオンボーディング手順で更新して」
• 「Documentation Wiki から Wiki ページ '/API/Authentication' の内容を取得して」

設計

各ツールは、Azure DevOps の特定のタスクを処理します。サーバーは REST API を薄くラップし、AI エージェントはより高度な推論を担います。

リモート MCP サーバー（推奨）

詳しい手順については、リモート MCP サーバーのオンボーディングドキュメントをご覧ください。

リモートサーバーは、最終的にローカルサーバーに取って代わる予定です。ローカルサーバーも引き続きサポートされますが、新たな開発はリモートサーバーに重点を置きます。既存のローカルサーバーユーザーは、移行の計画を開始してください。

ツールで問題が発生した場合、サポートが必要な場合、または機能をリクエストする場合は、リモート MCP サーバーの問題報告テンプレートを使用して問題を報告できます。プレビュー期間中、リモート MCP サーバーに関する問題はこのリポジトリで追跡します。

クイックスタート

プロジェクトに .vscode/mcp.json を作成し、この設定を追加します。{organization} を Azure DevOps の組織名に置き換えてください。

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

その他のオプションについては、リモートサーバーの構成ドキュメントをご覧ください。

.vscode/mcp.json を保存したら、VS Code の MCP ビューからサーバーを起動し、List ADO projects のようなプロンプトを実行してください。

サポートされているツール

利用可能なリモートツールの全一覧については、利用可能なツールのドキュメントをご覧ください。

ローカルツールの全一覧については、TOOLSET.mdをご覧ください。

ローカル MCP サーバーのインストール（任意）

重要

まずリモート MCP サーバーをお試しください。ローカルの stdio セットアップが特に必要な場合に限り、ローカル MCP サーバーを使用してください。

以下の手順では Visual Studio Code と GitHub Copilot を使用します。Visual Studio 2022、Codex、Claude Code、Cursor、OpenCode、Kilo Code など、その他のサポート対象クライアントについては、スタートガイドをご覧ください。

前提条件

1. VS Code または VS Code Insiders をインストールします。
2. Node.js 20 以降 をインストールします。
3. VS Code でプロジェクトを開きます。

インストール

npm からインストールする

1. プロジェクトに .vscode/mcp.json を作成します。
2. 次の設定を追加します。

{
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "{organization}"]
    }
  }
}

3. ファイルを保存し、VS Code の MCP ビューから ado サーバーを起動します。
4. GitHub Copilot Chat を開き、Agent モードに切り替えます。
5. Azure DevOps ツールを選択し、List ADO projects のようなプロンプトを試します。
6. プロンプトが表示されたら、選択した Azure DevOps 組織にアクセスできる Microsoft アカウントでサインインします。

ナイトリービルドを使用するには、設定内の @azure-devops/mcp を @azure-devops/mcp@next に置き換えます。

ツールの選択を改善するには、次の指示を含む .github/copilot-instructions.md をプロジェクトに追加します。

This project uses Azure DevOps. Always check whether the Azure DevOps MCP server has a tool relevant to the user's request.

ドメインの使用（ローカルサーバー）

ローカルサーバーには多くのツールが含まれています。ドメインを使用すると、必要なツールグループだけを読み込めるため、ツール一覧を管理しやすくなり、ツール数に制限のあるクライアントにも役立ちます。使用可能なドメインは core、work、work-items、search、test-plans、repositories、wiki、pipelines、advanced-security です。

サーバーの引数に -d と、その後にドメインを指定します。たとえば、次の設定では作業項目関連のツールのみが読み込まれます。

{
  "servers": {
    "ado_with_filtered_domains": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "{organization}", "-d", "core", "work", "work-items"]
    }
  }
}

エージェントがプロジェクト情報を取得できるよう、必ず core を含めてください。

-d を省略すると、サーバーはすべてのドメインを読み込みます。

プロジェクトとチームの既定値（ローカルサーバー）

ツールで選択プロンプトを省略できるように、.vscode/mcp.json で Azure DevOps のプロジェクトとチームの既定値を設定します。

.vscode/mcp.json の例

{
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "{organization}", "--authentication", "azcli"],
      "env": {
        "ado_mcp_project": "Contoso",
        "ado_mcp_team": "Fabrikam Team"
      }
    }
  }
}

トラブルシューティング

一般的な問題やログ記録については、トラブルシューティングガイドを参照してください。

例

プロンプトの例については、例を参照してください。

よくある質問

Azure DevOps MCP Server に関するよくある質問への回答は、よくある質問を参照してください。

コントリビューション

コントリビューションを歓迎します。プレビュー期間中は、バグ、機能強化、ドキュメントの改善について issue を登録してください。

コントリビューションガイドでは、次の内容を説明しています。

• 開発環境のセットアップ
• 新しいツールの追加
• コードスタイルとテスト
• プルリクエストのプロセス

プルリクエストを作成する前に、コントリビューションガイドをお読みください。

行動規範

このプロジェクトは、Microsoft オープンソース行動規範に従っています。 ご質問は、FAQを参照するか、[email protected] までお問い合わせください。

殿堂入り

このプロジェクトを素晴らしいものにしてくださるすべてのコントリビューターに感謝します！ ❤️

contrib.rocks で生成

ライセンス

MIT ライセンスに基づいてライセンスされています。

---

商標：このプロジェクトには、Microsoft または第三者の商標やロゴが含まれる場合があります。Microsoft の商標やロゴを使用する場合は、Microsoft の商標およびブランドガイドラインに従う必要があります。第三者の商標は、それぞれのポリシーに従います。