Tutorial: Introdução ao Servidor MCP do Microsoft Dev Box

Este tutorial mostra como usar o servidor MCP (Protocolo de Contexto do Modelo do Microsoft Dev Box) para gerenciar suas caixas de desenvolvimento por meio de agentes de IA. Você aprenderá a executar operações comuns de caixa de desenvolvimento usando comandos de linguagem natural em vez de navegar por várias interfaces.

Neste tutorial, você aprenderá a:

• Conectar-se aos recursos do Dev Box por meio de um agente de IA
• Listar e explorar seus projetos e caixas de desenvolvimento disponíveis
• Executar operações básicas de ambiente de desenvolvimento usando comandos conversacionais
• Verificar se suas operações foram concluídas com êxito

Pré-requisitos

Antes de começar este tutorial, verifique se você tem:

Etapa 1: Abrir o agente de IA e testar a conectividade

Comece abrindo o agente de IA e testando a conexão com os recursos do Dev Box.

1. Abra o GitHub Copilot Chat em seu IDE (VS Code ou Visual Studio)

2. Teste a conexão do SERVIDOR MCP inserindo este prompt:

   List my Dev Box projects
   

3. Verifique a resposta: você deve ver uma lista de projetos aos quais tem acesso. Se você receber um erro, verifique se você está autenticado por meio da CLI do Azure (az login) ou do SSO do Windows.

Saída esperada: uma lista mostrando os nomes, descrições e grupos de recursos do projeto.

Etapa 2: Explorar seu ambiente do Dev Box

Agora que você confirmou a conectividade, explore os recursos do Dev Box para entender seu ambiente.

Exiba suas caixas de desenvolvimento em todos os projetos:

Show me all my dev boxes

Obtenha detalhes sobre um projeto específico (substitua "YourProjectName" por um nome de projeto real):

Show me details about the YourProjectName project

Listar pools de computador de desenvolvimento em um projeto:

What dev box pools are available in the YourProjectName project?

Saída esperada: informações sobre suas caixas de desenvolvimento, incluindo seus nomes, status (Executando, Parado etc.), projetos e configurações de pool.

Etapa 3: executar operações básicas no ambiente de desenvolvimento

Pratique tarefas comuns de gerenciamento de caixa de desenvolvimento usando comandos de linguagem natural.

Verificar o status do computador de desenvolvimento

Verifique o status de uma caixa de desenvolvimento específica:

What's the status of my DevBoxName dev box?

Obtenha informações detalhadas sobre uma caixa de desenvolvimento:

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

Iniciar ou encerrar um ambiente de desenvolvimento

Inicie uma caixa de desenvolvimento parada:

Start my DevBoxName dev box

Interrompa uma ambiente de desenvolvimento em execução:

Stop my DevBoxName dev box

Trabalhar com agendas

Verifique os agendamentos de desligamento:

When is my DevBoxName dev box scheduled to shut down?

Atrasar um desligamento agendado:

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

Etapa 4: Verificar seu trabalho

Confirme se suas operações foram concluídas com êxito verificando os resultados.

Verifique o status da operação para tarefas de execução prolongada:

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

Verifique as alterações de estado da caixa de desenvolvimento:

Show me the current status of DevBoxName

Confirme as alterações de agendamento:

Show me the updated schedule for DevBoxName

O que procurar:

• As operações devem mostrar o status "Bem-sucedido" quando concluídas
• Os estados de energia da caixa de desenvolvimento devem refletir seus comandos de início/parada
• As modificações de agendamento devem estar visíveis nas informações de agendamento

Etapa 5: Experimentar cenários avançados (opcional)

Depois de se sentir confortável com operações básicas, experimente estes cenários mais avançados:

Criar uma nova caixa de desenvolvimento

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

Aplicar personalizações

What customization tasks are available for my project?

Install the development tools customization on my FeatureWork dev box

Monitorar o progresso da personalização

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

Resolução de problemas

Se você encontrar problemas durante este tutorial:

Problemas de autenticação

• Verifique se você está conectado: az account show
• Verificar suas permissões no portal do Azure
• Tente sair e entrar novamente em: az logout então az login

Erros de registro de ferramenta

1. Pressione Ctrl+Shift+P (VS Code) ou Ctrl+Shift+P (Visual Studio)
2. Executar MCP: Redefinir ferramentas armazenadas em cache
3. Reiniciar o IDE

Falhas de operação

• Verifique se os nomes das caixas de desenvolvimento e os nomes do projeto estão corretos
• Verifique se você tem permissões apropriadas para a operação
• Algumas operações podem levar tempo – verificar o status da operação periodicamente

Limpar recursos (opcional)

Se você criou recursos de teste durante este tutorial:

Exclua as caixas de desenvolvimento de teste que você não precisa mais:

Delete the FeatureWork dev box from DevelopmentProject

Pare de executar computadores de desenvolvimento para economizar custos:

Stop all my running dev boxes

Próximas etapas

Agora que você concluiu o tutorial, você pode:

• Explorar toda a gama de operações com suporte
• Integrar comandos do Servidor MCP do Dev Box ao fluxo de trabalho de desenvolvimento diário
• Compartilhar comandos de linguagem natural com sua equipe para operações comuns

Conteúdo relacionado

• O que é o Servidor MCP do Microsoft Dev Box?
• Guia de instalação do Servidor MCP do Dev Box