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

servicios de Azure DevOps

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.

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 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
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 repositorios y solicitudes de extracción
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

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_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

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 Obtención de 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_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_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 Añadir un enlace a un repositorio, una rama, una confirmación o un artefacto de compilación 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 la canalización se consolidan en despachadores agrupados mediante el 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 prueba se consolidan en despachadores agrupados mediante el 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 Listar casos de prueba en una suite de pruebas ✅
testplan_show_test_results_from_build_id Obtención de resultados de pruebas de una compilación ✅
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 ❌

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.

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 del pipeline para una migración de terminal ❌

Las herramientas de migración en vivo empresarial están deshabilitadas de forma predeterminada. Para habilitarlos, utilice la cabecera X-MCP-Toolsets con el valor elm:

{
  "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 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.

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.
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 usar 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?

Otras herramientas de cliente como CodeX, Claude Desktop, Claude Code y ChatGPT requieren el registro dinámico de un identificador de cliente de OAuth en Microsoft Entra antes de poder usarlos con el servidor MCP. Estamos trabajando estrechamente con el equipo de Microsoft 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, incluidos 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