Configuración del servidor MCP de Azure DevOps remoto (versión preliminar)

Azure DevOps Services

Importante

El servidor MCP de Azure DevOps remoto está actualmente en versión preliminar pública. Las características en versión preliminar pueden tener una funcionalidad limitada y pueden cambiar antes de la disponibilidad general.

Soporte técnico

  • Actualmente, el soporte técnico se limita a los problemas enviados a través del repositorio del servidor MCP local.
  • Para enviar una solicitud de soporte técnico, cree un problema mediante la plantilla de problema del servidor MCP remoto.

El servidor MCP remoto de Azure DevOps es una versión hospedada de la Azure DevOps servidor MCP que no requiere una instalación local. En lugar de ejecutar el servidor en su máquina, conecte su asistente de IA directamente al punto de conexión hospedado en Azure DevOps mediante el transporte HTTP de transmisión continua.

El servidor remoto proporciona las mismas funcionalidades que el servidor local, incluido el acceso a elementos de trabajo, solicitudes de incorporación de cambios, canalizaciones y mucho más, al tiempo que elimina la complejidad de la configuración local.

Servidor MCP remoto frente a local

Feature Servidor MCP remoto (versión preliminar) Servidor MCP local
Instalación No se necesita instalación Requiere Node.js 20.0+ y npx
Transporte HTTP en transmisión Estudio
Autenticación Microsoft Entra ID (OAuth) Azure DevOps PAT o Microsoft Entra ID
Hospedaje servicio alojado en Azure DevOps Se ejecuta localmente en la máquina
Configuración Mínimo mcp.json Configuración específica del entorno
Estado Versión preliminar pública Disponible con carácter general

Prerrequisitos

Categoría Requisitos
Azure DevOps Una organización activa Azure DevOps conectada a Microsoft Entra ID
Permisos Pertenencia al proyecto y acceso a los recursos que desea consultar
Medio ambiente Un entorno compatible con asistente de IA (consulte Entornos admitidos)

Configuración del archivo mcp.json

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http"
    }
  },
  "inputs": []
}

También puede omitir el nombre de la organización de la dirección URL. Sin embargo, si omite el nombre de la organización, debe proporcionarlo como contexto en cada llamada a la herramienta.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/",
      "type": "http"
    }
  },
  "inputs": []
}

Conjuntos de herramientas

Especifique conjuntos de herramientas para restringir las herramientas disponibles para el servidor MCP. No se debe combinar con X-MCP-Tools.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Toolsets": "repos,wiki,wit"
      }
    }
  },
  "inputs": []
}
Valor del conjunto de herramientas Herramientas incluidas
all (valor predeterminado) Todas las herramientas de cada conjunto de herramientas
repos Herramientas de repositorio y solicitud de incorporación de cambios (repo_*)
wit Herramientas de elementos de trabajo (wit_*) y search_workitem
pipelines Herramientas de canalización y compilación (pipelines_*)
wiki Herramientas wiki (wiki, wiki_upsert_page) y search_wiki
work Herramientas de iteración y capacidad (work_*)
testplan Herramientas para el plan de prueba (testplan_*)

Herramientas de solo lectura

Use el X-MCP-Readonly encabezado para restringir el servidor a operaciones de solo lectura. Esta restricción es útil cuando desea evitar modificaciones en Azure DevOps recursos.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Readonly": "true"
      }
    }
  },
  "inputs": []
}

Combinar conjuntos de herramientas y filtrado de solo lectura

{
  "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": []
}

Herramientas individuales

Use el X-MCP-Tools encabezado para habilitar solo herramientas específicas. No se debe combinar con X-MCP-Toolsets.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "core_list_projects, wit_my_work_items, wit_get_work_items_batch_by_ids"
      }
    }
  },
  "inputs": []
}

Participantes

A medida que experimentamos e presentamos nuevas herramientas y actualizaciones para las existentes, puede obtener acceso anticipado a estos cambios mediante el X-MCP-Insiders encabezado .

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Insiders": "true"
      }
    }
  },
  "inputs": []
}

Herramientas disponibles

Nota:

Es posible que esta lista no siempre refleje las actualizaciones de herramientas más recientes.

Herramientas principales

Las herramientas principales siempre están disponibles.

Herramienta Descripción
core_list_projects Enumeración de proyectos en una organización
core_list_project_teams Enumeración de equipos en un proyecto

Trabajo

Herramienta Descripción Solo lectura
work_list_team_iterations Enumera las iteraciones de un equipo. ✅
work_list_iterations Enumere todas las iteraciones de un proyecto. ✅
work_get_team_capacity Obtenga capacidad de equipo para una iteración. ✅
work_create_iterations Crea iteraciones. ❌
work_assign_iterations Asigne iteraciones a un equipo. ❌

Repos

Las herramientas del repositorio se consolidan en distribuidores agrupados mediante un parámetro action, siguiendo el mismo patrón que las herramientas de wiki. Los nombres de herramientas individuales anteriores siguen funcionando como alias. Use repo_create_branch y repo_search_commits directamente: no se consolidaron.

Herramienta Acción Descripción Solo lectura
repo_pull_request get Obtención de una solicitud de incorporación de cambios por identificador ✅
repo_pull_request list Listar pull requests en un repositorio o proyecto ✅
repo_pull_request list_by_commits Encuentra pull requests que contienen ID de commit específicos ✅
repo_pull_request_thread list Enumerar hilos de comentarios en una solicitud de extracción ✅
repo_pull_request_thread list_comments Listar comentarios en un hilo específico ✅
repo_repository get Obtención de un repositorio por nombre o identificador ✅
repo_repository list Enumeración de repositorios en un proyecto ✅
repo_branch get Obtener una rama por nombre ✅
repo_branch list Enumerar ramas en un repositorio ✅
repo_branch list_mine Enumerar las ramas a las que el usuario actual ha empujado. ✅
repo_file get_content Obtener el contenido de texto de un archivo en una rama, etiqueta o confirmación específica ✅
repo_file list_directory Enumerar archivos y carpetas en un directorio, con una lista recursiva opcional ✅
repo_search_commits N/A Confirmaciones de búsqueda con filtrado por texto, autor, intervalo de fechas y mucho más ✅
repo_pull_request_write create Crea una solicitud de incorporación de cambios ❌
repo_pull_request_write update Actualizar un pull request, incluida la configuración de autocompletar ❌
repo_pull_request_write update_reviewers Agregar o quitar revisores de solicitudes de incorporación de cambios ❌
repo_pull_request_write vote Emitir un voto en una solicitud de incorporación de cambios ❌
repo_pull_request_thread_write create Crea un nuevo hilo de comentarios en un pull request ❌
repo_pull_request_thread_write reply Responder a un comentario en un hilo ❌
repo_pull_request_thread_write update_status Actualizar el estado de un hilo de comentarios ❌
repo_create_branch Creación de una rama ❌

Wit

Las herramientas de elementos de trabajo se consolidan en despachadores agrupados mediante un parámetro action, siguiendo el mismo patrón que las herramientas de repositorio y canalización. Los nombres de herramientas individuales anteriores siguen funcionando como alias. Utiliza search_workitem directamente: no se consolidó.

Herramienta Acción Descripción Solo lectura
wit_work_item get Obtener un elemento de trabajo por identificador ✅
wit_work_item get_batch Obtener varios elementos de trabajo por IDs ✅
wit_work_item list_comments Enumerar comentarios en un elemento de trabajo ✅
wit_work_item my Obtención de elementos de trabajo relevantes para el usuario autenticado ✅
wit_work_item list_revisions Enumerar las revisiones de un elemento de trabajo ✅
wit_work_item list_for_iteration Enumeración de elementos de trabajo para una iteración de equipo ✅
wit_work_item get_type Obtener metadatos para un tipo de elemento de trabajo ✅
wit_query get Obtener una consulta por identificador o ruta de acceso ✅
wit_query get_results Ejecución de una consulta guardada ✅
wit_backlog list Enumerar los niveles de trabajo pendiente de un equipo ✅
wit_backlog list_work_items Enumeración de elementos de trabajo en un nivel de trabajo pendiente específico ✅
search_workitem N/A Búsqueda en texto completo de elementos de trabajo ✅
wit_work_item_write create Crear un nuevo elemento de trabajo ❌
wit_work_item_write update Actualizar campos en un elemento de trabajo ❌
wit_work_item_write update_batch Actualizar varios elementos de trabajo en una llamada ❌
wit_work_item_write add_child Crear elementos de trabajo secundarios bajo un elemento primario ❌
wit_work_item_comment_write add Agregar un comentario a un elemento de trabajo ❌
wit_work_item_comment_write update Actualizar un comentario existente en un elemento de trabajo ❌
wit_work_item_link_write link Vincular dos elementos de trabajo ❌
wit_work_item_link_write unlink Quitar vínculos de un elemento de trabajo ❌
wit_work_item_link_write link_to_pull_request Vincula un elemento de trabajo a un pull request ❌
wit_work_item_link_write add_artifact_link Añadir un enlace de repositorio, rama, commit o artefacto de compilación a un elemento de trabajo ❌

Nota:

wit_query_by_wiql actualmente solo está disponible para los usuarios de MCP Insiders usando el encabezado X-MCP-Insiders.

Tuberías

Las herramientas de pipeline se consolidan en encaminadores agrupados mediante un action parámetro, siguiendo el mismo patrón que las herramientas de wiki y repositorio. Los nombres de herramientas individuales anteriores siguen funcionando como alias.

Herramienta Acción Descripción Solo lectura
pipelines_build list Listar compilaciones con filtros opcionales ✅
pipelines_build get_status Obtener el estado, los problemas y los metadatos de informe de una compilación ✅
pipelines_build get_changes Obtención de confirmaciones y elementos de trabajo asociados a una compilación ✅
pipelines_build_log list Lista de registros disponibles para una compilación ✅
pipelines_build_log get_content Obtener el contenido de texto de un registro específico por identificador ✅
pipelines_definition list Lista de definiciones de pipeline con filtros opcionales ✅
pipelines_definition list_revisions Enumerar el historial de revisiones de una definición de canalización ✅
pipelines_run get Obtención de una sola ejecución de canalización ✅
pipelines_run list Enumeración de ejecuciones de una canalización ✅
pipelines_artifact list Enumerar artefactos para una construcción ✅
pipelines_artifact download Descarga un artefacto de compilación denominado ✅
pipelines_write run_pipeline Poner en cola una nueva ejecución de canalización ❌
pipelines_write create_pipeline Creación de una nueva definición de canalización de YAML ❌
pipelines_write update_build_stage Cancelar, reintentar o ejecutar una etapa en una compilación que está en proceso ❌

Wiki

Las operaciones de lectura de wiki se consolidan en una única herramienta wiki. Use el action parámetro para seleccionar la operación.

Herramienta Acción Descripción Solo lectura
wiki list_wikis Enumerar wikis en un proyecto u organización ✅
wiki get_wiki Obtener una wiki por identificador ✅
wiki list_pages Enumerar páginas en una wiki ✅
wiki get_page Obtener contenido y metadatos de la página ✅
search_wiki Búsqueda wiki de texto completo ✅
wiki_upsert_page Crear o actualizar una página wiki ❌

Planes de pruebas

Herramienta Descripción Solo lectura
testplan_list_test_plans Enumerar los planes de prueba en un proyecto. ✅
testplan_list_test_suites Enumerar conjuntos de pruebas en un plan de prueba. ✅
testplan_list_test_cases Enumere casos de prueba en un conjunto. ✅
testplan_show_test_results_from_build_id Obtenga resultados de pruebas de una compilación. ✅
testplan_create_test_plan Cree un plan de prueba. ❌
testplan_create_test_suite Cree un conjunto de pruebas. ❌
testplan_create_test_case Cree un caso de prueba. ❌
testplan_update_test_case_steps Actualice los pasos del caso de prueba. ❌
testplan_add_test_cases_to_suite Agregue casos de prueba a un conjunto de aplicaciones. ❌
Herramienta Descripción Solo lectura
search_code Búsqueda de código de texto completo. ✅
search_wiki Búsqueda wiki de texto completo. ✅
search_workitem Búsqueda de elementos de trabajo de texto completo. ✅

Entornos soportados

El servidor MCP remoto de Azure DevOps requiere tu cuenta de usuario y tu organización de Azure DevOps para conectarse a Microsoft Entra ID.

No todos los clientes MCP admiten la autenticación Entra de forma predeterminada. Algunos entornos requieren pasos adicionales para registrar la aplicación cliente.

Los entornos admitidos actualmente incluyen:

  • Visual Studio Code
  • Visual Studio

Visual Studio Code

Para configurar el servidor MCP remoto en Visual Studio Code:

  1. Agregue un .vscode/mcp.json archivo al repositorio con la configuración de mcp.json mostrada anteriormente.
  2. Guarde el archivo.
  3. Abra GitHub Copilot en VS Code.
  4. Cuando se le solicite, autentíquese con su cuenta de Microsoft Entra y seleccione su cuenta.

Una vez completada la autenticación, aparece una lista de herramientas disponibles.

Visual Studio (2022 y versiones posteriores)

Configure el servidor MCP remoto en Visual Studio agregando la dirección URL del servidor a la configuración de MCP. Para obtener más información, consulte Use los servidores MCP en Visual Studio.

Comprobación de la conexión

Después de la instalación, compruebe que el servidor MCP remoto funciona haciendo una pregunta al asistente de INTELIGENCIA ARTIFICIAL sobre los datos de Azure DevOps.

Ejemplos:

  • "Enumere los proyectos de mi organización Azure DevOps."
  • "Mostrar mis elementos de trabajo asignados."
  • "¿Qué solicitudes de incorporación de cambios requieren mi revisión?"

Si el asistente de IA devuelve resultados de la organización de Azure DevOps, el servidor MCP remoto se configura correctamente.

Solución de problemas

Cuestión Resolution
Error de autenticación Compruebe las credenciales de Microsoft Entra y confirme que tiene acceso a la organización de Azure DevOps.
No se encontró el servidor Compruebe el formato de dirección URL del servidor: https://mcp.dev.azure.com/{organization}.
No se devuelven datos Confirme que tiene los permisos adecuados para el proyecto o los recursos que se consultan.
Vista previa no disponible La versión preliminar se está implementando gradualmente. Vuelva a comprobar más adelante o póngase en contacto con el administrador de la organización.

Para obtener soporte técnico, puede crear un problema en el repositorio del servidor MCP local . Asegúrese de utilizar la plantilla de problema Remoto.

Preguntas más frecuentes

¿Qué ocurre con otros clientes como GitHub Copilot CLI, Claude Desktop, Claude Code, CodeX o Cursor?

Las herramientas de cliente adicionales, como CodeX, Claude Desktop, Claude Code y ChatGPT requieren el registro dinámico de un identificador de cliente de OAuth en Entra antes de que se puedan usar con el servidor MCP. Estamos trabajando estrechamente con el equipo de Entra para habilitar esta funcionalidad. Por ahora, solo se admiten Visual Studio y Visual Studio Code.

¿Qué servicios pueden usar Azure DevOps servidor MCP?

La compatibilidad con otros servicios, como Fundición de IA de Azure, Microsoft 365 Copilot y Copilot Studio, aún no está disponible, pero pronto se agregará.

¿Admite el servidor MCP de Azure DevOps AgentId?

La compatibilidad con AgentId estará disponible próximamente.

Contenido relacionado

  • Last updated on