このチュートリアルでは、Microsoft Dev Box Model Context Protocol (MCP) サーバーを使用して、AI エージェントを使用して開発ボックスを管理する方法について説明します。 複数のインターフェイスを移動するのではなく、自然言語コマンドを使用して一般的な開発ボックス操作を実行する方法について説明します。
このチュートリアルでは、次のことについて説明します。
- AI エージェントを使用して Dev Box リソースに接続する
- 使用可能なプロジェクトと開発ボックスを一覧表示して調べる
- 会話型コマンドを使用して基本的な開発ボックス操作を実行する
- 操作が正常に完了したことを確認する
[前提条件]
このチュートリアルを開始する前に、次のことを確認してください。
| Requirement | 詳細 |
|---|---|
| Dev Box MCP サーバーがインストールされている | Dev Box MCP サーバー リポジトリのインストール手順に従います |
| Dev Box のリソース | - 構成されたプールを持つ少なくとも 1 つの Dev Box プロジェクト - 管理する既存の開発ボックス (省略可能ですが推奨) |
| 認証 | Azure CLI、Visual Studio Code、または Windows SSO を使用してサインインする |
| 必要なアクセス許可 | Dev Box リソースの Dev Box ユーザー ロール以上 |
手順 1: AI エージェントを開き、接続をテストする
まず、AI エージェントを開き、Dev Box リソースへの接続をテストします。
IDE で GitHub Copilot チャットを開く (VS Code または Visual Studio)
次のプロンプトを入力して、MCP サーバー接続をテストします。
List my Dev Box projects応答を確認します。アクセスできるプロジェクトの一覧が表示されます。 エラーが発生した場合は、Azure CLI (
az login) または Windows SSO を使用して認証されていることを確認します。
予想される出力: プロジェクト名、説明、およびリソース グループを示す一覧。
手順 2: Dev Box 環境を調べる
接続を確認したら、Dev Box リソースを調べて環境を理解します。
すべてのプロジェクトの開発ボックスを表示します。
Show me all my dev boxes
特定のプロジェクトに関する詳細を取得 します ("YourProjectName" を実際のプロジェクト名に置き換えます)。
Show me details about the YourProjectName project
プロジェクトで使用可能な開発ボックス プールを一覧表示します。
What dev box pools are available in the YourProjectName project?
予期される出力: 開発ボックスに関する情報 (名前、状態 (実行中、停止など)、プロジェクト、プールの構成など)。
手順 3: 基本的な開発ボックス操作を実行する
自然言語コマンドを使用して、一般的な開発ボックス管理タスクを練習します。
開発ボックスの状態を確認する
特定の開発ボックスの状態を確認します。
What's the status of my DevBoxName dev box?
開発ボックスに関する詳細情報を取得します。
Show me detailed information about DevBoxName including its configuration and current state
開発ボックスを開始または停止する
停止した開発ボックスを開始します。
Start my DevBoxName dev box
実行中の開発ボックスを停止します。
Stop my DevBoxName dev box
注
開発ボックスの開始と停止は実行時間の長い操作であり、完了までに数分かかる場合があります。
スケジュールを操作する
シャットダウン スケジュールを確認する:
When is my DevBoxName dev box scheduled to shut down?
スケジュールされたシャットダウンを遅らせる:
Delay the shutdown of my DevBoxName dev box until 6 PM today
手順 4: 作業内容を確認する
結果を確認して、操作が正常に完了したことを確認します。
実行時間の長いタスクの操作状態を確認します。
What's the status of the operation I just started?
開発ボックスの状態の変更を確認します。
Show me the current status of DevBoxName
スケジュールの変更を確認します。
Show me the updated schedule for DevBoxName
検索対象:
- 完了すると、操作に "成功" 状態が表示されます
- 開発ボックスの電源状態は、開始/停止コマンドを反映している必要があります
- スケジュールの変更をスケジュール情報に表示する必要がある
手順 5: 高度なシナリオを試す (省略可能)
基本的な操作に慣れたら、次のより高度なシナリオを試してください。
新しい開発ボックスを作成する
Create a new dev box called "FeatureWork" in the DevelopmentProject using the StandardPool
カスタマイズの適用
What customization tasks are available for my project?
Install the development tools customization on my FeatureWork dev box
カスタマイズの進行状況を監視する
What's the status of the customization running on my FeatureWork dev box?
トラブルシューティング
このチュートリアル中に問題が発生した場合:
認証の問題
- サインインしていることを確認します。
az account show - Azure portal でアクセス許可を確認する
- サインアウトしてもう一度サインインする:
az logout、az login
ツールの登録エラー
-
Ctrl+Shift+P(VS Code) またはCtrl+Shift+P(Visual Studio) を押す - MCP の実行: キャッシュされたツールをリセットする
- IDE を再起動する
操作エラー
- 開発ボックス名とプロジェクト名が正しいことを確認する
- 操作に適切なアクセス許可があることを確認する
- 一部の操作には時間がかかる場合があります - 操作の状態を定期的に確認する
リソースをクリーンアップする (省略可能)
このチュートリアルでテスト リソースを作成した場合:
不要になったテスト開発ボックスを削除します。
Delete the FeatureWork dev box from DevelopmentProject
開発ボックスの実行を停止 してコストを節約する:
Stop all my running dev boxes
次のステップ
チュートリアルを完了したので、次のことができます。
- サポートされている操作の全範囲を調べる
- Dev Box MCP Server コマンドを毎日の開発ワークフローに統合する
- 自然言語コマンドをチームと共有して一般的な操作を行う