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

Azure DevOps サービス

リモートの Azure DevOps MCP サーバーは、ローカル インストールを必要としない Azure DevOps MCP サーバー のホストバージョンです。 マシン上でサーバーを実行する代わりに、ストリーミング可能な 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

ウィット

Pipelines

ウィキ

Test Plans

Search

サポートされている環境

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

既定では、すべての MCP クライアントが 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 での MCP サーバーの使用」を参照してください。

接続を確認する

セットアップ後、AZURE DevOps データについて AI アシスタントに質問して、リモート 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 サーバーで使用する前に、Entra で OAuth クライアント ID を動的に登録する必要があります。 この機能を有効にするために、Entra チームと緊密に協力しています。 現時点では、Visual Studio と Visual Studio Code のみがサポートされています。

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

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

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

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

関連するコンテンツ

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