Skip to main content
Glama

@slorenzot/mcp-azure

MCP-сервер (Model Context Protocol) для Azure DevOps. Позволяет взаимодействовать с рабочими элементами (Work Items), Git-репозиториями, Pull Request'ами, спринтами, областями, комментариями и вложениями из любого совместимого MCP-клиента.

Установка

npm install -g @slorenzot/mcp-azure

Или используйте напрямую через npx:

npx @slorenzot/mcp-azure

Настройка

Переменные окружения

Сервер автоматически настраивается с использованием следующих переменных окружения:

Переменная

Альтернатива

Описание

Обязательно

AZURE_DEVOPS_ORG

ADO_ORG

URL организации (например: https://dev.azure.com/my-org)

Да

AZURE_DEVOPS_PAT

ADO_PAT

Personal Access Token

Да

AZURE_DEVOPS_PROJECT

ADO_PROJECT

Имя проекта

Нет

Настройка в Claude Desktop

Добавьте следующую конфигурацию в ваш файл claude_desktop_config.json:

{
  "mcpServers": {
    "azure-devops": {
      "command": "npx",
      "args": ["-y", "@slorenzot/mcp-azure"],
      "env": {
        "AZURE_DEVOPS_ORG": "https://dev.azure.com/tu-organizacion",
        "AZURE_DEVOPS_PAT": "tu-pat-aqui",
        "AZURE_DEVOPS_PROJECT": "tu-proyecto"
      }
    }
  }
}

Настройка в OpenCode

OpenCode использует тот же MCP, но настройку можно выполнить двумя способами:

Вариант 1: Начальная настройка с переменными окружения

  1. Настройте переменные окружения в вашей системе или в конфигурации OpenCode:

    export AZURE_DEVOPS_ORG="https://dev.azure.com/tu-organizacion"
    export AZURE_DEVOPS_PAT="tu-pat-aqui"
    export AZURE_DEVOPS_PROJECT="tu-proyecto"
  2. Или добавьте MCP-сервер в вашу конфигурацию OpenCode:

    {
      "mcpServers": {
        "azure-devops": {
          "command": "npx",
          "args": ["-y", "@slorenzot/mcp-azure"],
          "env": {
            "AZURE_DEVOPS_ORG": "https://dev.azure.com/tu-organizacion",
            "AZURE_DEVOPS_PAT": "tu-pat-aqui",
            "AZURE_DEVOPS_PROJECT": "tu-proyecto"
          }
        }
      }
    }

Вариант 2: Динамическая настройка с помощью ado_configure

OpenCode позволяет настроить подключение непосредственно во время сессии с помощью команды ado_configure:

{
  "organization": "https://dev.azure.com/tu-organizacion",
  "project": "tu-proyecto",
  "pat": "tu-pat-aqui"
}

Этот вариант полезен для переключения между различными организациями или проектами без изменения файла конфигурации.

Примечание: При использовании ado_configure подключение сохраняется в течение текущей сессии OpenCode.

Получение Personal Access Token (PAT)

  1. Перейдите в свою организацию Azure DevOps

  2. Нажмите на свой аватар (в правом верхнем углу)

  3. Выберите Personal Access Tokens

  4. Создайте новый токен со следующими разрешениями:

    • Work Items: Read & Write

    • Code: Read & Write (для операций с репозиториями и Pull Request'ами)

    • Project and Team: Read (опционально)

Доступные инструменты

Аутентификация

Инструмент

Описание

ado_configure

Настраивает подключение к организации, проекту и PAT

Work Items

Инструмент

Описание

ado_get_work_item

Получает Work Item по его ID

ado_create_work_item

Создает новый Work Item (User Story, Bug, Task и т.д.)

ado_update_work_item

Обновляет существующий Work Item

ado_get_work_item_type_fields

Получает доступные/обязательные поля для типа элемента

Запросы

Инструмент

Описание

ado_query_sprint

Запрашивает Work Items конкретного спринта

ado_query_area

Запрашивает Work Items конкретной области

ado_query_wiql

Выполняет пользовательский запрос WIQL

Структура проекта

Инструмент

Описание

ado_list_iterations

Выводит список итераций/спринтов проекта

ado_list_areas

Выводит список областей проекта

Git-репозитории

Инструмент

Описание

ado_list_repositories

Выводит список всех Git-репозиториев проекта

ado_get_repository

Получает детали конкретного репозитория по имени или ID

ado_list_branches

Выводит список веток (branches) репозитория

Pull Requests

Инструмент

Описание

ado_list_pull_requests

Выводит список Pull Request'ов с опциональными фильтрами (статус, ветки, автор, рецензент)

ado_get_pull_request

Получает полные детали Pull Request'а

ado_create_pull_request

Создает новый Pull Request

ado_update_pull_request

Обновляет свойства Pull Request'а (заголовок, описание, черновик)

ado_complete_pull_request

Завершает (merge) Pull Request с настраиваемой стратегией

ado_abandon_pull_request

Отменяет Pull Request

Рецензирование Pull Request'ов

Инструмент

Описание

ado_approve_pull_request

Одобряет Pull Request (голос: 10)

ado_reject_pull_request

Отклоняет Pull Request (голос: -10)

ado_get_pull_request_reviewers

Получает всех рецензентов и их голоса для Pull Request'а

ado_add_pull_request_reviewer

Добавляет рецензента в Pull Request

Комментарии к Pull Request'ам

Инструмент

Описание

ado_get_pull_request_threads

Получает все ветки комментариев Pull Request'а

ado_create_pull_request_thread

Создает новую ветку комментариев (общую или к коду)

ado_reply_to_pull_request_thread

Отвечает на существующую ветку комментариев

Информация о Pull Request'ах

Инструмент

Описание

ado_get_pull_request_commits

Получает все коммиты Pull Request'а

ado_get_pull_request_work_items

Получает Work Items, связанные с Pull Request'ом

ado_update_pull_request_thread_status

Обновляет статус ветки комментариев (Fixed, WontFix и т.д.)

Комментарии и обсуждения

Инструмент

Описание

ado_add_comment

Добавляет комментарий к Work Item (поддерживает Markdown)

ado_get_comments

Получает комментарии Work Item'а

Вложения

Инструмент

Описание

ado_upload_attachment

Загружает файл и возвращает URL вложения

ado_add_attachment

Добавляет вложение к Work Item'у

ado_get_attachments

Выводит список вложений Work Item'а

Примеры использования

Создание User Story

{
  "title": "Implementar login con OAuth",
  "type": "User Story",
  "description": "Como usuario quiero poder iniciar sesión con mi cuenta de Google",
  "areaPath": "MiProyecto\\Backend",
  "iterationPath": "MiProyecto\\Sprint 5",
  "fields": {
    "Custom.OKR": "Seguridad",
    "Custom.Prioridad": "Alta"
  }
}

Пользовательский запрос WIQL

{
  "wiql": "SELECT [System.Id], [System.Title] FROM WorkItems WHERE [System.State] = 'Active' AND [System.AssignedTo] = @Me ORDER BY [System.CreatedDate] DESC",
  "getDetails": true
}

Добавление комментария с Markdown

{
  "id": 12345,
  "comment": "## Análisis completado\n\n- Revisado el código\n- Identificados 3 issues\n\n**Próximo paso:** Corregir validaciones"
}

Загрузка и прикрепление файла

{
  "workItemId": 12345,
  "filePath": "/ruta/al/archivo.pdf",
  "comment": "Documento de especificaciones",
  "name": "Especificaciones Funcionales v2.0"
}

Привязка существующего вложения

{
  "workItemId": 12345,
  "attachmentUrl": "https://dev.azure.com/org/proj/_apis/wit/attachments/abc123",
  "comment": "Diseño de arquitectura",
  "name": "Arquitectura del Sistema"
}

Список репозиториев

{
  "includeHidden": false,
  "top": 50
}

Список активных Pull Request'ов

{
  "status": "Active",
  "top": 20
}

Создание Pull Request'а

{
  "repositoryId": "mi-repo",
  "sourceRefName": "refs/heads/feature-login",
  "targetRefName": "refs/heads/main",
  "title": "Implementar login con OAuth",
  "description": "Esta PR agrega soporte para login con Google OAuth",
  "reviewerIds": ["12345678-1234-1234-1234-1234567890ab"],
  "isDraft": false
}

Одобрение Pull Request'а

{
  "pullRequestId": 12345,
  "repositoryId": "mi-repo"
}

Завершение (Merge) Pull Request'а

{
  "pullRequestId": 12345,
  "repositoryId": "mi-repo",
  "mergeStrategy": "Squash",
  "deleteSourceBranch": true,
  "mergeCommitMessage": "Merge de feature-login"
}

Создание комментария к коду

{
  "pullRequestId": 12345,
  "repositoryId": "mi-repo",
  "content": "Por favor extraer esto en una función separada",
  "filePath": "/src/components/Login.tsx",
  "startLine": 45,
  "endLine": 52
}

Доступные промпты

Сервер включает предопределенные промпты для упрощения типичных задач:

Промпт

Описание

connect

Руководство по подключению к Azure DevOps

analyze_sprint

Анализирует состояние спринта

create_user_story

Создает структурированную User Story

daily_standup

Генерирует отчет для ежедневного стендапа

plan_sprint

Помогает спланировать спринт

bulk_update

Обновляет несколько Work Items одновременно

project_report

Генерирует отчет по проекту

report_bug

Создает структурированный отчет об ошибке (Bug report)

Ресурсы

Ресурс

URI

Описание

Статус подключения

ado://connection/status

Информация о текущем статусе подключения

Разработка

Требования

  • Node.js 18+

  • npm или yarn

Локальная установка

git clone https://github.com/slorenzot/mcp-azure.git
cd mcp-azure
npm install
npm run build

Доступные скрипты

npm run build    # Compila TypeScript
npm run start    # Inicia el servidor
npm run dev      # Modo desarrollo con watch

Лицензия

MIT

Автор

Soulberto Lorenzo - @slorenzot

Версия

2.4.1 - 34 инструмента доступны для Azure DevOps (Work Items, Git-репозитории, Pull Request'ы и т.д.)

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - A tier

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/soulberto/mcp-azure'

If you have feedback or need assistance with the MCP directory API, please join our Discord server