Compartir a través de


Tutorial: Introducción al servidor MCP de Microsoft Dev Box

En este tutorial se muestra cómo usar microsoft Dev Box Model Context Protocol (MCP) Server para administrar los cuadros de desarrollo a través de agentes de IA. Aprenderá a realizar operaciones comunes de cuadro de desarrollo mediante comandos de lenguaje natural en lugar de navegar por varias interfaces.

En este tutorial, hará lo siguiente:

  • Conexión a los recursos de Dev Box a través de un agente de IA
  • Enumerar y explorar los proyectos y cuadros de desarrollo disponibles
  • Realizar operaciones básicas de cuadro de desarrollo mediante comandos conversacionales
  • Comprobación de que las operaciones se completaron correctamente

Prerrequisitos

Antes de comenzar este tutorial, asegúrese de que tiene:

Requirement Detalles
Dev Box MCP Server instalado Siga los pasos de instalación del repositorio del servidor MCP de Dev Box.
Recursos de Dev Box - Al menos un proyecto de Dev Box con un grupo configurado
- Entornos de desarrollo existentes para administrar (opcional, pero recomendado)
Autenticación Inicio de sesión con la CLI de Azure, Visual Studio Code o SSO de Windows
Permisos necesarios Rol de usuario de Dev Box o superior en los recursos de Dev Box

Paso 1: Apertura del agente de IA y prueba de conectividad

Comience abriendo el agente de IA y probando la conexión a los recursos de Dev Box.

  1. Abra el chat de Copilot de GitHub en el IDE (VS Code o Visual Studio)

  2. Pruebe la conexión del servidor MCP escribiendo este mensaje:

    List my Dev Box projects
    
  3. Compruebe la respuesta: debería ver una lista de proyectos a los que tiene acceso. Si recibe un error, compruebe que ha iniciado sesión mediante la CLI de Azure (az login) o el inicio de sesión único de Windows.

Salida esperada: una lista que muestra los nombres de proyecto, las descripciones y los grupos de recursos.

Paso 2: Explorar el entorno de Dev Box

Ahora que ha confirmado la conectividad, explore los recursos de Dev Box para comprender su entorno.

Vea los cuadros de desarrollo en todos los proyectos:

Show me all my dev boxes

Obtenga detalles sobre un proyecto específico (reemplace "YourProjectName" por un nombre de proyecto real):

Show me details about the YourProjectName project

Enumerar los grupos de cuadros de desarrollo disponibles en un proyecto:

What dev box pools are available in the YourProjectName project?

Salida esperada: información sobre los cuadros de desarrollo, incluidos sus nombres, estado (En ejecución, Detenido, etc.), proyectos y configuraciones de grupo.

Paso 3: Realizar operaciones básicas de entorno de desarrollo

Practique tareas comunes de administración de cuadros de desarrollo mediante comandos de lenguaje natural.

Comprobar el estado de dev box

Compruebe el estado de una caja de desarrollo específica

What's the status of my DevBoxName dev box?

Obtenga información detallada sobre una caja de desarrollo:

Show me detailed information about DevBoxName including its configuration and current state

Iniciar o detener un devbox

Inicie un dev box detenido:

Start my DevBoxName dev box

Detenga un entorno de desarrollo en ejecución:

Stop my DevBoxName dev box

Nota:

Las operaciones de inicio y detención de dev boxes son de larga duración y pueden tardar varios minutos en completarse.

Trabajar con programaciones

Compruebe las programaciones de apagado:

When is my DevBoxName dev box scheduled to shut down?

Retrasar un apagado programado:

Delay the shutdown of my DevBoxName dev box until 6 PM today

Paso 4: Comprobar el trabajo

Confirme que las operaciones se completaron correctamente comprobando los resultados.

Compruebe el estado de la operación para las tareas de ejecución prolongada:

What's the status of the operation I just started?

Verifique los cambios de estado de la caja de desarrollo:

Show me the current status of DevBoxName

Confirmar cambios de programación:

Show me the updated schedule for DevBoxName

Qué buscar:

  • Las operaciones deben mostrar "Éxito" como estado cuando se completen.
  • Los estados de energía del entorno de desarrollo deben reflejar los comandos de inicio/detener.
  • Las modificaciones de programación deben ser visibles en la información de programación.

Paso 5: Probar escenarios avanzados (opcional)

Una vez que esté familiarizado con las operaciones básicas, pruebe estos escenarios más avanzados:

Crear una nueva caja de desarrollo

Create a new dev box called "FeatureWork" in the DevelopmentProject using the StandardPool

Aplicar personalizaciones

What customization tasks are available for my project?
Install the development tools customization on my FeatureWork dev box

Supervisar el progreso de la personalización

What's the status of the customization running on my FeatureWork dev box?

Solución de problemas

Si se producen problemas durante este tutorial:

Problemas de autenticación

  • Compruebe que ha iniciado sesión: az account show
  • Comprobación de los permisos en Azure Portal
  • Pruebe a cerrar sesión y volver a iniciarla: az logoutaz login

Errores de registro de herramientas

  1. Presione Ctrl+Shift+P (VS Code) o Ctrl+Shift+P (Visual Studio)
  2. Ejecución de MCP: Restablecimiento de herramientas almacenadas en caché
  3. Reinicio del IDE

Errores de operación

  • Compruebe que los nombres de las casillas de desarrollo y los nombres de proyecto son correctos.
  • Compruebe que tiene los permisos adecuados para la operación.
  • Algunas operaciones pueden tardar tiempo: comprobar el estado de la operación periódicamente

Limpieza de recursos (opcional)

Si ha creado recursos de prueba durante este tutorial:

Elimine los cuadros de desarrollo de prueba que ya no necesite:

Delete the FeatureWork dev box from DevelopmentProject

Deje de ejecutar cuadros de desarrollo para ahorrar costos:

Stop all my running dev boxes

Pasos siguientes

Ahora que completó el tutorial, puede hacer lo siguiente:

  • Exploración de la gama completa de operaciones admitidas
  • Integración de comandos de Dev Box MCP Server en el flujo de trabajo de desarrollo diario
  • Uso compartido de comandos de lenguaje natural con el equipo para operaciones comunes