Handledning: Kom igång med Microsoft Dev Box MCP Server

Den här självstudien visar hur du använder MCP-servern (Microsoft Dev Box Model Context Protocol) för att hantera dina utvecklingsrutor via AI-agenter. Du lär dig att utföra vanliga dev box-åtgärder med hjälp av kommandon för naturligt språk i stället för att navigera genom flera gränssnitt.

I den här självstudien ska du:

  • Ansluta till dina Dev Box-resurser via en AI-agent
  • Lista och utforska dina tillgängliga projekt och utvecklingsrutor
  • Utföra grundläggande dev box-åtgärder med hjälp av konversationskommandon
  • Kontrollera att åtgärderna har slutförts

Förutsättningar

Kontrollera att du har följande innan du påbörjar den här självstudien:

Krav Detaljer
Dev Box MCP-server installerad Följ installationsstegen på Dev Box MCP Server-lagringsplatsen
Dev Box-resurser – Minst ett Dev Box-projekt med en konfigurerad pool
– Befintliga dev-rutor att hantera (valfritt men rekommenderas)
autentisering Inloggad via Azure CLI, Visual Studio Code eller Windows SSO
Behörigheter som krävs Dev Box-användarroll eller högre på dina Dev Box-resurser

Steg 1: Öppna AI-agenten och testa anslutningen

Börja med att öppna DIN AI-agent och testa anslutningen till dina Dev Box-resurser.

  1. Öppna GitHub Copilot Chat i din IDE (VS Code eller Visual Studio)

  2. Testa MCP Server-anslutningen genom att ange följande fråga:

    List my Dev Box projects
    
  3. Kontrollera svaret: Du bör se en lista över projekt som du har åtkomst till. Om du får ett fel kontrollerar du att du är autentiserad via Azure CLI (az login) eller Windows SSO.

Förväntade utdata: En lista som visar projektnamn, beskrivningar och resursgrupper.

Steg 2: Utforska din Dev Box-miljö

Nu när du har bekräftat anslutningen kan du utforska dina Dev Box-resurser för att förstå din miljö.

Visa dina utvecklingsrutor i alla projekt:

Show me all my dev boxes

Få information om ett specifikt projekt (ersätt "YourProjectName" med ett faktiskt projektnamn):

Show me details about the YourProjectName project

Visa en lista över tillgängliga dev box-pooler i ett projekt:

What dev box pools are available in the YourProjectName project?

Förväntade utdata: Information om dina utvecklingsrutor, inklusive deras namn, status (Körs, Stoppad osv.), projekt och poolkonfigurationer.

Steg 3: Utföra grundläggande dev box-åtgärder

Öva på vanliga dev box-hanteringsuppgifter med hjälp av kommandon för naturligt språk.

Markera utvecklingsrutans status

Markera status för en specifik utvecklingsruta:

What's the status of my DevBoxName dev box?

Få detaljerad information om en utvecklingsmiljö:

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

Starta eller stoppa en utvecklingsruta

Starta en stoppad utvecklingsmiljö:

Start my DevBoxName dev box

Stoppa en körande utvecklingsmiljö:

Stop my DevBoxName dev box

Anmärkning

Att starta och stoppa dev-boxar är långa åtgärder som kan ta flera minuter att slutföra.

Arbeta med scheman

Kontrollera avstängningsscheman:

When is my DevBoxName dev box scheduled to shut down?

Fördröj en schemalagd avstängning:

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

Steg 4: Verifiera ditt arbete

Kontrollera att dina åtgärder har slutförts genom att kontrollera resultatet.

Kontrollera åtgärdsstatus för långvariga uppgifter:

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

Verifiera ändringar i utvecklingsrutans tillstånd:

Show me the current status of DevBoxName

Bekräfta schemaändringar:

Show me the updated schedule for DevBoxName

Vad du ska leta efter:

  • Åtgärder bör visa statusen "Lyckades" när den har slutförts
  • Dev box-energitillstånd bör återspegla dina start-/stoppkommandon
  • Schemaändringar bör visas i schemainformationen

Steg 5: Prova avancerade scenarier (valfritt)

När du är bekväm med grundläggande åtgärder kan du prova följande mer avancerade scenarier:

Skapa en ny utvecklingsruta

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

Tillämpa anpassningar

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

Övervaka anpassningsstatus

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

Felsökning

Om du stöter på problem under den här självstudien:

Autentiseringsproblem

  • Kontrollera att du är inloggad: az account show
  • Kontrollera dina behörigheter i Azure-portalen
  • Prova att logga ut och gå tillbaka in: az logout sedan az login

Fel vid verktygsregistrering

  1. Tryck Ctrl+Shift+P på (VS Code) eller Ctrl+Shift+P (Visual Studio)
  2. Kör MCP: Återställ cachelagrade verktyg
  3. Starta om din IDE

Åtgärdsfel

  • Kontrollera att dev box-namn och projektnamn är korrekta
  • Kontrollera att du har rätt behörigheter för åtgärden
  • Vissa åtgärder kan ta tid – kontrollera åtgärdsstatus med jämna mellanrum

Rensa resurser (valfritt)

Om du skapade testresurser under den här handledningen:

Ta bort test dev-rutor som du inte längre behöver:

Delete the FeatureWork dev box from DevelopmentProject

Sluta köra dev-rutor för att spara kostnader:

Stop all my running dev boxes

Nästa steg

Nu när du har slutfört självstudien kan du:

  • Utforska alla åtgärder som stöds
  • Integrera Dev Box MCP Server-kommandon i ditt dagliga arbetsflöde för utveckling
  • Dela kommandon på naturligt språk med ditt team för vanliga åtgärder