Skip to main content
Glama

@slorenzot/mcp-azure

Azure DevOps를 위한 MCP(Model Context Protocol) 서버입니다. 호환되는 모든 MCP 클라이언트에서 작업 항목(Work Items), Git 리포지토리, Pull Request, 스프린트, 영역, 댓글 및 첨부 파일과 상호 작용할 수 있습니다.

설치

npm install -g @slorenzot/mcp-azure

또는 npx를 직접 사용하세요:

npx @slorenzot/mcp-azure

Related MCP server: devops-wrangler

구성

환경 변수

서버는 다음 환경 변수를 사용하여 자동으로 구성됩니다:

변수

대안

설명

필수

AZURE_DEVOPS_ORG

ADO_ORG

조직 URL (예: https://dev.azure.com/mi-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. 또는 OpenCode 구성에 MCP 서버를 추가합니다:

    {
      "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 세션 동안 유지됩니다.

개인 액세스 토큰(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

ID로 작업 항목 가져오기

ado_create_work_item

새 작업 항목 생성 (User Story, Bug, Task 등)

ado_update_work_item

기존 작업 항목 업데이트

ado_get_work_item_type_fields

유형의 사용 가능/필수 필드 가져오기

쿼리

도구

설명

ado_query_sprint

특정 스프린트의 작업 항목 쿼리

ado_query_area

특정 영역의 작업 항목 쿼리

ado_query_wiql

사용자 지정 WIQL 쿼리 실행

프로젝트 구조

도구

설명

ado_list_iterations

프로젝트의 반복 주기/스프린트 나열

ado_list_areas

프로젝트의 영역 나열

Git 리포지토리

도구

설명

ado_list_repositories

프로젝트의 모든 Git 리포지토리 나열

ado_get_repository

이름 또는 ID로 특정 리포지토리 세부 정보 가져오기

ado_list_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

구성 가능한 전략으로 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

Pull Request에 연결된 작업 항목 가져오기

ado_update_pull_request_thread_status

댓글 스레드 상태 업데이트 (Fixed, WontFix 등)

댓글 및 토론

도구

설명

ado_add_comment

작업 항목에 댓글 추가 (Markdown 지원)

ado_get_comments

작업 항목의 댓글 가져오기

첨부 파일

도구

설명

ado_upload_attachment

파일 업로드 및 첨부 파일 URL 반환

ado_add_attachment

작업 항목에 첨부 파일 추가

ado_get_attachments

작업 항목의 첨부 파일 나열

사용 예시

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"
}

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

여러 작업 항목 업데이트

project_report

프로젝트 보고서 생성

report_bug

구조화된 버그 보고서 생성

리소스

리소스

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 - Azure DevOps용 34개 도구 사용 가능 (작업 항목, Git 리포지토리, Pull Request 등)

Available Tools

36 tools
ado_abandon_pull_requestC

Abandona un Pull Request (cambia estado a Abandoned).

Inputs: pullRequestId (required), repositoryId.

ado_add_attachmentB

Agrega un adjunto a un Work Item existente. Maneja automáticamente concurrencia cuando múltiples adjuntos se agregan al mismo WI.

Inputs: workItemId (required), name, comment, filePath, +1 more.

ado_add_commentB

Agrega un comentario/entrada de discusión a un Work Item. Soporta formato Markdown.

Inputs: id (required), comment (required).

ado_add_pull_request_reviewerB

Agrega un revisor a un Pull Request.

Inputs: reviewerId (required), pullRequestId (required), vote, repositoryId.

ado_approve_pull_requestB

Aprueba un Pull Request (voto: 10).

Inputs: pullRequestId (required), reviewerId, repositoryId.

ado_complete_pull_requestC

Completa (merge) un Pull Request.

Inputs: pullRequestId (required), repositoryId, mergeStrategy, deleteSourceBranch, +2 more.

ado_configureB

Configura la conexión a Azure DevOps con token de acceso personal (PAT).

Inputs: pat (required), project (required), organization (required).

ado_create_pull_requestC

Crea un nuevo Pull Request.

Inputs: title (required), repositoryId (required), sourceRefName (required), targetRefName (required), +3 more.

ado_create_pull_request_threadB

Crea un nuevo hilo de comentarios (comentario general o comentario de código).

Inputs: content (required), pullRequestId (required), endLine, filePath, +2 more.

ado_create_work_itemA

Crea un nuevo Work Item en Azure DevOps. Usa ado_get_work_item_type_fields para ver campos requeridos.

Inputs: type (required), title (required), fields, areaPath, +3 more.

ado_delete_attachmentB

Elimina un adjunto de un Work Item removiendo su relación. Maneja automáticamente concurrencia cuando múltiples cambios afectan el mismo WI.

Inputs: workItemId (required), comment, attachmentUrl, attachmentName.

ado_delete_work_itemA

Elimina un Work Item en Azure DevOps. Por defecto realiza borrado lógico; usa destroy=true solo para eliminación permanente.

Inputs: id (required), confirm (required), destroy, expectedType.

ado_get_attachmentsB

Obtiene la lista de adjuntos de un Work Item

Inputs: id (required).

ado_get_commentsB

Obtiene los comentarios/historial de discusión de un Work Item

Inputs: id (required), top.

ado_get_pull_requestC

Obtiene detalles completos de un Pull Request.

Inputs: pullRequestId (required), repositoryId, includeCommits, includeWorkItems.

ado_get_pull_request_commitsC

Obtiene todos los commits de un Pull Request.

Inputs: pullRequestId (required), top, repositoryId.

ado_get_pull_request_reviewersA

Obtiene todos los revisores y sus votos de un Pull Request.

Inputs: pullRequestId (required), repositoryId.

ado_get_pull_request_threadsB

Obtiene todos los hilos de comentarios de un Pull Request.

Inputs: pullRequestId (required), repositoryId.

ado_get_pull_request_work_itemsB

Obtiene los work items vinculados a un Pull Request.

Inputs: pullRequestId (required), repositoryId.

ado_get_repositoryB

Obtiene detalles de un repositorio específico por nombre o ID.

Inputs: repositoryId (required).

ado_get_work_itemB

Obtiene un Work Item de Azure DevOps por su ID

Inputs: id (required), full.

ado_get_work_item_type_fieldsB

Obtiene los campos disponibles y requeridos para un tipo de Work Item

Inputs: workItemType (required).

ado_list_areasA

Lista las áreas disponibles en el proyecto

Inputs: no named parameters.

ado_list_branchesB

Lista las ramas (branches) de un repositorio.

Inputs: repositoryId (required), filter, includeStatuses.

ado_list_iterationsA

Lista las iteraciones/sprints disponibles en el proyecto

Inputs: no named parameters.

ado_list_pull_requestsA

Lista Pull Requests con filtros opcionales. Busca por repositorio o en todo el proyecto.

Inputs: top, status, creatorId, reviewerId, +3 more.

ado_list_repositoriesA

Lista todos los repositorios Git del proyecto.

Inputs: top, includeHidden.

ado_query_areaC

Consulta User Stories de un área específica en Azure DevOps

Inputs: areaPath (required), workItemType.

ado_query_sprintA

Consulta User Stories de un sprint específico en Azure DevOps

Inputs: iterationPath (required), state.

ado_query_wiqlC

Ejecuta una consulta WIQL personalizada en Azure DevOps

Inputs: wiql (required), getDetails.

ado_reject_pull_requestC

Rechaza un Pull Request (voto: -10).

Inputs: pullRequestId (required), reviewerId, repositoryId.

ado_reply_to_pull_request_threadC

Responde a un hilo de comentarios existente.

Inputs: content (required), threadId (required), pullRequestId (required), repositoryId.

ado_update_pull_requestC

Actualiza propiedades de un Pull Request (título, descripción, estado de borrador).

Inputs: pullRequestId (required), title, isDraft, description, +1 more.

ado_update_pull_request_thread_statusC

Actualiza el estado de un hilo de comentarios (ej: marcar como Fixed, WontFix, etc.).

Inputs: status (required), threadId (required), pullRequestId (required), repositoryId.

ado_update_work_itemC

Actualiza un Work Item existente en Azure DevOps

Inputs: id (required), state, title, fields, +2 more.

ado_upload_attachmentC

Sube un archivo como adjunto a Azure DevOps y devuelve la URL del adjunto

Inputs: filePath (required), fileName.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 36 tools

    Disambiguation5/5

    Each tool targets a distinct action and resource (e.g., create vs update vs delete work items, add vs upload attachments). No two tools have ambiguous purposes, ensuring clear agent selection.

    Naming Consistency5/5

    All tools follow the consistent pattern 'ado_verb_noun' (e.g., ado_create_work_item, ado_list_repositories). The prefix and verb-noun structure are uniform, making it easy to predict tool names.

    Tool Count4/5

    36 tools is slightly above the typical range, but the Azure DevOps domain is broad. Each tool covers a necessary operation (work items, PRs, repositories, queries, etc.), so the count feels justified rather than bloated.

    Completeness4/5

    The tool surface covers the main workflows: CRUD for work items and pull requests, attachments, comments, threads, repositories, and queries. Minor gaps exist (e.g., no create/delete branch or build pipeline tools), but core operations are present.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers