AgentBay平台基於開源標準化協議MCP(Model Context Protocol)為AI模型與運行環境之間提供了統一的互動介面。該平台實現了與雲端運行環境的深度整合,使開發人員能夠通過MCP直接存取會話管理、檔案操作、命令執行、應用管理及視窗控制等雲端功能。
前提條件
擷取API Key
登入AgentBay控制台。
在左側導覽列中單擊服務管理。
在服務管理頁面上單擊建立API KEY。
在建立API KEY對話方塊中輸入名稱,並單擊確定。
重要為保障資料安全,請勿共用API Key。
選擇鏡像
根據業務需求在MCP地址的IMAGEID欄位中指定合適的鏡像。下文MCP地址僅為程式碼範例,實際請以控制台的代碼為準。關於查看MCP地址的更多資訊,請參見擷取MCP地址。
選擇最新鏡像
請根據環境選擇設定為最新鏡像後,將始終為您使用該環境的latest鏡像。
雲電腦(Windows):
windows_latest雲電腦(Linux):
linux_latest雲瀏覽器:
browser_latest代碼沙箱:
code_latest雲手機:
mobile_latest
選擇指定版本鏡像
可以將IMAGEID欄位設定為指定版本的系統鏡像,包括系統鏡像和自訂鏡像。
系統鏡像
登入AgentBay控制台。
在左側導覽列選擇鏡像管理(Beta)。
在鏡像管理(Beta)中選擇系統鏡像頁簽,在鏡像列表中擷取鏡像ID。
自訂鏡像
登入AgentBay控制台。
在左側導覽列選擇鏡像管理(Beta)。
在鏡像管理(Beta)中選擇自訂鏡像頁簽,在鏡像列表中擷取鏡像ID。
配置MCP服務
在支援MCP的工具(例如:Cline、Cursor等)中添加MCP地址的代碼塊。下文以Cursor V0.50.5版本為例說明。
開啟Cursor Settings(Cursor設定)面板,在左側導覽列中單擊MCP。
在MCP Servers(MCP伺服器)面板上單擊右上方的Add new global MCP server(添加全域MCP伺服器)。
在mcp.json檔案中粘貼擷取MCP地址複製的MCP地址代碼塊,並儲存檔案,完成服務配置。支援SSE、Stdio、Streamable三種方式,開發人員可根據專案需求選擇合適的串連方式。
SSE
{ "mcpServers": { "wuying_mcp_server": { "url": "https://agentbay-intl.wuying.aliyuncs.com/v2/sse?APIKEY=YOUR_API_KEY&IMAGEID=browser_latest" } } }Streamable
{ "mcpServers": { "wuying_mcp_server": { "url": "https://agentbay-intl.wuying.aliyuncs.com/v2/mcp?APIKEY=YOUR_API_KEY&IMAGEID=browser_latest" } }
體驗AgentBay
使用雲瀏覽器鏡像訪問阿里雲官網
在支援MCP的工具中完成AgentBay MCP配置後,可通過與工具的Agent對話,驅動AgentBay MCP完成相關任務。
以下樣本以IMAGEID配置為browser_latest為例。
執行以下命令,Agent將建立AgentBay雲瀏覽器會話,在瀏覽器中開啟阿里雲官網。
訪問阿里雲官網可通過如下指令,要求工具返回指定的沙箱環境連結,可通過此連結訪問沙箱環境,查看任務執行情況。
返回無影 MCP 服務沙箱環境的url該連結具有有效期間限制和開啟次數限制,建議立即使用。
可以通過URL中的參數
&input=true&keyboard=true來配置鍵鼠互動開關,也可以通過Web SDK中的介面即時配置互動開關。詳細資料,請參見Web SDK。