DSW インスタンスで MCP サービスを有効にすると、インスタンスをエージェントクライアントに接続できます。その後、エージェントはインスタンス内で直接コマンドを実行したり、ファイルを読み書きしたり、コードを実行したりできるようになり、クラウドベースの開発タスクを AI に任せることができます。
前提条件
DSW インスタンス、またはそれが属するリソースクォータに、VPC とセキュリティグループが設定されていること。
ユースケース
DSW インスタンスをエージェントに接続することで、エージェントはすぐに使用できるクラウド開発マシンを利用できます。エージェントはインスタンス内で直接コードを読み書きしたり、コマンドを実行したり、実験を実施したりできるようになり、反復的な環境操作を行う必要がなくなります。典型的なシナリオは次のとおりです:
リモートでのコード開発とデバッグ:エージェントにインスタンス内でコードを作成・修正させ、それを実行し、エラーを特定して修正し、再実行することで、開発ループ全体を完結できます。
環境準備と依存関係管理:エージェントに不足している Python やシステムの依存関係をインストールさせ、CUDA やフレームワークのバージョンを確認させ、ランタイム環境を検証させることで、コマンドを一つずつ入力する手間が省けます。
トレーニングと実験のホスティング:エージェントがトレーニングスクリプトを開始して非同期で待機し、ログと出力を監視し、トレーニングが終了すると結果を自動的に要約します。
データ処理とドキュメント整理:インスタンス内のデータファイルを一括で検索・クリーンアップしたり、ウェブページ、PDF、Office ドキュメントを後で分析するために Markdown に変換したりします。
MCP を介した DSW インスタンスとエージェントの接続
ステップ 1:DSW インスタンスの作成と MCP サービスの有効化
MCP サービスは、サービスの有効化、アクセス認証情報の生成、セキュリティグループでのポート開放の 3 つのステップで有効化します。その後、エージェントは MCP プロトコルを介してインスタンスにアクセスできます。
-
MCP サービスのスイッチを有効にします。次の例は、パブリックリソースを使用してインスタンスを作成する方法を示しています。このセクションの説明に従って主要なパラメーターを設定します。必要に応じて他のパラメーターも設定できます。
既存のインスタンスの場合は、インスタンスリストに移動し、[Actions] 列の [Change Configuration] をクリックして、DSW インスタンスを再設定します。
リソースタイプ :パブリックリソースを選択します。
VPC の設定 :同じリージョン内の VPC を選択します。MCP サービスを有効にするには VPC が必要です。
セキュリティグループ :作成したセキュリティグループを選択します。
vSwitch :作成した vSwitch を選択します。
MCP サービスの有効化 :スイッチをオンにします。スイッチをオンにすると、MCP という名前のサービスが有効になり、デフォルトでインスタンスのポート 9806 でリッスンします。
インターネットから (たとえば、ローカルのエージェントクライアントを介して) DSW インスタンスにアクセスする場合は、次のパラメーターを設定します:
-
サービスアクセスとポート設定 :
パブリックネットワークアクセス :チェックボックスにチェックを入れます。
パブリックネットワークアクセスポート :例:1078。
-
インスタンスへのパブリックアクセス :[DNAT + EIP] を選択します
NAT Gateway :同じリージョンに作成された NAT ゲートウェイを選択します。
-
Elastic IP Address :NAT ゲートウェイに関連付けられている EIP を選択します。
重要重要: DSW インスタンスがインターネットにアクセスできるようにするためには、NAT ゲートウェイに SNAT エントリを設定する必要があります。詳細については、「専用ゲートウェイによるパブリックアクセス速度の向上」をご参照ください。
設定が完了したら、OK をクリックしてインスタンスを作成します。
-
アクセス認証情報を生成します。DSW インスタンスが作成されたら、インスタンス名をクリックして詳細ページに移動します。アクセス設定 セクションで、[Generate Access Credentials] をクリックします。この認証情報は、エージェントが MCP サービスを呼び出す際の認証に使用します。認証情報は、ベアラートークンとしてリクエストヘッダーに含めて渡します。
これで、MCP のアクセスエンドポイントとアクセス認証情報が取得できました。
説明デフォルトでは、認証情報は 7 日間有効です。有効期限が切れたら、同じ場所で再生成します。再生成後、エージェントの設定で認証情報を更新する必要があります。
ステップ 2:セキュリティグループでのポートと IP アドレスの開放
DSW の詳細ページのネットワーク情報 セクションで、セキュリティグループ名をクリックしてセキュリティグループの詳細ページに移動します。[インバウンド] タブで、[ルールを追加] をクリックします。次のパラメーターを設定します。他のパラメーターはデフォルト値のままでかまいません。
送信元 :エージェントのデプロイ場所の IP アドレス (例:エージェントを実行するローカルコンピューターのパブリック IP アドレス) を入力します。
送信先 (このインスタンス) :ポート 9806 を入力します。
ステップ 3:エージェントと DSW インスタンスの接続
DSW MCP サービスは、標準のストリーマブル HTTP プロトコルを使用しており、主流のエージェントクライアントと互換性があります。エージェントクライアント (Open Code や Qoder CLI など) を開き、<MCP access endpoint> と <access credentials> を実際の値に置き換えて、次のプロンプトをエージェントに送信します。エージェントは自動的に MCP 接続を確立します。
ローカルのエージェントクライアントを使用して DSW インスタンスに接続する場合は、パブリックアクセスエンドポイントを使用します。
Add an MCP server named dsw-mcp with the Streamable HTTP protocol, endpoint http://<MCP access endpoint>, and request header Authorization: Bearer <access credentials>. Complete the setup automatically using your MCP configuration method.
接続が確立されたら、エージェントクライアントで次のコマンドを入力して接続性をテストします。
Create a hello_world Python file in the /mnt/workspace directory on the DSW instance.
コマンドの実行後、DSW インスタンスを開きます。ワークスペースに hello_world.py ファイルが表示されます。
サポート対象ツール
DSW MCP サービスは、標準のストリーマブル HTTP プロトコルを介して一連のツールを公開します。エージェントは接続後にツールリストを自動的にロードします。ツールは、シェル、ファイル、システム、フォーマット変換、コードの 5 つのカテゴリに分類されており、合計 16 種類です。
シェルツール
インスタンス内でコマンドを実行します。連続するコマンドは作業ディレクトリを共有するため、スクリプトの実行、依存関係のインストール、トレーニングジョブの開始に役立ちます。
|
ツール |
機能 |
主要なパラメーター |
|
|
シェルコマンドの実行 |
cmd (必須)、cwd、new_session、timeout |
|
|
セッションの累積出力とステータスの表示 |
session_id、limit |
|
|
非同期コマンドの完了を待機 |
session_id、seconds |
|
|
実行中のプロセスへの入力送信 |
session_id、input、press_enter |
|
|
セッションの終了とクリーンアップ |
session_id |
ファイルツール
インスタンス内のファイルを読み取り、書き込み、検索、編集します。
|
ツール |
機能 |
主要なパラメーター |
|
|
ファイルコンテンツの読み取り (行範囲による) |
path (必須)、start_line、end_line、sudo |
|
|
ファイルへの書き込みまたは追記。base64 バイナリをサポート |
path、content、encoding、append |
|
|
ファイル内の文字列のグローバル置換 |
path、old_str、new_str |
|
|
正規表現によるファイルコンテンツの検索 |
path、regex |
|
|
glob パターンによるファイルの検索 |
path、pattern |
|
|
ディレクトリの一覧表示 (再帰的、ファイル種別によるフィルタリング) |
path、recursive、file_types |
|
|
元に戻すことができるエディター |
command (view/create/str_replace/insert/undo_edit)、path など |
システムツール
インスタンス環境とインストール済みの依存関係を照会します。
|
ツール |
機能 |
主要なパラメーター |
|
|
インスタンス環境 (OS、Python、Node、利用可能なツール) の照会 |
なし |
|
|
インストール済みの Python または Node.js パッケージの一覧表示 |
language |
フォーマット変換ツール
|
ツール |
機能 |
主要なパラメーター |
|
|
ウェブページ、PDF、Office ファイル、画像などを Markdown に変換 |
uri |
コードツール
|
ツール |
機能 |
主要なパラメーター |
|
|
コードの実行 (現在 Python をサポート) |
code、language、timeout |
MCP サービスを有効にすると、ツールはすぐに利用できます。追加の設定は必要ありません。