Configuración del servidor MCP de Azure DevOps remoto

servicios de Azure DevOps

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.

Elección de remote first

Use el servidor MCP remoto cuando el entorno lo admita. El servidor remoto es la opción recomendada porque Azure DevOps hosts y los actualiza, y no es necesario instalar Node.js ni administrar un proceso de servidor local.

Use el servidor MCP local cuando el cliente no pueda autenticarse en el servidor remoto con Microsoft Entra ID. Esta limitación se aplica actualmente a clientes como Claude Desktop, Claude Code, Cursor y Codex. Para obtener instrucciones de configuración local, consulte Habilitación de la asistencia de IA con el servidor MCP de Azure DevOps.

Feature Servidor MCP remoto Servidor MCP local
Instalación No se necesita instalación Requiere Node.js 20.0+ y npx
Transporte HTTP en transmisión stdio
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

Prerrequisitos

Categoría Requisitos
Azure DevOps Una organización de Azure DevOps activa respaldada por un inquilino de Microsoft Entra. Las organizaciones independientes de cuenta Microsoft (MSA) no son compatibles con el uso remoto del servidor MCP.
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 excepto los conjuntos de herramientas que requieren participación explícita, como elm
repos Herramientas de repositorios y solicitudes de extracción
advsec Herramientas de alertas de Advanced Security
wit Herramientas de elementos de trabajo y search_workitem
pipelines Herramientas de canalización y compilación
wiki Herramientas de wiki y search_wiki
work Herramientas de iteración y capacidad
testplan Herramientas de plan de prueba
elm Herramientas de migración en vivo empresarial (versión preliminar privada; participación explícita)

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.

Especifique los nombres de herramientas que aparecen en la lista de herramientas disponibles . Para herramientas consolidadas como wit_work_item, elija la operación mediante el parámetro de action la herramienta al llamarla.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "core_list_projects, wit_work_item"
      }
    }
  },
  "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 a menos que se indique lo contrario.

Herramienta Descripción
core_list_orgs Enumerar las organizaciones de Azure DevOps a las que el usuario autenticado tiene acceso
core_list_projects Enumeración de proyectos en una organización
core_list_project_teams Enumeración de equipos en un proyecto
core_list_group_members Enumeración de miembros directos y grupos secundarios de un grupo de Azure DevOps

Nota:

Solo los usuarios de MCP Insider pueden usar core_list_group_members mediante el X-MCP-Insiders encabezado .

Trabajo

Las herramientas de la tarea se consolidan en despachadores agrupados mediante un parámetro action.

Herramienta Action Descripción Solo lectura
work list_iterations Enumerar todas las iteraciones de un proyecto ✅
work list_team_iterations Enumeración de iteraciones asignadas a un equipo ✅
work get_team_settings Obtener la configuración del equipo, incluida la iteración predeterminada, la iteración del trabajo pendiente y la ruta de acceso de área predeterminada ✅
work get_team_capacity Obtener capacidad de equipo para una iteración ✅
work get_iteration_capacities Obtener la capacidad de una iteración para todos los equipos de la iteración y el proyecto ✅
work_iteration_write create Creación de iteraciones ❌
work_iteration_write assign Asignación de iteraciones a un equipo ❌
work_capacity_write update Actualizar la capacidad del equipo de un miembro del equipo para una iteración específica ❌

Repos

Las herramientas del repositorio se consolidan en despachadores agrupados mediante el parámetro action.

Herramienta Action Descripción Solo lectura
repo_pull_request get Obtener 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 get_changes Obtención de cambios de archivo y diferencias opcionales de línea a línea para una iteración de solicitud de incorporación de cambios ✅
repo_pull_request_thread list Enumerar hilos de comentarios en una solicitud de incorporación de cambios ✅
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 en las que el usuario ha incorporado cambios ✅
repo_file get_content Obtener el contenido textual 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 Confirmaciones de búsqueda con filtrado por texto, autor, intervalo de fechas y mucho más ✅
search_code Búsqueda de código de texto completo ✅
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.

Herramienta Action 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 ID ✅
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_query search Buscar consultas por nombre ✅
wit_query list Enumerar carpetas de consulta raíz y sus elementos secundarios ✅
wit_query_by_wiql Ejecución de una consulta WIQL y devolución de elementos de trabajo coincidentes ✅
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 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 principal ❌
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 Adición de un repositorio, rama, confirmación, compilación o vínculo de artefacto wiki a un elemento de trabajo ❌
wit_work_item_attachment Descargar datos adjuntos de un elemento de trabajo por identificador; devuelve contenido codificado en base64 con nombre de archivo y tipo MIME ✅

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 canalización se consolidan en despachadores agrupados mediante un parámetro action.

Herramienta Action Descripción Solo lectura
pipelines_build list Listar compilaciones con filtros opcionales ✅
pipelines_build get_status Obtener el estado, los problemas y los metadatos del informe de una compilación ✅
pipelines_build get_changes Obtener las confirmaciones y los 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 Obtener una única ejecución de canalización ✅
pipelines_run list Enumerar las ejecuciones de una canalización ✅
pipelines_artifact list Enumerar artefactos para una construcción ✅
pipelines_artifact download Descargar un artefacto de compilación con nombre ✅
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 Action 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

Las herramientas del plan de pruebas se consolidan en despachadores agrupados mediante un parámetro action.

Herramienta Action Descripción Solo lectura
testplan list_plans Enumeración de planes de prueba en un proyecto ✅
testplan list_suites Enumeración de conjuntos de pruebas en un plan de prueba ✅
testplan list_cases Enumerar casos de prueba en un conjunto de pruebas ✅
testplan_show_test_results_from_build_id Obtener resultados de pruebas de una compilación ✅
testplan_test_run get_results Obtención de resultados para una ejecución de prueba con filtros de detalles y resultados opcionales ✅
testplan_test_plan_write create Creación de un plan de pruebas ❌
testplan_test_suite_write create Creación de un conjunto de pruebas ❌
testplan_test_suite_write add_test_cases Adición de casos de prueba a un conjunto de aplicaciones ❌
testplan_test_case_write create Creación de un caso de prueba ❌
testplan_test_case_write update_steps Actualización de los pasos del caso de prueba ❌
testplan_test_run_write create_run Creación de una ejecución de pruebas para la ejecución manual de pruebas ❌
testplan_test_run_write update_results Actualizar los resultados y los detalles de los resultados de la prueba en una ejecución ❌
testplan_test_run_write complete_run Completar o anular una ejecución de prueba en función de sus resultados ❌
testplan_test_run_write update_test_point_outcome Actualización o restablecimiento de resultados para puntos de prueba ❌

Seguridad avanzada

Las herramientas de Advanced Security se consolidan en un distribuidor agrupado que usa un action parámetro .

Herramienta Action Descripción Solo lectura
advsec_alerts list Enumeración de alertas de Advanced Security para un repositorio con filtros opcionales ✅
advsec_alerts get Obtención de una alerta de Advanced Security por identificador ✅

Migración en vivo empresarial (versión preliminar)

Las herramientas enterprise Live Migration usan un action parámetro para agrupar y enviar tareas. Obtenga más información sobre la versión preliminar de Enterprise Live Migration.

Importante

La compatibilidad con ELM en el servidor MCP de Azure DevOps remoto está actualmente en versión preliminar. Estas herramientas requieren que su organización tenga acceso a la versión preliminar pública limitada de ELM. Si necesita acceso, consulte la introducción a Enterprise Live Migrations para obtener más información.

Herramienta Action Descripción Solo lectura
enterprise_live_migration list Listar migraciones para la organización; con filtro de proyecto opcional y el indicador includeAllMigrations ✅
enterprise_live_migration get Obtención del estado de migración de un repositorio ✅
enterprise_live_migration get_cutover_review Obtener elementos con errores o bloqueados antes del cambio definitivo ✅
enterprise_live_migration get_device_flow_config Obtener la configuración del flujo del dispositivo de la aplicación de GitHub ✅
enterprise_live_migration list_pipelines Lista de canalizaciones y estado de recableado ✅
enterprise_live_migration_write create Crear una nueva migración ❌
enterprise_live_migration_write pause Pausar una migración activa ❌
enterprise_live_migration_write resume Reanudación de una migración en pausa ❌
enterprise_live_migration_write cutover_set Programar una fecha de transición ❌
enterprise_live_migration_write cutover_cancel Cancelación de una transición programada ❌
enterprise_live_migration_write approve_cutover Aceptar errores y continuar con la transición ❌
enterprise_live_migration_write abandon Eliminar permanentemente una migración ❌
enterprise_live_migration_pipelines_write submit Enviar canalizaciones para recableado ❌
enterprise_live_migration_pipelines_write update Actualizar la configuración de recableado de la canalización ❌
enterprise_live_migration_pipelines_write delete Eliminar todos los clones de la canalización para una migración de terminal ❌

Las herramientas de migración en vivo empresarial están deshabilitadas de forma predeterminada. Dado que la compatibilidad con ELM en el servidor MCP remoto está en versión preliminar, requieren que su organización tenga acceso a la versión preliminar pública limitada de ELM. Para habilitar las herramientas de ELM, use el X-MCP-Toolsets encabezado con el elm valor :

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

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 de MCP admiten Microsoft Entra autenticación de forma predeterminada. Algunos entornos requieren pasos adicionales para registrar la aplicación cliente.

Los entornos admitidos para el punto de conexión remoto, cuando Microsoft Entra autenticación está disponible, incluyen:

  • Visual Studio con GitHub Copilot
  • Visual Studio
  • Microsoft Foundry
  • Microsoft Copilot Studio
  • CLI de GitHub Copilot
  • aplicación Copilot de GitHub

Importante

Claude Desktop, Claude Code, Cursor y Codex no admiten actualmente el flujo de autenticación de Microsoft Entra requerido por el servidor MCP de Azure DevOps remoto. Use el servidor MCP local con estos clientes.

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.

Usa IA para validar y solucionar problemas en la configuración remota de MCP

Las siguientes indicaciones de ejemplo para Copilot Chat te ayudan a elegir el enfoque de MCP adecuado, configurar y validar la configuración remota, mejorar las indicaciones para el uso diario y solucionar problemas cuando sea necesario. Copie y pegue estas indicaciones en Copilot Chat y reemplace los marcadores de posición por la organización, el cliente y los detalles de error reales.

tarea Mensaje de ejemplo
Elegir remoto frente a local For my environment and client tools, help me decide whether to use the remote Azure DevOps MCP Server or the local server, and explain the tradeoffs.
Creación de una configuración con privilegios mínimos Generate a remote mcp.json configuration for organization <contoso> that uses only the needed toolsets and read-only mode.
Valide la configuración mcp.json Review this remote Azure DevOps MCP server configuration and tell me whether anything is missing or incorrect for Visual Studio Code.
Comprobación de las suposiciones de autenticación Help me verify whether this remote MCP setup can authenticate with Microsoft Entra ID for organization <contoso>.
Mejora de las solicitudes de consulta para el trabajo diario Give me better prompt wording to reliably fetch fresh Azure DevOps data from remote MCP for project <project-name>, including how to avoid stale results.
Diagnóstico de la conexión rechazada I'm getting Connection Refused when connecting to https://mcp.dev.azure.com/<organization>. Give me step-by-step network, proxy, and firewall checks to fix it.
Diagnóstico de datos que faltan The remote MCP server connects, but queries return no data. Help me determine whether this is a permissions issue or missing project context.
Filtrado de encabezados de la herramienta de depuración Check my X-MCP-Toolsets and X-MCP-Tools header configuration and explain why expected tools are not appearing.

Copilot funciona con IA, por lo que es posible que se produzcan sorpresas y errores. Para obtener más información, consulte las preguntas frecuentes sobre el uso general de Copilot.

Solución de problemas

Issue 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}.
Conexión rechazada Asegúrese de que su red permite conexiones HTTPS salientes a mcp.dev.azure.com. Si está en un proxy o firewall corporativo, pida al administrador que muestre el punto de conexión y vuelva a intentarlo sin VPN para aislar los problemas de la ruta de acceso de red.
No se devuelven datos Confirme que tiene los permisos adecuados para el proyecto o los recursos que se consultan.
Las herramientas de ELM no están disponibles después de la configuración X-MCP-Toolsets: elm La compatibilidad con ELM en el servidor MCP remoto está en versión preliminar privada y no está habilitada para todas las organizaciones. La configuración X-MCP-Toolsets: elm es necesaria pero no suficiente: la organización también debe inscribirse en la versión preliminar privada de ELM. Póngase en contacto con el administrador de la organización o consulte la introducción a Enterprise Live Migrations para solicitar acceso.

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 Claude Desktop, Claude Code, Codex o Cursor?

Claude Desktop, Claude Code, Codex y Cursor requieren el registro dinámico de un identificador de cliente de OAuth en Microsoft Entra ID antes de poder usar el servidor MCP remoto. Microsoft Entra ID no admite actualmente el flujo de registro de cliente dinámico que requieren estos clientes. Use el servidor MCP local con estos clientes.

Contenido relacionado

  • Last updated on