リモート Azure DevOps MCP サーバーを設定する (プレビュー)

Azure DevOps サービス

リモート Azure DevOps MCP サーバーは、ローカル インストールを必要としない Azure DevOps MCP Server のホストバージョンです。 マシン上でサーバーを実行する代わりに、ストリーミング可能な HTTP トランスポートを使用して、AI アシスタントを Azure DevOps ホストエンドポイントに直接接続します。

リモート サーバーは、作業項目、プル要求、パイプラインなどのアクセスを含むローカル サーバーと同じ機能を提供し、ローカルセットアップの複雑さを排除します。

リモートとローカルの MCP サーバー

前提条件

mcp.json 構成

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

URL から組織名を省略することもできます。 ただし、組織名を省略した場合は、各ツール呼び出しでコンテキストとして指定する必要があります。

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

ツールセット

ツールセットを指定して、MCP サーバーで使用できるツールを制限します。 X-MCP-Toolsと組み合わせることはできません。

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Toolsets": "repos,wiki,wit"
      }
    }
  },
  "inputs": []
}

読み取り専用ツール

X-MCP-Readonly ヘッダーを使用して、サーバーを読み取り専用の操作に制限します。 この制限は、Azure DevOps リソースの変更を防ぐ場合に便利です。

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

ツールセットと読み取り専用フィルターの組み合わせ

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Toolsets": "repos,wiki,wit",
        "X-MCP-Readonly": "true"
      }
    }
  },
  "inputs": []
}

個々のツール

特定のツールのみを有効にするには、 X-MCP-Tools ヘッダーを使用します。 X-MCP-Toolsetsと組み合わせることはできません。

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "core_list_projects, wit_my_work_items, wit_get_work_items_batch_by_ids"
      }
    }
  },
  "inputs": []
}

インサイダーたち

既存のツールと更新プログラムを試して導入する際に、 X-MCP-Insiders ヘッダーを使用して、これらの変更に早期にアクセスできます。

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

使用可能なツール

コア ツール

コア ツールは常に使用できます。

仕事

Repos

リポジトリ ツールは、wiki ツールと同じパターンに従って、 action パラメーターを使用してグループ化されたディスパッチャーに統合されます。 以前の個々のツール名は、エイリアスとして引き続き機能します。 repo_create_branchとrepo_search_commitsを直接使用します。これらは統合されていませんでした。

ウィット

作業項目ツールは、リポジトリおよびパイプライン ツールと同じパターンに従って、 action パラメーターを使用してグループ化されたディスパッチャーに統合されます。 以前の個々のツール名は、エイリアスとして引き続き機能します。 search_workitemを直接使用します。統合されていませんでした。

Pipelines

パイプライン ツールは、wiki およびリポジトリ ツールと同じパターンに従って、 action パラメーターを使用してグループ化されたディスパッチャーに統合されます。 以前の個々のツール名は、エイリアスとして引き続き機能します。

ウィキ

Wiki の読み取り操作は、1 つの wiki ツールに統合されます。 action パラメーターを使用して操作を選択します。

Test Plans

Search

サポートされている環境

リモート Azure DevOps MCP サーバーでは、ユーザー アカウントとAzure DevOps組織がMicrosoft Entra IDに接続する必要があります。

既定では、すべての MCP クライアントがMicrosoft Entra認証をサポートしているわけではありません。 一部の環境では、クライアント アプリケーションを登録するための追加の手順が必要です。

現在サポートされている環境は次のとおりです。

• Visual Studio Code
• Visual Studio

Visual Studio Code

Visual Studio Codeでリモート MCP サーバーを構成するには:

1. 前に示したmcp.json 構成を使用して、.vscode/mcp.json ファイルをリポジトリに追加します。
2. ファイルを保存します。
3. VS Code でGitHub Copilotを開きます。
4. メッセージが表示されたら、Microsoft Entra アカウントを使用して認証し、アカウントを選択します。

認証が完了すると、使用可能なツールの一覧が表示されます。

Visual Studio (2022 以降)

MCP 設定にサーバー URL を追加して、Visual Studioでリモート MCP サーバーを構成します。 詳細については、「 Visual Studio」を参照してください。

接続を確認する

セットアップ後、AI アシスタントにAzure DevOpsデータに関する質問をして、リモート MCP サーバーが動作していることを確認します。

例:

• "Azure DevOps組織内のプロジェクトを一覧表示します。"
• "割り当てられた作業項目を表示する"
• どのプルリクエストにレビューが必要ですか？

AI アシスタントがAzure DevOps組織から結果を返した場合、リモート MCP サーバーが正しく構成されます。

Troubleshooting

サポートのために、 ローカル MCP サーバー リポジトリに問題を作成できます。 リモート問題テンプレートを必ず使用してください。

FAQ

GitHub Copilot CLI、Claude Desktop、Claude Code、CodeX、Cursor などの他のクライアントはどうでしょうか。

CodeX、Claude Desktop、Claude Code、ChatGPT などの他のクライアント ツールでは、MCP サーバーで使用する前に、Microsoft Entraで OAuth クライアント ID を動的に登録する必要があります。 この機能を有効にするために、Microsoft Entra チームと緊密に協力しています。 現時点では、Visual StudioとVisual Studio Codeのみがサポートされています。

MCP サーバー Azure DevOps使用できるサービスは何ですか?

Azure AI Foundry、Microsoft 365 Copilot、Copilot Studioなど、他のサービスのサポートはまだ利用できませんが、近日中に追加される予定です。

Azure DevOps MCP サーバーは AgentId をサポートしていますか?

AgentId のサポートは近日公開予定です。

関連するコンテンツ

• Azure DevOps MCP サーバーの概要
• Azure DevOps MCP Server GitHub リポジトリ