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.

Elige el trabajo remoto como prioridad

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 y Codex. Cursor y Claude Code requieren un registro de aplicación de Microsoft Entra personalizado para autenticarse. Para obtener instrucciones de configuración local, consulte Habilitación de la asistencia de IA con el servidor MCP de Azure DevOps.

Prerrequisitos

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

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 action de 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

Herramientas principales

Las herramientas principales siempre están disponibles a menos que se indique lo contrario.

Trabajo

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

Repos

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

Wit

Las herramientas de elementos de trabajo se consolidan en despachadores agrupados mediante un parámetro action.

Tuberías

Las herramientas de canalización se consolidan en despachadores agrupados mediante un parámetro action.

Wiki

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

Planes de pruebas

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

Seguridad avanzada

Las herramientas de seguridad avanzada se consolidan en un despachador agrupado que usa un parámetro action.

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.

Para que solo estén disponibles las herramientas de Enterprise Live Migration, use el encabezado 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 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
• Cursor desktop, Cursor Cloud Agents o Claude Code con un registro de aplicación de Microsoft Entra personalizado

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.

Elegir ámbitos de OAuth para clientes personalizados

Al registrar un cliente MCP personalizado, conceda solo los permisos delegados necesarios para las operaciones de Azure DevOps que realiza el cliente. Los ámbitos de OAuth determinan a qué recursos y operaciones Azure DevOps puede acceder el cliente. La habilitación de una herramienta o un conjunto de herramientas de MCP no concede permisos adicionales.

Siga el principio de privilegios mínimos:

• Otorgue permisos de lectura cuando el cliente use solo herramientas MCP de solo lectura.
• Otorgue permisos de escritura o de administración solo cuando el cliente necesite las operaciones de escritura correspondientes.
• Revise los ámbitos heredados para evitar conceder permisos redundantes.

Para conocer los ámbitos disponibles y sus relaciones, consulte Ámbitos de OAuth.

Los ámbitos de OAuth no invalidan los permisos del usuario que ha iniciado sesión. Una operación MCP solo se realiza correctamente cuando tanto el ámbito de la aplicación como los permisos de Azure DevOps del usuario lo permiten.

Cursor

Cursor requiere un registro de aplicaciones personalizado en Microsoft Entra para acceder al servidor MCP remoto de Azure DevOps.

Registra la aplicación para Cursor Desktop

1. Confirme que la aplicación empresarial Azure DevOps MCP se ha aprovisionado en su tenant. Si no lo encuentra, consulte No puede encontrar la aplicación empresarial de Azure DevOps MCP en el tenant.
2. En el Centro de administración Microsoft Entra, vaya a Registros de aplicaciones y, a continuación, cree un registro de aplicación.
3. En el registro de la aplicación, seleccione Autenticación (Vista previa)>Agregar URI de redirección>Aplicaciones móviles y de escritorio.
4. Escriba http://localhost:8787/callback como el URI de redirección y guarde los cambios.
5. En la página Autenticación (versión preliminar), seleccione la pestaña Configuración y, a continuación, habilite Permitir flujos de cliente públicos.
6. En la página Permisos de API, seleccione Agregar unaAPI de permisos > queusa mi organización.
7. Busque Azure DevOps MCP o el identificador 2a72489c-aab2-4b65-b93a-a91edccf33b8de aplicación y, a continuación, seleccione la aplicación.
8. Seleccione los permisos delegados que requiere el cliente, siguiendo las instrucciones de ámbito de OAuth y, a continuación, seleccione Agregar permisos.
9. Seleccione Conceder consentimiento de administrador. Según el rol, es posible que un administrador de inquilinos tenga que completar este paso.

Copie el identificador de aplicación (cliente) del registro de la aplicación. Necesitas este valor para configurar Cursor.

Configurar Cursor Desktop

1. En Cursor, abra Herramientas de configuración>y MCP.

2. Seleccione Nuevo servidor MCP.

3. Agregue la siguiente configuración y reemplace {client-id} por el identificador de aplicación (cliente) que copió:

   {
     "mcpServers": {
       "ado": {
         "url": "https://mcp.dev.azure.com",
         "type": "http",
         "auth": {
           "CLIENT_ID": "{client-id}"
         }
       }
     }
   }
   

4. Guarde la configuración y, a continuación, vuelva a Herramientas de configuración>y MCP.

5. Busque el servidor ado y, a continuación, seleccione Autenticar.

Configuración de agentes de cursor en la nube

Los agentes de Cursor Cloud requieren un URI de redirección web y un secreto de cliente, además del registro de aplicación personalizado de Microsoft Entra.

1. En el Centro de administración Microsoft Entra, abra el registro de la aplicación que creó para Cursor.

2. Seleccione Autenticación (versión preliminar)>Agregar URI de redirección>Web.

3. Escriba https://www.cursor.com/agents/mcp/oauth/callback como el URI de redirección y guarde los cambios.

4. Seleccione Certificados y secretos>Secretos de cliente>Nuevo secreto de cliente.

5. Escriba una descripción, seleccione un período de expiración y, a continuación, seleccione Agregar.

6. Copie el valor del secreto de cliente. El valor solo aparece una vez.

7. En Cursor, abra la configuración del servidor MCP de Cloud Agents y agregue o edite el servidor MCP personalizado.

8. Establezca la dirección URL del servidor en https://mcp.dev.azure.com.

9. Introduzca el identificador de la aplicación (cliente) del registro de la aplicación en Id. de cliente y el valor del secreto de cliente en Secreto de cliente.

   Como alternativa, edite la configuración json y reemplace los marcadores de posición por los valores de registro de la aplicación:

   {
     "mcpServers": {
       "ado": {
         "url": "https://mcp.dev.azure.com",
         "type": "http",
         "auth": {
           "CLIENT_ID": "{client-id}",
           "CLIENT_SECRET": "{client-secret}"
         }
       }
     }
   }
   

10. Guarde la configuración y, a continuación, seleccione Iniciar sesión enCursor Cloud Agents para completar la autenticación Microsoft Entra.

Si Microsoft Entra devuelve el error AADSTS50011, compruebe que el URI de redirección web coincide exactamente con https://www.cursor.com/agents/mcp/oauth/callback. Si se produce un error AADSTS7000218en el intercambio de tokens, compruebe que el valor del secreto de cliente actual está configurado en Cursor Cloud Agents.

Claude Code

Claude Code requiere un registro de aplicación de Microsoft Entra personalizado para acceder al servidor MCP de Azure DevOps remoto.

Registrar la aplicación

1. Confirme que la aplicación empresarial Azure DevOps MCP se ha aprovisionado en su tenant. Si no lo encuentra, consulte No puede encontrar la aplicación empresarial de Azure DevOps MCP en el tenant.
2. En el Centro de administración Microsoft Entra, vaya a Registros de aplicaciones y, a continuación, cree un registro de aplicación.
3. En el registro de la aplicación, seleccione Autenticación (Vista previa)>Agregar URI de redirección>Aplicaciones móviles y de escritorio.
4. Escriba http://localhost:3118/callback como el URI de redirección y guarde los cambios.
5. En la página Autenticación (versión preliminar), seleccione la pestaña Configuración y, a continuación, habilite Permitir flujos de cliente públicos.
6. En la página Permisos de API, seleccione Agregar unaAPI de permisos > queusa mi organización.
7. Busque Azure DevOps MCP o el identificador 2a72489c-aab2-4b65-b93a-a91edccf33b8de aplicación y, a continuación, seleccione la aplicación.
8. Seleccione los permisos delegados que requiere el cliente, siguiendo las instrucciones de ámbito de OAuth y, a continuación, seleccione Agregar permisos.
9. Seleccione Conceder consentimiento de administrador. Según el rol, es posible que un administrador de inquilinos tenga que completar este paso.

Copie el identificador de aplicación (cliente) del registro de la aplicación. Necesita este valor para configurar Claude Code.

Configuración de Claude Code

1. Ejecute el siguiente comando y reemplace {client-id} por el identificador de aplicación (cliente) que copió y {organization} por el nombre de la organización de Azure DevOps:

   claude mcp add --transport http ado https://mcp.dev.azure.com/{organization} \
     --client-id {client-id} --callback-port 3118
   

   Como alternativa, cree un .mcp.json archivo en la raíz del repositorio con la siguiente configuración:

   {
     "mcpServers": {
       "ado": {
         "type": "http",
         "url": "https://mcp.dev.azure.com/{organization}",
         "oauth": {
           "clientId": "{client-id}",
           "callbackPort": 3118
         }
       }
     }
   }
   

2. Inicie Claude Code ejecutando claude.

3. Ejecute /mcpy, a continuación, siga el flujo de inicio de sesión del explorador para autenticarse con la cuenta de Microsoft Entra.

Para obtener más información sobre estas opciones, consulte Conexión de Claude Code a herramientas a través de MCP.

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.

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

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 o Codex?

Claude Desktop y Codex 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

• Información general del servidor MCP de Azure DevOps
• repositorio de GitHub del servidor MCP de Azure DevOps