設定遠端 Azure DevOps MCP Server

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 等客戶端。 游標和 Claude Code 需要自訂的 Microsoft Entra 應用程式註冊來認證。 關於本地設定說明，請參見啟用 Azure DevOps MCP Server 的 AI 協助。

先決條件

mcp.json 配置

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

你也可以在網址中省略組織名稱。 不過，如果你省略了組織名稱，必須在每次工具呼叫中提供它作為上下文。

{
  "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 工具。 使用參數 action 來選擇操作。

測試計劃

測試計畫工具會整合成使用參數 action 的分組調度器。

進階安全性

進階安全工具整合成一個群組的調度器，並使用參數 action 。

企業級即時移轉（預覽）

Enterprise Live Migration 工具使用 action 參數來分組與派遣任務。 了解更多 關於企業即時遷移預覽的資訊。

若要僅提供企業即時遷移工具，請使用 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 認證可用時，遠端端點所支援的環境包括：

• Visual Studio 搭配 GitHub Copilot
• Visual Studio
• Microsoft Foundry
• Microsoft Copilot Studio
• GitHub Copilot 命令列界面 (CLI)
• GitHub Copilot 應用程式
• 游標桌面、游標雲端代理，或是 Claude Code，搭配自訂的 Microsoft Entra 應用程式註冊

Visual Studio Code

要在 Visual Studio Code 中設定遠端 MCP 伺服器：

1. 將.vscode/mcp.json檔案新增到你的儲存庫，並使用前面顯示的mcp.json 設定。
2. 儲存檔案。
3. 用 VS Code 開啟 GitHub Copilot。
4. 當提示時，請使用您的 Microsoft Entra 帳號進行驗證並選擇您的帳號。

認證完成後，會出現可用工具清單。

Visual Studio（2022 及以後版本）

在 Visual Studio 中設定遠端 MCP 伺服器，方法是將伺服器網址加入你的 MCP 設定中。 欲了解更多資訊，請參閱 在 Visual Studio 中使用 MCP 伺服器。

為自訂客戶端選擇 OAuth 權限範圍

註冊自訂 MCP 用戶端時，只授予該用戶端執行 Azure DevOps 操作所需的委派權限。 OAuth 範圍決定了客戶端可存取哪些 Azure DevOps 資源與操作。 啟用 MCP 工具或工具組不會授予額外權限。

遵循最小特權原則：

• 當用戶端僅使用唯讀 MCP 工具時，授予讀取範圍。
• 只有當客戶端需要相應的寫入操作時，才授予寫入或管理範圍。
• 檢視繼承的範圍以避免授予冗餘權限。

關於可用的範圍及其關係，請參見 OAuth 範圍。

OAuth 範圍不會覆蓋已登入使用者的權限。 MCP 操作只有在應用程式範圍與使用者 Azure DevOps 權限都允許時才會成功。

Cursor

Cursor 需要自訂 Microsoft Entra 應用程式註冊才能存取遠端 Azure DevOps MCP Server。

為 Cursor 桌面版註冊應用程式

1. 確認你的租戶中有配置 Azure DevOps MCP 企業應用程式。 如果找不到，請參考租戶中的「找不到 Azure DevOps MCP 企業應用程式」。
2. 在 Microsoft Entra 系統管理中心中，移至 應用程式註冊，然後建立應用程式註冊。
3. 在應用程式註冊中，選擇驗證（預覽）>新增 URI >行動版及桌面版應用程式的重定向。
4. 輸入 http://localhost:8787/callback 重定向 URI，然後儲存你的變更。
5. 在 認證（預覽） 頁面，選擇 設定 標籤，然後啟用 允許公開客戶端流程。
6. 在 API 權限 頁面上，選取 新增權限>。
7. 搜尋 Azure DevOps MCP 或應用程式 ID2a72489c-aab2-4b65-b93a-a91edccf33b8，然後選擇該應用程式。
8. 依照 OAuth 範圍指引，選擇客戶所需的委派權限，然後選擇 新增權限。
9. 選取 [授與管理員同意]。 根據你的職務，租戶管理員可能需要完成此步驟。

從應用程式註冊中複製應用程式 （客戶端）ID 。 你需要這個值來設定游標。

設定游標桌面

1. 在游標中，打開 設定>工具與 MCP。

2. 選擇 新的 MCP 伺服器。

3. 新增以下設定，並以你複製的應用程式（用戶端）ID 替換 {client-id} ：

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

4. 儲存設定後，回到 設定>工具和 MCP。

5. 找到 ado 伺服器，然後選擇 驗證。

設定游標雲端代理

游標雲端代理程式除了自訂 Microsoft Entra 應用程式註冊外，還需要網頁重定向 URI 和用戶端秘密。

1. 在 Microsoft Entra 系統管理中心 中，開啟你為游標建立的應用程式註冊。

2. 選取 驗證（預覽）>新增重新導向 URI>Web。

3. 輸入 https://www.cursor.com/agents/mcp/oauth/callback 重定向 URI，然後儲存你的變更。

4. 選取 [憑證和祕密]>[用戶端密碼]>[新增用戶端密碼]。

5. 輸入描述，選擇有效期限，然後選擇 新增。

6. 複製用戶端密碼值。 該數值只出現一次。

7. 在游標中，打開 Cloud Agents 的 MCP 伺服器設定，然後新增或編輯自訂的 MCP 伺服器。

8. 將伺服器網址設為 https://mcp.dev.azure.com。

9. 在 Client ID 輸入應用程式註冊時的應用程式（用戶端）ID，在 Client Secret 輸入用戶端秘密值。

   或者，編輯 JSON 設定，並用你的應用程式註冊值替換佔位符：

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

10. 儲存設定後，選擇從游標雲端代理登入完成 Microsoft Entra 驗證。

如果 Microsoft Entra 回傳錯誤AADSTS50011，請確認網頁重定向的 URI 是否完全符合https://www.cursor.com/agents/mcp/oauth/callback。 若權杖交換失敗並出現錯誤 AADSTS7000218，請確認目前的用戶端密鑰值已在 Cursor Cloud Agents 中設定。

克勞德密碼

Claude Code 需要自訂 Microsoft Entra 應用程式註冊，才能存取遠端 Azure DevOps MCP Server。

註冊應用程式

1. 確認你的租戶中有配置 Azure DevOps MCP 企業應用程式。 如果找不到，請參考租戶中的「找不到 Azure DevOps MCP 企業應用程式」。
2. 在 Microsoft Entra 系統管理中心中，移至 應用程式註冊，然後建立應用程式註冊。
3. 在應用程式註冊中，選擇驗證（預覽）>新增 URI >行動版及桌面版應用程式的重定向。
4. 輸入 http://localhost:3118/callback 重定向 URI，然後儲存你的變更。
5. 在 認證（預覽） 頁面，選擇 設定 標籤，然後啟用 允許公開客戶端流程。
6. 在 API 權限 頁面上，選取 新增權限>。
7. 搜尋 Azure DevOps MCP 或應用程式 ID2a72489c-aab2-4b65-b93a-a91edccf33b8，然後選擇該應用程式。
8. 依照 OAuth 範圍指引，選擇客戶所需的委派權限，然後選擇 新增權限。
9. 選取 [授與管理員同意]。 根據你的職務，租戶管理員可能需要完成此步驟。

從應用程式註冊中複製應用程式 （客戶端）ID 。 你需要這個值來設定 Claude Code。

配置 Claude 程式碼

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。

3. 執行 /mcp，然後依照瀏覽器登入流程與你的 Microsoft Entra 帳號進行驗證。

欲了解更多這些選項，請參閱 「透過 MCP 連接 Claude 程式碼與工具」。

驗證連線

設定完成後，請透過詢問你的 AI 助理關於 Azure DevOps 資料的問題，確認遠端 MCP 伺服器是否正常運作。

範例：

• 「列出我 Azure DevOps 組織裡的專案。」
• 「展示我分配的工作項目。」
• 「哪些拉取請求需要我審核？」

如果 AI 助理回傳了來自 Azure DevOps 組織的結果，代表遠端 MCP 伺服器設定正確。

利用 AI 驗證並排除遠端 MCP 設定問題

以下 Copilot Chat 範例提示，幫助您選擇合適的 MCP 方法、設定與驗證遠端設定、改善日常使用提示，並在需要時排除故障。 將這些提示複製貼上到 Copilot Chat，並用你的實際組織、客戶和錯誤細節替換佔位符。

Copilot 由 AI 驅動，因此意外與失誤是有可能的。 欲了解更多資訊，請參閱 Copilot 一般使用常見問題。

Troubleshooting

對於支援，你可以在 本地 MCP 伺服器 儲存庫中建立一個問題。 務必使用 遠端 議題範本。

FAQ

那像 Claude Desktop 或 Codex 這類客戶端呢？

Claude Desktop 與 Codex 要求在使用 Microsoft Entra ID 中動態註冊 OAuth 用戶端 ID，才能使用遠端 MCP 伺服器。 Microsoft Entra ID 目前不支援這些用戶端所需的動態客戶端註冊流程。 使用 本地的 MCP 伺服器 搭配這些用戶端。

相關內容

• Azure DevOps MCP 伺服器概述
• Azure DevOps MCP 伺服器GitHub儲存庫