MCP 経由での AgentBay への AI モデル接続によるツール呼び出し - AgentBay

AgentBay プラットフォームは、オープン標準の Model Context Protocol (MCP) を採用し、AI モデルと実行環境の間で統一されたインターフェイスを提供します。クラウド環境との深く統合された設計により、MCP 経由でセッション管理、ファイル操作、コマンド実行、アプリケーション管理、ウィンドウ制御などのクラウド機能に直接アクセスできます。

前提条件

アカウントおよび権限： Alibaba Cloud アカウントの有効化を完了している必要があります。
新規ユーザー体験：初めて Alibaba Cloud 上で AgentBay をお試しになる場合は、新規ユーザー体験プログラムの申し込みを行ってください。

API キーの取得

AgentBay コンソールにログインします。
左側のナビゲーションウィンドウで、サービス管理 をクリックします。
サービス管理 ページで、API キーの作成 をクリックします。
[API キーの作成] ダイアログボックスで名前を入力し、[OK]をクリックします。
重要
データセキュリティを保護するため、API キーを共有しないでください。

イメージの選択

MCP URL の IMAGEID フィールドを、ご要件に合致するイメージに設定します。以下に示す MCP URL はコード例であり、実際の利用にはコンソールから取得したコードをご使用ください。MCP URL の取得方法については、「MCP URL の取得」をご参照ください。

特定バージョンのイメージの選択

IMAGEID フィールドを、OS イメージまたはカスタムイメージの特定バージョンに設定します。

OS イメージ

AgentBay コンソールにログインします。
左側のナビゲーションウィンドウで、イメージ管理（ベータ） をクリックします。
イメージ管理（ベータ） で、OS イメージ タブをクリックします。その後、イメージ一覧からイメージ ID をコピーします。

カスタムイメージ

AgentBay コンソールにログインします。
左側のナビゲーションウィンドウで、イメージ管理（ベータ） をクリックします。
イメージ管理（ベータ） で、カスタムイメージ タブをクリックします。その後、イメージ一覧からイメージ ID をコピーします。

MCP サーバーの構成

Cline や Cursor など、MCP をサポートするツールに MCP URL を追加します。以下の手順では Cursor v0.50.5 を例として説明します。

Cursor 設定項目 パネルを開きます。左側のナビゲーションウィンドウで、MCP をクリックします。
MCP サーバー パネルの右上隅にある 新しいグローバル MCP サーバーの追加 をクリックします。
MCP URL の取得からコピーした MCP URL のコードブロックを mcp.json ファイルに貼り付け、ファイルを保存して構成を完了します。SSE、Stdio、Streamable の 3 種類の接続方法がサポートされています。プロジェクトの要件に応じて適切な方法を選択してください。
SSE
- YOUR_API_KEY を、「API キーの取得」で取得した API キーに設定します。
- IMAGEID を、「イメージの選択」で取得したイメージ ID に設定します。
```
{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay-intl.wuying.aliyuncs.com/v2/sse?APIKEY=YOUR_API_KEY&IMAGEID=browser_latest"
    }
  }
}
```
Streamable
- YOUR_API_KEY を、「API キーの取得」で取得した API キーに設定します。
- IMAGEID を、「イメージの選択」で取得したイメージ ID に設定します。
```
{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay-intl.wuying.aliyuncs.com/v2/mcp?APIKEY=YOUR_API_KEY&IMAGEID=browser_latest"
    }
  }
}
```

AgentBay の体験

クラウドブラウザイメージを使用して Alibaba Cloud ウェブサイトにアクセス

AgentBay MCP を MCP 対応ツールに構成した後、そのツールのエージェントと対話することで、AgentBay MCP 上でタスクを実行できます。

説明

以下の例では、IMAGEID を browser_latest に設定しています。

次のコマンドを実行します。エージェントがクラウドブラウザセッション内で Alibaba Cloud ウェブサイトを開きます。
```
Alibaba Cloud ウェブサイトにアクセス
```
次のコマンドを実行して、サンドボックス環境の URL を取得します。この URL を使用してタスクのステータスを確認できます。
```
Wuying MCP サービスのサンドボックス環境の URL を返す
```
- この URL は有効期限があり、開く回数に制限があります。直ちにご利用ください。
- URL パラメーター &input=true&keyboard=true を使用して、キーボードおよびマウスのインタラクションを有効または無効にできます。また、Web SDK を使用してリアルタイムでこれらの設定を変更することも可能です。詳細については、「Web SDK」をご参照ください。

次のステップ

カスタムイメージの使用：デフォルトイメージでネットワークパフォーマンスの低下やアプリケーションの欠落などの問題が発生した場合、カスタムイメージをご利用ください。詳細については、「イメージの作成」をご参照ください。
MCP ツールについて学ぶ：サポートされている MCP ツールおよびその使い方については、「MCP ツールのまとめ」をご参照ください。

AgentBay:MCP を使用した接続