Настройте удалённый сервер MCP Azure DevOps

Службы Azure DevOps

Удаленный Azure DevOps MCP Server — это размещенная версия сервера Azure DevOps MCP Server, которая не требует локальной установки. Вместо запуска сервера на компьютере вы подключаете помощник по искусственному интеллекту непосредственно к размещенной Azure DevOps конечной точке с помощью потокового транспорта HTTP.

Сначала выберите удалённый доступ

Используйте удаленный MCP-сервер , если ваша среда поддерживает ее. Удалённый сервер — это рекомендуемый вариант, поскольку Azure DevOps размещает его и обновляет, а вам не нужно устанавливать Node.js или управлять локальным серверным процессом.

Используйте локальный СЕРВЕР MCP, если клиент не может пройти проверку подлинности на удаленном сервере с Microsoft Entra ID. Это ограничение в настоящее время применяется к клиентам, таким как Claude Desktop и Codex. Для аутентификации Cursor и Claude Code требуется настраиваемая регистрация приложения Microsoft Entra. Инструкции по локальной установке см. в статье Включение ИИ-помощника с помощью Azure DevOps MCP Server.

Функция	Удаленный сервер MCP	Локальный сервер MCP
Installation	Установка не требуется	Требуется Node.js 20.0+ и `npx`
Транспорт	HTTP со способностью потоковой передачи	`stdio`
Аутентификация	Microsoft Entra ID (OAuth)	Azure DevOps PAT или Microsoft Entra ID
Услуги размещения	Azure DevOps—размещенная служба	Выполняется локально на компьютере
Configuration	Минимальный `mcp.json`	Настройка для конкретной среды

Необходимые условия

Категория	Требования
Azure DevOps	Активная Azure DevOps организация, поддерживаемая клиентом Microsoft Entra. Организации с отдельными учетными записями Microsoft (MSA) не поддерживаются при удаленном использовании сервера 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": []
}

Значение набора инструментов	Включенные инструменты
`all` (по умолчанию)	Все инструменты
`repos`	Средства для репозиториев и запросов на включение изменений
`advsec`	Расширенные средства оповещений системы безопасности
`wit`	Средства для работы с рабочими элементами и `search_workitem`
`pipelines`	Инструменты конвейера и сборки
`wiki`	Вики-инструменты и `search_wiki`
`work`	Средства итерации и планирования загрузки
`testplan`	Инструменты плана тестирования
`elm`	Средства динамической миграции предприятия (предварительная версия; включена по умолчанию)

Средства только для чтения

Заголовок 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": []
}

Доступные средства

Замечание

Этот список может не всегда отражать последние обновления инструментов.

Основные средства

Основные инструменты всегда доступны, если не указано в противном случае.

инструмент	Описание
`core_list_orgs`	Перечислите организации Azure DevOps, к которым имеет доступ аутентифицированный пользователь
`core_list_projects`	Список проектов в организации
`core_list_project_teams`	Список команд в проекте
`core_list_group_members`	Вывести список прямых участников и дочерних групп группы Azure DevOps

Замечание

Только участники программы предварительной оценки MCP могут использовать core_list_group_members, используя заголовок X-MCP-Insiders.

Работа

Рабочие инструменты объединяются в сгруппированные диспетчеры с использованием параметра action.

инструмент	Действие	Описание	Только для чтения
`work`	`list_iterations`	Перечисление всех итераций в проекте	✅
`work`	`list_team_iterations`	Список итераций, назначенных команде	✅
`work`	`get_team_settings`	Получить параметры команды, включая итерацию по умолчанию, итерацию невыполненной работы и путь к области по умолчанию	✅
`work`	`get_team_capacity`	Получить пропускную способность команды для итерации	✅
`work`	`get_iteration_capacities`	Получить пропускную способность итерации для всех команд в этой итерации и проекте	✅
`work_iteration_write`	`create`	Создать итерации	❌
`work_iteration_write`	`assign`	Назначьте итерации команде	❌
`work_capacity_write`	`update`	Обновление емкости команды участника группы для конкретной итерации	❌

Repos

Инструменты репозитория объединены в сгруппированные диспетчеры с использованием параметра action.

инструмент	Действие	Описание	Только для чтения
`repo_pull_request`	`get`	Получение пулл-реквеста по ID	✅
`repo_pull_request`	`list`	Список запросов на слияние в репозитории или проекте	✅
`repo_pull_request`	`list_by_commits`	Найдите пулл-реквесты, содержащие конкретные идентификаторы фиксаций	✅
`repo_pull_request`	`get_changes`	Получение изменений файлов и необязательных построчных различий для итерации pull request	✅
`repo_pull_request_thread`	`list`	Вывод списка цепочек комментариев в pull request	✅
`repo_pull_request_thread`	`list_comments`	Список комментариев в определенном потоке	✅
`repo_repository`	`get`	Получение репозитория по имени или идентификатору	✅
`repo_repository`	`list`	Перечислить репозитории в проекте	✅
`repo_branch`	`get`	Получите ветку по имени	✅
`repo_branch`	`list`	Список веток в репозитории	✅
`repo_branch`	`list_mine`	Список ветвей, на которые текущий пользователь осуществил push	✅
`repo_file`	`get_content`	Получение текстового содержимого файла в определенной ветви, теге или коммите	✅
`repo_file`	`list_directory`	Перечисление файлов и папок в каталоге с необязательным рекурсивным перечислением	✅
`repo_search_commits`		Поиск коммитов с фильтрацией по тексту, автору, диапазону дат и другим параметрам.	✅
`search_code`		Полнотекстовый поиск кода	✅
`repo_pull_request_write`	`create`	Создание pull request	❌
`repo_pull_request_write`	`update`	Обновление запроса на вытягивание, включая настройку автозавершения	❌
`repo_pull_request_write`	`update_reviewers`	Добавление или удаление рецензентов запросов на вытягивание	❌
`repo_pull_request_write`	`vote`	Проголосовать по pull request	❌
`repo_pull_request_thread_write`	`create`	Создайте новый поток комментариев для pull request	❌
`repo_pull_request_thread_write`	`reply`	Ответ на комментарий в треде	❌
`repo_pull_request_thread_write`	`update_status`	Обновление состояния потока комментариев	❌
`repo_create_branch`		Создание ветви	❌

Остроумие

Инструменты рабочих элементов объединены в сгруппированные диспетчеры с использованием параметра action.

инструмент	Действие	Описание	Только для чтения
`wit_work_item`	`get`	Получите рабочий элемент по идентификатору	✅
`wit_work_item`	`get_batch`	Получение нескольких рабочих элементов по идентификаторам	✅
`wit_work_item`	`list_comments`	Список комментариев к рабочему элементу	✅
`wit_work_item`	`my`	Получение рабочих элементов, относящихся к аутентифицированному пользователю	✅
`wit_work_item`	`list_revisions`	Список версий рабочего элемента	✅
`wit_work_item`	`list_for_iteration`	Перечень рабочих задач для итерации команды	✅
`wit_work_item`	`get_type`	Получение метаданных для типа рабочего элемента	✅
`wit_query`	`get`	Получить запрос по идентификатору или пути	✅
`wit_query`	`get_results`	Выполнение сохраненного запроса	✅
`wit_query`	`search`	Поиск запросов по имени	✅
`wit_query`	`list`	Вывод списка корневых папок запросов и их дочерних элементов	✅
`wit_query_by_wiql`		Выполнение запроса WIQL и возвращение соответствующих рабочих элементов	✅
`wit_backlog`	`list`	Вывод списка уровней невыполненной работы для команды	✅
`wit_backlog`	`list_work_items`	Вывод списка рабочих элементов на определенном уровне невыполненной работы	✅
`search_workitem`		Поиск полнотекстовых рабочих элементов	✅
`wit_work_item_write`	`create`	Создание нового рабочего элемента	❌
`wit_work_item_write`	`update`	Обновление полей для рабочего элемента	❌
`wit_work_item_write`	`update_batch`	Обновление нескольких рабочих элементов в одном вызове	❌
`wit_work_item_write`	`add_child`	Создание дочерних рабочих элементов для родительского элемента	❌
`wit_work_item_comment_write`	`add`	Добавление комментария в рабочий элемент	❌
`wit_work_item_comment_write`	`update`	Обновление существующего комментария для рабочего элемента	❌
`wit_work_item_link_write`	`link`	Связывание двух рабочих элементов	❌
`wit_work_item_link_write`	`unlink`	Удаление ссылок из рабочего элемента	❌
`wit_work_item_link_write`	`link_to_pull_request`	Связать рабочий элемент с пул-реквестом	❌
`wit_work_item_link_write`	`add_artifact_link`	Добавить ссылку на репозиторий, ветвь, коммит, сборку или артефакт wiki в рабочий элемент	❌
`wit_work_item_attachment`		Скачивание вложения рабочего элемента по идентификатору; возвращает содержимое в кодировке base64 с именем файла и типом MIME	✅

Замечание

wit_query_by_wiql в настоящее время доступен только для инсайдеров MCP с помощью заголовка X-MCP-Insiders.

Трубопроводы

Инструменты конвейера объединены в сгруппированные диспетчеры с использованием параметра action.

инструмент	Действие	Описание	Только для чтения
`pipelines_build`	`list`	Перечисление сборок с опциональными фильтрами	✅
`pipelines_build`	`get_status`	Получение состояния, проблем и метаданных отчета для сборки	✅
`pipelines_build`	`get_changes`	Получение коммитов и рабочих элементов, связанных со сборкой	✅
`pipelines_build_log`	`list`	Перечислить доступные журналы сборки	✅
`pipelines_build_log`	`get_content`	Получение текстового содержимого определенного журнала по идентификатору	✅
`pipelines_definition`	`list`	Список определений процесса с необязательными фильтрами	✅
`pipelines_definition`	`list_revisions`	История изменений по определению конвейерной системы	✅
`pipelines_run`	`get`	Получение одного запуска конвейера	✅
`pipelines_run`	`list`	Список запусков для конвейера	✅
`pipelines_artifact`	`list`	Перечислить артефакты для сборки	✅
`pipelines_artifact`	`download`	Скачать именованный артефакт сборки	✅
`pipelines_write`	`run_pipeline`	Очередь нового запуска конвейера	❌
`pipelines_write`	`create_pipeline`	Создайте новое определение конвейера YAML	❌
`pipelines_write`	`update_build_stage`	Отмена, повторная попытка или запуск этапа в тестовой сборке	❌

Вики

Операции чтения вики-сайта объединяются в один wiki инструмент. action Используйте параметр для выбора операции.

инструмент	Действие	Описание	Только для чтения
`wiki`	`list_wikis`	Список вики-сайтов в проекте или организации	✅
`wiki`	`get_wiki`	Получите вики-сайт по идентификатору	✅
`wiki`	`list_pages`	Список страниц в вики	✅
`wiki`	`get_page`	Получение содержимого и метаданных страницы	✅
`search_wiki`		Полнотекстовый вики-поиск	✅
`wiki_upsert_page`		Создание или обновление вики-страницы	❌

Планы тестирования

Инструменты плана тестирования объединяются в сгруппированные диспетчеры с использованием параметра action.

инструмент	Действие	Описание	Только для чтения
`testplan`	`list_plans`	Вывести список планов тестирования в проекте	✅
`testplan`	`list_suites`	Вывести список наборов тестов в рамках плана тестирования	✅
`testplan`	`list_cases`	Вывести список тест-кейсов, входящих в набор тестов	✅
`testplan_show_test_results_from_build_id`		Получение результатов теста из сборки	✅
`testplan_test_run`	`get_results`	Получить результаты тестового запуска с необязательной детализацией и фильтрами по исходу	✅
`testplan_test_plan_write`	`create`	Создайте план тестирования	❌
`testplan_test_suite_write`	`create`	Создание набора тестов	❌
`testplan_test_suite_write`	`add_test_cases`	Добавление тестовых вариантов в набор	❌
`testplan_test_case_write`	`create`	Создание тестового случая	❌
`testplan_test_case_write`	`update_steps`	Обновить шаги тестового примера	❌
`testplan_test_run_write`	`create_run`	Создание тестового запуска для выполнения тестов вручную	❌
`testplan_test_run_write`	`update_results`	Обновить результаты и сведения о результатах тестов в прогоне	❌
`testplan_test_run_write`	`complete_run`	Завершить или прервать тестовый запуск на основе его результатов	❌
`testplan_test_run_write`	`update_test_point_outcome`	Обновить или сбросить результаты для контрольных точек	❌

Передовая безопасность

Средства Advanced Security объединены в групповой диспетчер, использующий параметр action.

инструмент	Действие	Описание	Только для чтения
`advsec_alerts`	`list`	Вывод списка оповещений расширенной безопасности для репозитория с необязательными фильтрами	✅
`advsec_alerts`	`get`	Получение оповещения расширенной безопасности по идентификатору	✅

Корпоративная миграция в реальном времени (предварительная версия)

Средства Enterprise Live Migration используют параметр action для группировки и отправки задач. Дополнительные сведения о предварительной версии Enterprise Live Migration.

Это важно

Поддержка ELM в удаленном Azure DevOps MCP-сервере в настоящее время находится в предварительной версии. Средства включены по умолчанию.

инструмент	Действие	Описание	Только для чтения
`enterprise_live_migration`	`list`	Получение списка миграций для организации; необязательный фильтр по проекту и флаг includeAllMigrations	✅
`enterprise_live_migration`	`get`	Получить статус миграции для репозитория	✅
`enterprise_live_migration`	`get_cutover_review`	Получите сбойные или заблокированные элементы перед переключением	✅
`enterprise_live_migration`	`get_device_flow_config`	Получение конфигурации потока аутентификации для устройств приложения GitHub	✅
`enterprise_live_migration`	`list_pipelines`	Список конвейеров и статус перенастройки	✅
`enterprise_live_migration_write`	`create`	Создать новую миграцию	❌
`enterprise_live_migration_write`	`pause`	Приостановка активной миграции	❌
`enterprise_live_migration_write`	`resume`	Возобновление приостановленной миграции	❌
`enterprise_live_migration_write`	`cutover_set`	Запланируйте дату перехода	❌
`enterprise_live_migration_write`	`cutover_cancel`	Отменить запланированное переключение	❌
`enterprise_live_migration_write`	`approve_cutover`	Игнорируйте сбои и продолжайте переключение	❌
`enterprise_live_migration_write`	`abandon`	Окончательное удаление миграции	❌
`enterprise_live_migration_pipelines_write`	`submit`	Отправка конвейеров для повторной настройки	❌
`enterprise_live_migration_pipelines_write`	`update`	Обновите конфигурацию перекоммутации конвейера	❌
`enterprise_live_migration_pipelines_write`	`delete`	Удалить все клоны конвейеров для миграции терминала	❌

Чтобы были доступны только инструменты 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": []
}

Поддерживаемые среды

Для подключения к Microsoft Entra ID, удалённый сервер Azure DevOps MCP требует учетной записи пользователя и подключения к организации Azure DevOps.

По умолчанию не все клиенты MCP поддерживают проверку подлинности Microsoft Entra. В некоторых средах требуются дополнительные шаги для регистрации клиентского приложения.

Поддерживаемые среды для удалённой конечной точки при доступной аутентификации Microsoft Entra включают:

Visual Studio с помощью GitHub Copilot
Visual Studio
Microsoft Foundry
Студия Microsoft Copilot
GitHub Copilot CLI
приложение GitHub Copilot
Cursor или Claude Code с пользовательской регистрацией приложения Microsoft Entra

Это важно

Claude Desktop и Codex в настоящее время не поддерживают поток проверки подлинности Microsoft Entra, необходимый удаленному Azure DevOps MCP-серверу. Используйте локальный СЕРВЕР MCP с этими клиентами.

Visual Studio Code

Чтобы настроить удаленный сервер MCP в Visual Studio Code, выполните следующие действия.

Добавьте файл .vscode/mcp.json в ваш репозиторий с конфигурацией mcp.json, показанной ранее.
Сохраните файл.
Откройте GitHub Copilot в VS Code.
При появлении запроса выполните проверку подлинности с помощью учетной записи Microsoft Entra и выберите свою учетную запись.

После завершения проверки подлинности появится список доступных средств.

Visual Studio (2022 и более поздние версии)

Настройте удаленный сервер MCP в Visual Studio, добавив URL-адрес сервера в параметры MCP. Дополнительные сведения см. в разделе Использование серверов MCP в Visual Studio.

Cursor

Cursor требует пользовательской регистрации приложения Microsoft Entra для доступа к удалённому MCP-серверу Azure DevOps.

Регистрация приложения

Убедитесь, что корпоративное приложение Azure DevOps MCP подготовлено в вашем арендаторе. Если не удается его найти, см. Не удается найти корпоративное приложение MCP Azure DevOps в тенанте.
В Центр администрирования Microsoft Entra перейдите к Регистрация приложений и создайте регистрацию приложения.
При регистрации приложения выберите Проверка подлинности (предварительная версия)>Добавить URI перенаправления>Мобильные и классические приложения.
Введите http://localhost:8787/callback URI перенаправления и сохраните изменения.
На странице проверки подлинности (предварительная версия) выберите вкладку "Параметры ", а затем включите общедоступные потоки клиентов.
На странице Разрешения API выберите Добавить разрешениеAPI, используемые моей организацией.
Найдите Azure DevOps MCP или идентификатор 2a72489c-aab2-4b65-b93a-a91edccf33b8приложения, а затем выберите приложение.
Выберите делегированные разрешения, необходимые приложению, а затем нажмите кнопку "Добавить разрешения".
Выберите Предоставить согласие администратора. В зависимости от вашей роли может потребоваться, чтобы администратор арендатора выполнил этот шаг.

Скопируйте идентификатор приложения (клиента) из регистрации приложения. Это значение необходимо для настройки Курсора.

Настройка курсора

В Cursor откройте Настройки>Инструменты и MCP.
Выберите новый сервер MCP.
Добавьте следующую конфигурацию, заменив {client-id} на идентификатор приложения (клиента), который вы скопировали:
```
{
  "mcpServers": {
    "ado": {
      "url": "https://mcp.dev.azure.com",
      "type": "http",
      "auth": {
        "CLIENT_ID": "{client-id}"
      }
    }
  }
}
```
Сохраните конфигурацию, а затем вернитесь в Настройки>Инструменты и MCP.
Найдите сервер ado и нажмите кнопку "Проверка подлинности".

Код Клода

Claude Code требует пользовательской регистрации приложения Microsoft Entra для доступа к удаленному Azure DevOps MCP-серверу.

Регистрация приложения

Убедитесь, что корпоративное приложение Azure DevOps MCP подготовлено в вашем арендаторе. Если не удается его найти, см. Не удается найти корпоративное приложение MCP Azure DevOps в тенанте.
В Центр администрирования Microsoft Entra перейдите к Регистрация приложений и создайте регистрацию приложения.
При регистрации приложения выберите Проверка подлинности (предварительная версия)>Добавить URI перенаправления>Мобильные и классические приложения.
Введите http://localhost:3118/callback URI перенаправления и сохраните изменения.
На странице проверки подлинности (предварительная версия) выберите вкладку "Параметры ", а затем включите общедоступные потоки клиентов.
На странице Разрешения API выберите Добавить разрешениеAPI, используемые моей организацией.
Найдите Azure DevOps MCP или идентификатор 2a72489c-aab2-4b65-b93a-a91edccf33b8приложения, а затем выберите приложение.
Выберите делегированные разрешения, необходимые приложению, а затем нажмите кнопку "Добавить разрешения".
Выберите Предоставить согласие администратора. В зависимости от вашей роли может потребоваться, чтобы администратор арендатора выполнил этот шаг.

Скопируйте идентификатор приложения (клиента) из регистрации приложения. Это значение необходимо для настройки Claude Code.

Настройка кода Claude

Выполните следующую команду, заменив {client-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
      }
    }
  }
}
```
Запустите Claude Code, выполнив команду claude.
Запустите /mcp, и затем следуйте инструкциям по входу в браузере, чтобы выполнить аутентификацию с помощью своей учетной записи Microsoft Entra.

Дополнительные сведения об этих параметрах см. в разделе Подключение Claude Code к инструментам через MCP.

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

После настройки убедитесь, что удаленный сервер MCP работает, задав помощнику по ИИ вопрос о ваших Azure DevOps данных.

Примеры:

Перечислите проекты в моей организации Azure DevOps.
"Показать назначенные рабочие элементы".
Какие пулл-реквесты требуют моей проверки?

Если помощник по искусственному интеллекту возвращает результаты из Azure DevOps организации, удаленный сервер MCP настроен правильно.

Использование ИИ для проверки и устранения неполадок удаленной установки MCP

Следующие примеры запросов для Copilot Chat помогут вам выбрать правильный подход к MCP, настроить и проверить удалённую конфигурацию, улучшить запросы для повседневного использования и при необходимости устранить неполадки. Скопируйте и вставьте эти запросы в Copilot Chat и замените заполнители фактическими сведениями о организации, клиенте и ошибке.

задачи	Пример запроса
Выберите удалённый или локальный	`For my environment and client tools, help me decide whether to use the remote Azure DevOps MCP Server or the local server, and explain the tradeoffs.`
Создание конфигурации с наименьшими привилегиями	`Generate a remote mcp.json configuration for organization <contoso> that uses only the needed toolsets and read-only mode.`
Проверьте установку `mcp.json`	`Review this remote Azure DevOps MCP server configuration and tell me whether anything is missing or incorrect for Visual Studio Code.`
Проверьте предположения об аутентификации	`Help me verify whether this remote MCP setup can authenticate with Microsoft Entra ID for organization <contoso>.`
Улучшайте подсказки для запросов для повседневной работы	`Give me better prompt wording to reliably fetch fresh Azure DevOps data from remote MCP for project <project-name>, including how to avoid stale results.`
Диагностика отказа подключения	`I'm getting Connection Refused when connecting to https://mcp.dev.azure.com/<organization>. Give me step-by-step network, proxy, and firewall checks to fix it.`
Диагностика отсутствующих данных	`The remote MCP server connects, but queries return no data. Help me determine whether this is a permissions issue or missing project context.`
Отладка заголовков фильтров инструментов	`Check my X-MCP-Toolsets and X-MCP-Tools header configuration and explain why expected tools are not appearing.`

Copilot работает на основе ИИ, поэтому возможны сюрпризы и ошибки. Дополнительные сведения см. в статье Copilot часто задаваемые вопросы об использовании.

Troubleshooting

Issue	Решение
Проверка подлинности завершается ошибкой	Проверьте учетные данные Microsoft Entra и убедитесь, что у вас есть доступ к организации Azure DevOps.
Сервер не найден	Проверьте формат URL-адреса сервера: `https://mcp.dev.azure.com/{organization}`
Отклонено подключение	Убедитесь, что в вашей сети разрешены исходящие HTTPS-подключения к `mcp.dev.azure.com`. Если вы находитесь на корпоративном прокси-сервере или брандмауэре, попросите администратора разрешить список конечной точки и повторить попытку без VPN, чтобы изолировать проблемы с сетевым путем.
Данные не возвращаются	Убедитесь, что у вас есть соответствующие разрешения для запрашиваемого проекта или ресурсов.
Средства ELM недоступны	Средства ELM включены по умолчанию. Если вы ограничиваете доступные наборы инструментов, убедитесь, что заголовок `X-MCP-Toolsets` содержит `elm`. Затем повторно подключите сервер MCP и убедитесь, что ваша учетная запись имеет необходимые разрешения в Azure DevOps. Предварительные требования см. в обзоре Enterprise Live Migrations.

Для поддержки можно создать проблему в локальном репозитории СЕРВЕРА MCP . Обязательно используйте шаблон удаленной проблемы.

Вопросы и ответы

Что касается других клиентов, таких как Claude Desktop или Codex?

Claude Desktop и Codex требуют динамической регистрации идентификатора клиента OAuth в Microsoft Entra ID, прежде чем они смогут использовать удаленный СЕРВЕР MCP. Microsoft Entra ID в настоящее время не поддерживает поток динамической регистрации клиентов, который требуется этим клиентам. Используйте локальный СЕРВЕР MCP с этими клиентами.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-09-03

Настройте удалённый сервер MCP Azure DevOps

Сначала выберите удалённый доступ

Необходимые условия

конфигурация mcp.json

Наборы инструментов

Средства только для чтения

Совмещение наборов инструментов и фильтрация в режиме только для чтения

Отдельные инструменты

Инсайдеры

Доступные средства

Основные средства

Работа

Repos

Остроумие

Трубопроводы

Вики

Планы тестирования

Передовая безопасность

Корпоративная миграция в реальном времени (предварительная версия)

Поддерживаемые среды

Visual Studio Code

Visual Studio (2022 и более поздние версии)

Cursor

Регистрация приложения

Настройка курсора

Код Клода

Регистрация приложения

Настройка кода Claude

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

Использование ИИ для проверки и устранения неполадок удаленной установки MCP

Troubleshooting

Вопросы и ответы

Что касается других клиентов, таких как Claude Desktop или Codex?

Связанный контент

Обратная связь

Дополнительные ресурсы