リモート Azure DevOps MCP サーバーを設定する

Azure DevOps サービス

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

最初にリモートを選択する

環境でサポートされている場合は、 リモート MCP サーバー を使用します。 リモート サーバーは、Azure DevOps によってホストおよび更新され、Node.js をインストールしたりローカル サーバー プロセスを管理したりする必要がないため、推奨されるオプションです。

クライアントがMicrosoft Entra IDを使用してリモート サーバーに対して認証できない場合は、ローカル MCP サーバーを使用します。 この制限は現在、Claude Desktop や Codex などのクライアントに適用されます。 カーソルとクロード コードでは、認証にカスタム Microsoft Entra アプリの登録が必要です。 ローカルセットアップの手順については、「Azure DevOps MCP サーバーで AI サポートを有効にする」を参照してください。

前提条件

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と組み合わせることはできません。

使用可能なツールの一覧に表示されるツール名を指定します。 wit_work_itemなどの統合ツールの場合は、ツールを呼び出すときにツールの action パラメーターを使用して操作を選択します。

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

インサイダーたち

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

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

使用可能なツール

コア ツール

特に明記されていない限り、コア ツールは常に使用できます。

仕事

作業ツールは、 action パラメーターを使用してグループ化されたディスパッチャーに統合されます。

Repos

リポジトリ ツールは、 action パラメーターを使用してグループ化されたディスパッチャーに統合されます。

ウィット

作業項目ツールは、 action パラメーターを使用してグループ化されたディスパッチャーに統合されます。

Pipelines

パイプライン ツールは、 action パラメーターを使用してグループ化されたディスパッチャーに統合されます。

ウィキ

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

Test Plans

テスト計画ツールは、 action パラメーターを使用してグループ化されたディスパッチャーに統合されます。

高度なセキュリティ

Advanced Security ツールは、 action パラメーターを使用するグループ化されたディスパッチャーに統合されます。

Enterprise Live Migration (プレビュー)

Enterprise Live Migration ツールでは、タスクのグループ化とディスパッチに action パラメーターを使用します。 Enterprise Live Migration プレビューの詳細を確認します。

Enterprise Live Migration ツールのみを使用できるようにするには、 X-MCP-Toolsets ヘッダーと elm 値を使用します。

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

サポートされている環境

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

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

Microsoft Entra認証が使用可能な場合、リモート エンドポイントでサポートされる環境は次のとおりです。

• GitHub Copilotと一緒に使用するVisual Studio
• Visual Studio
• Microsoft Foundry
• Microsoft Copilot Studio
• GitHub Copilot CLI（コマンドラインインターフェース）
• GitHub Copilot アプリ
• カスタム Microsoft Entra アプリ登録を使用する Cursor デスクトップ、Cursor Cloud Agents、または Claude Code

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」を参照してください。

カスタム クライアントの OAuth スコープを選択する

カスタム MCP クライアントを登録するときに、クライアントが実行するAzure DevOps操作に必要な委任されたアクセス許可のみを付与します。 OAuth スコープは、クライアントがアクセスできる Azure DevOps のリソースと操作を決定します。 MCP ツールまたはツールセットを有効にしても、追加のアクセス許可は付与されません。

最小特権の原則に従います。

• クライアントが読み取り専用 MCP ツールのみを使用する場合は、読み取りスコープを付与します。
• クライアントが対応する書き込み操作を必要とする場合にのみ、書き込みスコープまたは管理スコープを付与します。
• 冗長なアクセス許可が付与されないように、継承されたスコープを確認します。

使用可能なスコープとそのリレーションシップについては、「 OAuth スコープ」を参照してください。

OAuth スコープは、サインインしているユーザーのアクセス許可をオーバーライドしません。 MCP 操作は、アプリケーション スコープとユーザーのAzure DevOpsアクセス許可の両方で許可されている場合にのみ成功します。

Cursor

カーソルは、リモート Azure DevOps MCP サーバーにアクセスするためにカスタム Microsoft Entra アプリの登録を必要とします。

アプリケーションを Cursor デスクトップに登録する

1. Azure DevOps MCP エンタープライズ アプリケーションがテナントにプロビジョニングされていることを確認します。 見つからない場合は、「テナントで MCP エンタープライズ アプリケーションAzure DevOpsが見つからない」を参照してください。
2. Microsoft Entra 管理センターで、アプリの登録に移動し、アプリの登録を作成します。
3. アプリの登録で、[ 認証 (プレビュー)]>[リダイレクト URI の追加>Mobile アプリケーションとデスクトップ アプリケーションを追加する] を選択します。
4. リダイレクト URI として「 http://localhost:8787/callback 」と入力し、変更を保存します。
5. [ 認証 (プレビュー)] ページで、[ 設定] タブを選択し、[ パブリック クライアント フローの許可] を有効にします。
6. [ API のアクセス許可 ] ページで、[ アクセス許可の追加>組織が使用する API を選択します。
7. Azure DevOps MCP またはアプリケーション ID 2a72489c-aab2-4b65-b93a-a91edccf33b8を検索し、アプリケーションを選択します。
8. OAuth スコープのガイダンスに従って、クライアントに必要な委任されたアクセス許可を選択し、[アクセス許可の追加] を選択します。
9. [管理者の同意の付与] を選択します。 ロールによっては、テナント管理者がこの手順を完了することが必要になる場合があります。

アプリの登録から アプリケーション (クライアント) ID を コピーします。 Cursor を構成するには、この値が必要です。

Cursorデスクトップ版を設定する

1. カーソルで、[ 設定]>Tools > MCP を開きます。

2. [ 新しい MCP サーバー] を選択します。

3. 次の構成を追加し、 {client-id} をコピーしたアプリケーション (クライアント) ID に置き換えます。

   {
     "mcpServers": {
       "ado": {
         "url": "https://mcp.dev.azure.com",
         "type": "http",
         "auth": {
           "CLIENT_ID": "{client-id}"
         }
       }
     }
   }
   

4. 構成を保存し、 設定>Tools > MCP に戻ります。

5. ado サーバーを見つけて、[認証] を選択します。

Cursor Cloud エージェントの構成

Cursor Cloud Agents には、カスタム Microsoft Entra アプリの登録に加えて、Web リダイレクト URI とクライアント シークレットが必要です。

1. Microsoft Entra 管理センターで、Cursor 用に作成したアプリの登録を開きます。

2. [認証 (プレビュー)]>[リダイレクト URI の追加>Web] を選択します。

3. リダイレクト URI として「 https://www.cursor.com/agents/mcp/oauth/callback 」と入力し、変更を保存します。

4. [証明書とシークレット>クライアント シークレット>新しいクライアント シークレットを選択します。

5. 説明を入力し、有効期限を選択して、[ 追加] を選択します。

6. クライアント シークレットの値をコピーします。 値は 1 回だけ表示されます。

7. Cursor で、Cloud Agents MCP サーバー構成を開き、カスタム MCP サーバーを追加または編集します。

8. サーバーの URL を https://mcp.dev.azure.com に設定します。

9. アプリ登録のアプリケーション (クライアント) ID を クライアント ID に入力し、クライアント シークレットの値を クライアント シークレット に入力します。

   または、JSON 構成を編集し、プレースホルダーをアプリ登録値に置き換えます。

   {
     "mcpServers": {
       "ado": {
         "url": "https://mcp.dev.azure.com",
         "type": "http",
         "auth": {
           "CLIENT_ID": "{client-id}",
           "CLIENT_SECRET": "{client-secret}"
         }
       }
     }
   }
   

10. 構成を保存し、[Cursor Cloud Agents] から [ログイン] を選択して、Microsoft Entra認証を完了します。

Microsoft Entraがエラー AADSTS50011を返す場合は、Web リダイレクト URI がhttps://www.cursor.com/agents/mcp/oauth/callbackと正確に一致することを確認します。 エラー AADSTS7000218でトークン交換が失敗した場合は、現在のクライアント シークレットの値が Cursor Cloud Agents で構成されていることを確認します。

クロード符号

Claude Code では、リモート Azure DevOps MCP サーバーにアクセスするために、カスタム Microsoft Entra アプリの登録が必要です。

アプリケーションを登録する

1. Azure DevOps MCP エンタープライズ アプリケーションがテナントにプロビジョニングされていることを確認します。 見つからない場合は、「テナントで MCP エンタープライズ アプリケーションAzure DevOpsが見つからない」を参照してください。
2. Microsoft Entra 管理センターで、アプリの登録に移動し、アプリの登録を作成します。
3. アプリの登録で、[ 認証 (プレビュー)]>[リダイレクト URI の追加>Mobile アプリケーションとデスクトップ アプリケーションを追加する] を選択します。
4. リダイレクト URI として「 http://localhost:3118/callback 」と入力し、変更を保存します。
5. [ 認証 (プレビュー)] ページで、[ 設定] タブを選択し、[ パブリック クライアント フローの許可] を有効にします。
6. [ API のアクセス許可 ] ページで、[ アクセス許可の追加>組織が使用する API を選択します。
7. Azure DevOps MCP またはアプリケーション ID 2a72489c-aab2-4b65-b93a-a91edccf33b8を検索し、アプリケーションを選択します。
8. OAuth スコープのガイダンスに従って、クライアントに必要な委任されたアクセス許可を選択し、[アクセス許可の追加] を選択します。
9. [管理者の同意の付与] を選択します。 ロールによっては、テナント管理者がこの手順を完了することが必要になる場合があります。

アプリの登録から アプリケーション (クライアント) ID を コピーします。 Claude Code を構成するには、この値が必要です。

Claude Code の構成

1. 次のコマンドを実行し、{client-id}をコピーしたアプリケーション (クライアント) ID に置き換え、{organization}をAzure DevOps組織名に置き換えます。

   claude mcp add --transport http ado https://mcp.dev.azure.com/{organization} \
     --client-id {client-id} --callback-port 3118
   

   または、次の構成でリポジトリのルートに .mcp.json ファイルを作成します。

   {
     "mcpServers": {
       "ado": {
         "type": "http",
         "url": "https://mcp.dev.azure.com/{organization}",
         "oauth": {
           "clientId": "{client-id}",
           "callbackPort": 3118
         }
       }
     }
   }
   

2. claudeを実行して Claude Code を起動します。

3. /mcp実行し、ブラウザーのサインイン フローに従って、Microsoft Entra アカウントで認証します。

これらのオプションの詳細については、「 Claude Code を MCP 経由でツールに接続する」を参照してください。

接続を確認する

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

例:

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

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

AI を使用してリモート MCP セットアップの検証とトラブルシューティングを行う

Copilot Chat 用の以下のプロンプト例は、適切な MCP アプローチの選択、リモート設定の構成と検証、日常的に使用するプロンプトの改善、そして必要に応じた問題のトラブルシューティングに役立ちます。 これらのプロンプトをコピーしてCopilot Chatに貼り付け、プレースホルダーを実際の組織、クライアント、エラーの詳細に置き換えます。

Copilot では AI を利用しているため、想定外のことや間違いが起こる可能性があります。 詳細については、「Copilot一般的な使用に関する FAQを参照してください。

Troubleshooting

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

FAQ

Claude Desktop や Codex などの他のクライアントはどうですか?

Claude Desktop と Codex では、リモート MCP サーバーを使用する前に、Microsoft Entra IDで OAuth クライアント ID を動的に登録する必要があります。 Microsoft Entra IDでは現在、これらのクライアントに必要な動的クライアント登録フローはサポートされていません。 これらのクライアントで ローカル MCP サーバー を使用します。

関連するコンテンツ

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