设置远程Azure DevOps MCP 服务器（预览版）

Azure DevOps Services

远程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

工作项跟踪

Pipelines

维基

Wiki读取操作被整合到一个统一的wiki工具中。 使用 action 参数选择操作。

测试计划

搜寻

支持的环境

远程 Azure DevOps MCP 服务器要求您的用户帐户和 Azure DevOps 组织连接到 Microsoft Entra ID。

并非所有 MCP 客户端默认都支持 Entra 身份验证。 某些环境需要额外的步骤来注册客户端应用程序。

当前支持的环境包括：

• Visual Studio Code
• Visual Studio

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 及更高版本）

通过将服务器 URL 添加到 MCP 设置，在 Visual Studio 中配置远程 MCP 服务器。 有关详细信息，请参阅 在 Visual Studio 中使用 MCP 服务器。

验证连接

设置后，通过向 AI 助手询问有关Azure DevOps数据的问题，验证远程 MCP 服务器是否正常工作。

示例：

• “列出我的Azure DevOps组织中的项目。
• “显示我分配的工作项。
• “哪些拉取请求需要我的评审？”

如果 AI 助手从Azure DevOps组织返回结果，则远程 MCP 服务器已正确配置。

故障排除

对于支持，可以在 本地 MCP 服务器 存储库中创建问题。 请务必使用 远程 问题模板。

FAQ

其他客户端（如 GitHub Copilot CLI、Claude Desktop、Claude Code、CodeX 或 Cursor）呢？

其他客户端工具（如 CodeX、Claude Desktop、Claude Code 和 ChatGPT）需要在 Entra 中动态注册 OAuth 客户端 ID，然后才能将其与 MCP 服务器一起使用。 我们正在与 Entra 团队密切合作，以实现此功能。 目前，仅支持Visual Studio和Visual Studio Code。

哪些服务可以使用Azure DevOps MCP 服务器？

对其他服务（包括Azure AI Foundry、Microsoft 365 Copilot和Copilot Studio）的支持尚不可用，但即将添加。

Azure DevOps MCP 服务器是否支持 AgentId？

AgentId 支持即将推出。

相关内容

• Azure DevOps MCP 服务器概述
• Azure DevOps MCP 服务器GitHub存储库