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

Azure DevOps Services

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

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.

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

Insiders

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.

Trabajo

Repos

Seguimiento de elementos de trabajo

Tuberías

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

Search

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

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?

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 Azure AI Foundry, 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

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