How do I use @slorenzot/mcp-azure?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@slorenzot/mcp-azure List all active bugs in the current sprint" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

@slorenzot/mcp-azure

Servidor MCP (Model Context Protocol) para Azure DevOps. Permite interactuar con Work Items, sprints, áreas, comentarios y adjuntos desde cualquier cliente MCP compatible.

Instalación

npm install -g @slorenzot/mcp-azure

O usar directamente con npx:

npx @slorenzot/mcp-azure

Configuración

Variables de Entorno

El servidor se configura automáticamente usando las siguientes variables de entorno:

Variable	Alternativa	Descripción	Requerido
`AZURE_DEVOPS_ORG`	`ADO_ORG`	URL de la organización (ej: `https://dev.azure.com/mi-org`)	Sí
`AZURE_DEVOPS_PAT`	`ADO_PAT`	Personal Access Token	Sí
`AZURE_DEVOPS_PROJECT`	`ADO_PROJECT`	Nombre del proyecto	No

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

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
- Project and Team: Read (opcional)

Herramientas Disponibles

Autenticación

Herramienta	Descripción
`ado_configure`	Configura la conexión con organización, proyecto y PAT

Work Items

Herramienta	Descripción
`ado_get_work_item`	Obtiene un Work Item por su ID
`ado_create_work_item`	Crea un nuevo Work Item (User Story, Bug, Task, etc.)
`ado_update_work_item`	Actualiza un Work Item existente
`ado_get_work_item_type_fields`	Obtiene los campos disponibles/requeridos de un tipo

Consultas

Herramienta	Descripción
`ado_query_sprint`	Consulta Work Items de un sprint específico
`ado_query_area`	Consulta Work Items de un área específica
`ado_query_wiql`	Ejecuta una consulta WIQL personalizada

Estructura del Proyecto

Herramienta	Descripción
`ado_list_iterations`	Lista las iteraciones/sprints del proyecto
`ado_list_areas`	Lista las áreas del proyecto

Comentarios y Discusiones

Herramienta	Descripción
`ado_add_comment`	Agrega un comentario a un Work Item (soporta Markdown)
`ado_get_comments`	Obtiene los comentarios de un Work Item

Adjuntos

Herramienta	Descripción
`ado_upload_attachment`	Sube un archivo y devuelve la URL del adjunto
`ado_add_attachment`	Agrega un adjunto a un Work Item
`ado_get_attachments`	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"
}

Subir y Adjuntar Archivo

{
  "workItemId": 12345,
  "filePath": "/ruta/al/archivo.pdf",
  "comment": "Documento de especificaciones"
}

Prompts Disponibles

El servidor incluye prompts predefinidos para facilitar tareas comunes:

Prompt	Descripción
`connect`	Guía para conectarse a Azure DevOps
`analyze_sprint`	Analiza el estado de un sprint
`create_user_story`	Crea una User Story estructurada
`daily_standup`	Genera un reporte de standup diario
`plan_sprint`	Ayuda a planificar un sprint
`bulk_update`	Actualiza múltiples Work Items
`project_report`	Genera un reporte del proyecto
`report_bug`	Crea un Bug report estructurado

Recursos

Recurso	URI	Descripción
Estado de conexión	`ado://connection/status`	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 build

Scripts disponibles

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

Licencia

MIT

Autor

Soulberto Lorenzo - @slorenzot

Install Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

Need Help?

Report Issue

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Tools

View all tools

@slorenzot/mcp-azure

@slorenzot/mcp-azure

Instalación

Configuración

Variables de Entorno

Configuración en Claude Desktop

Obtener un Personal Access Token (PAT)

Herramientas Disponibles

Autenticación

Work Items

Consultas

Estructura del Proyecto

Comentarios y Discusiones

Adjuntos

Ejemplos de Uso

Crear una User Story

Consulta WIQL Personalizada

Agregar Comentario con Markdown

Subir y Adjuntar Archivo

Prompts Disponibles

Recursos

Desarrollo

Requisitos

Instalación local

Scripts disponibles

Licencia

Autor

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API