@slorenzot/mcp-azure
@slorenzot/mcp-azure
Servidor MCP (Model Context Protocol) para Azure DevOps. Permite interactuar con Work Items, repositorios Git, Pull Requests, sprints, áreas, comentarios y adjuntos desde cualquier cliente MCP compatible.
Instalación
npm install -g @slorenzot/mcp-azureO usar directamente con npx:
npx @slorenzot/mcp-azureRelated MCP server: devops-wrangler
Configuración
Variables de Entorno
El servidor se configura automáticamente usando las siguientes variables de entorno:
Variable | Alternativa | Descripción | Requerido |
|
| URL de la organización (ej: | Sí |
|
| Personal Access Token | Sí |
|
| Nombre del proyecto | No |
Configuración con .mcp.json
El servidor también puede leer credenciales desde un archivo .mcp.json, buscándolo en este orden:
Directorio actual
Directorio padre
Directorio del script
Home del usuario
Ejemplo:
{
"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"
}
}
}
}Configuración en Claude Desktop
Agrega la siguiente configuración en tu archivo 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"
}
}
}
}Configuración en OpenCode
OpenCode utiliza el mismo MCP, pero la configuración se puede hacer de dos formas:
Opción 1: Configuración inicial con variables de entorno
Configura las variables de entorno en tu sistema o en tu configuración de OpenCode:
export AZURE_DEVOPS_ORG="https://dev.azure.com/tu-organizacion" export AZURE_DEVOPS_PAT="tu-pat-aqui" export AZURE_DEVOPS_PROJECT="tu-proyecto"O agrega el servidor MCP en tu configuración de 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" } } } }
Opción 2: Configuración dinámica con ado_configure
OpenCode permite configurar la conexión directamente durante la sesión usando el comando ado_configure:
{
"organization": "https://dev.azure.com/tu-organizacion",
"project": "tu-proyecto",
"pat": "tu-pat-aqui"
}Esta opción es útil para cambiar entre diferentes organizaciones o proyectos sin modificar el archivo de configuración.
Nota: Cuando usas ado_configure, la conexión persiste durante la sesión actual de OpenCode.
Obtener un Personal Access Token (PAT)
Ve a tu organización de Azure DevOps
Haz clic en tu avatar (esquina superior derecha)
Selecciona Personal Access Tokens
Crea un nuevo token con los siguientes permisos:
Work Items: Read & Write
Code: Read & Write (para operaciones de repositorios y Pull Requests)
Project and Team: Read (opcional)
Herramientas Disponibles
Autenticación
Herramienta | Descripción |
| Configura la conexión con organización, proyecto y PAT |
Work Items
Herramienta | Descripción |
| Obtiene un Work Item por su ID |
| Crea un nuevo Work Item (User Story, Bug, Task, etc.) |
| Actualiza un Work Item existente |
| Elimina un Work Item en Azure DevOps (soft delete por defecto) |
| Obtiene los campos disponibles/requeridos de un tipo |
| Crea una relación (Parent/Child/Related/Duplicate/Successor/Predecessor) entre dos Work Items |
| Elimina una relación existente entre dos Work Items |
Consultas
Herramienta | Descripción |
| Consulta Work Items de un sprint específico |
| Consulta Work Items de un área específica |
| Ejecuta una consulta WIQL personalizada |
Estructura del Proyecto
Herramienta | Descripción |
| Lista las iteraciones/sprints del proyecto |
| Lista las áreas del proyecto |
Repositorios Git
Herramienta | Descripción |
| Lista todos los repositorios Git del proyecto |
| Obtiene detalles de un repositorio específico por nombre o ID |
| Lista las ramas (branches) de un repositorio |
Pull Requests
Herramienta | Descripción |
| Lista Pull Requests con filtros opcionales (status, branches, creador, revisor) |
| Obtiene detalles completos de un Pull Request |
| Crea un nuevo Pull Request |
| Actualiza propiedades de un Pull Request (título, descripción, draft) |
| Completa (merge) un Pull Request con estrategia configurable |
| Abandona un Pull Request |
Pull Request Reviews
Herramienta | Descripción |
| Aprueba un Pull Request (voto: 10) |
| Rechaza un Pull Request (voto: -10) |
| Obtiene todos los revisores y sus votos de un Pull Request |
| Agrega un revisor a un Pull Request |
Pull Request Comments
Herramienta | Descripción |
| Obtiene todos los hilos de comentarios de un Pull Request |
| Crea un nuevo hilo de comentarios (general o de código) |
| Responde a un hilo de comentarios existente |
| Actualiza el estado de un hilo de comentarios (Fixed, WontFix, etc.) |
Pull Request Info
Herramienta | Descripción |
| Obtiene todos los commits de un Pull Request |
| Obtiene los Work Items vinculados a un Pull Request |
Búsqueda de Identidades
Herramienta | Descripción |
| Busca usuarios por nombre o email. Devuelve el ID de identidad (UUID) necesario para menciones en comentarios |
Comentarios y Discusiones
Herramienta | Descripción |
| Agrega un comentario a un Work Item (soporta Markdown y menciones con |
| Obtiene los comentarios de un Work Item, incluyendo menciones resueltas |
Adjuntos
Herramienta | Descripción |
| Sube un archivo y devuelve la URL del adjunto |
| Agrega un adjunto a un Work Item |
| Elimina un adjunto de un Work Item removiendo su relación |
| Lista los adjuntos de un Work Item |
Ejemplos de Uso
Crear una 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"
}
}Consulta WIQL Personalizada
{
"wiql": "SELECT [System.Id], [System.Title] FROM WorkItems WHERE [System.State] = 'Active' AND [System.AssignedTo] = @Me ORDER BY [System.CreatedDate] DESC",
"getDetails": true
}Agregar Comentario con Markdown
{
"id": 12345,
"comment": "## Análisis completado\n\n- Revisado el código\n- Identificados 3 issues\n\n**Próximo paso:** Corregir validaciones"
}Agregar Comentario con Mención
Las menciones requieren el ID de identidad (UUID) del usuario. Hay dos formas de obtenerlo:
Buscar usuario con
ado_search_users:
{
"searchTerm": "Juan Pérez"
}Obtener ID desde un Work Item — los campos
System.AssignedTo,System.CreatedByoSystem.ChangedBycontienen elidde identidad.
Luego, agregar el comentario con la mención:
{
"id": 12345,
"comment": "@Juan Pérez ¿podrías revisar este cambio?",
"mentions": [
{
"name": "Juan Pérez",
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
]
}Nota: El texto del comentario debe incluir
@DisplayNameo@{DisplayName}en la posición donde quieras la mención. El MCP reemplaza automáticamente con el HTML de mención de Azure DevOps.
Subir y Adjuntar Archivo
{
"workItemId": 12345,
"filePath": "/ruta/al/archivo.pdf",
"comment": "Documento de especificaciones",
"name": "Especificaciones Funcionales v2.0"
}Vincular Adjunto Existente
{
"workItemId": 12345,
"attachmentUrl": "https://dev.azure.com/org/proj/_apis/wit/attachments/abc123",
"comment": "Diseño de arquitectura",
"name": "Arquitectura del Sistema"
}Eliminar Adjunto de un Work Item
{
"workItemId": 12345,
"attachmentUrl": "https://dev.azure.com/org/proj/_apis/wit/attachments/abc123",
"comment": "Adjunto agregado por error"
}Eliminar una User Story
{
"id": 12345,
"confirm": true,
"destroy": false,
"expectedType": "User Story"
}ado_delete_work_item exige confirm: true. Si envías destroy: true, la eliminación es permanente.
Listar Repositorios
{
"includeHidden": false,
"top": 50
}Listar Pull Requests Activos
{
"status": "Active",
"top": 20
}Crear un 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
}Aprobar un Pull Request
{
"pullRequestId": 12345,
"repositoryId": "mi-repo"
}Completar (Merge) un Pull Request
{
"pullRequestId": 12345,
"repositoryId": "mi-repo",
"mergeStrategy": "Squash",
"deleteSourceBranch": true,
"mergeCommitMessage": "Merge de feature-login"
}Crear Comentario en Código
{
"pullRequestId": 12345,
"repositoryId": "mi-repo",
"content": "Por favor extraer esto en una función separada",
"filePath": "/src/components/Login.tsx",
"startLine": 45,
"endLine": 52
}Prompts Disponibles
El servidor incluye prompts predefinidos para facilitar tareas comunes:
Prompt | Descripción |
| Guía para conectarse a Azure DevOps |
| Analiza el estado de un sprint |
| Crea una User Story estructurada |
| Genera un reporte de standup diario |
| Ayuda a planificar un sprint |
| Actualiza múltiples Work Items |
| Genera un reporte del proyecto |
| Crea un Bug report estructurado |
Recursos
Recurso | URI | Descripción |
Estado de conexión |
| Información del estado de conexión actual |
Desarrollo
Requisitos
Node.js 18+
npm o yarn
Instalación local
git clone https://github.com/slorenzot/mcp-azure.git
cd mcp-azure
npm install
npm run buildScripts disponibles
npm run build # Compila TypeScript
npm run start # Inicia el servidor
npm run dev # Modo desarrollo con watch
npm run release:check # Valida build y paquete NPM
npm run release:version:patch # Sube versión patch y sincroniza lockfile
npm run release:version:minor # Sube versión minor y sincroniza lockfile
npm run release:version:major # Sube versión major y sincroniza lockfile
npm run release:publish # Publica en NPMFlujo de Release
Para futuras funcionalidades, el flujo recomendado quedó documentado en RELEASE_WORKFLOW.md.
Licencia
MIT
Autor
Soulberto Lorenzo - @slorenzot
Versión
2.7.3 - 39 herramientas disponibles para Azure DevOps (Work Items, Repositorios Git, Pull Requests, sprints, áreas, comentarios con menciones, adjuntos, vínculos entre Work Items y búsqueda de identidades)
Available Tools
36 toolsado_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
Scored across 36 tools
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.
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.
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.
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
Related MCP Connectors
The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.
Devopness MCP server for DevOps happiness! Empower AI Agents to deploy apps and infra, to any cloud.
MCP server for building and testing AI agents with multi-model experimentation and insights.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP server that enables AI assistants to manage Azure DevOps resources including Work Items, Git repositories, pipelines, and user identities.20 npmMIT
- AlicenseAqualityDmaintenanceAn MCP server for Azure DevOps work item management that enables AI assistants to create, query, update, and manage work items, sprints, and more.129 npmISC
- AlicenseNot gradedqualityDmaintenanceMCP server for Azure DevOps Server 2022 (on-premises) that enables AI assistants to interact with work items, repositories, builds, and sprints through 29 tools.33 npmMIT
- AlicenseNot gradedqualityDmaintenanceA focused MCP server for Azure DevOps work item administration, enabling AI agents to create, update, query, and manage work items with full CRUD operations and advanced WIQL querying.MIT