Azure DevOps MCP Server

Что умеет сервер

Azure DevOps MCP Server выпускает Microsoft. Он даёт AI-агентам контекст Azure DevOps через тонкую обёртку над REST API: каждый инструмент решает узкую задачу, а рассуждения верхнего уровня остаются за агентом. В README приведены такие примеры запросов: список проектов, сборок, репозиториев, тестовых планов, команд и итераций, свои рабочие элементы и элементы текущей итерации, вики с созданием, обновлением и чтением страниц.

Есть два варианта. Удалённый сервер размещает Microsoft, его адрес вида mcp.dev.azure.com с именем вашей организации, и ничего устанавливать не нужно. Локальный сервер запускается как пакет npm @azure-devops/mcp по stdio. Его инструменты сгруппированы в домены: core, work, work-items, search, test-plans, repositories, wiki, pipelines и advanced-security.

Когда использовать

Подключайте сервер, если команда работает в Azure DevOps и хочет вести рабочие элементы, смотреть сборки и репозитории, искать по коду и править вики, не открывая веб-интерфейс. Microsoft рекомендует начинать с удалённого сервера, а локальный брать, когда нужен именно stdio. Домены помогают оставить только нужные группы инструментов, чтобы список не разрастался и укладывался в лимиты клиентов.

Ограничения и безопасность

В README сказано, что удалённый сервер со временем заменит локальный: локальный пока поддерживается, но новая разработка идёт на удалённом, а пользователям локального советуют планировать переход. Удалённый сервер в README описан как находящийся на этапе предварительной версии. Для локального сервера нужен Node.js 20 или новее и доступ к организации Azure DevOps.

Локальный сервер по умолчанию просит войти через учётную запись Microsoft в браузере. Другие способы аутентификации: сессия Azure CLI (azcli), цепочка учётных данных Azure (env), токен-носитель из переменной ADO_MCP_AUTH_TOKEN и персональный токен доступа в PERSONAL_ACCESS_TOKEN. В документации отдельно предупреждено не коммитить токены в файл конфигурации MCP. Для входа нужна учётная запись с доступом к выбранной организации Azure DevOps.

Удалённый сервер в VS Code (рекомендуется)

Создайте файл .vscode/mcp.json и подставьте имя своей организации Azure DevOps вместо {organization}:

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

Сохраните файл, запустите сервер в представлении MCP и отправьте запрос вроде List ADO projects.

Локальный сервер в VS Code

Нужен Node.js 20 или новее. Файл .vscode/mcp.json:

{
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "{organization}"]
    }
  }
}

Для ночных сборок замените @azure-devops/mcp на @azure-devops/mcp@next. Чтобы загрузить только нужные группы инструментов, добавьте домены после -d (домен core лучше оставлять всегда):

{
  "servers": {
    "ado_with_filtered_domains": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "{organization}", "-d", "core", "work", "work-items"]
    }
  }
}

Claude Code

claude mcp add --transport stdio azure-devops -- npx -y @azure-devops/mcp {organization}

Проверка подключения:

claude mcp list

Claude Desktop

Откройте File, Settings, Developer, нажмите Edit Config и добавьте:

{
  "mcpServers": {
    "ado": {
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "{organization}"]
    }
  }
}

Сохраните файл, полностью закройте Claude Desktop и запустите заново.

Cursor

Создайте .cursor/mcp.json в проекте:

{
  "mcpServers": {
    "ado": {
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "{organization}"]
    }
  }
}

GitHub Copilot CLI

Добавьте сервер командой /mcp add либо в файл ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "ado": {
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "{organization}"],
      "tools": ["*"]
    }
  }
}

Codex

codex mcp add azure-devops -- npx -y @azure-devops/mcp {organization}

Способы входа

По умолчанию вход интерактивный. Другой способ задают аргументом --authentication (или -a). Например, через сессию Azure CLI:

{
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "{organization}", "--authentication", "azcli"]
    }
  }
}

Для персонального токена значением PERSONAL_ACCESS_TOKEN должна быть строка <email>:<pat> в base64, а в аргументы добавляют "--authentication", "pat":

export PERSONAL_ACCESS_TOKEN="$(printf '%s' '<email>:<pat>' | base64)"