全部產品
Search
文件中心

AgentBay:通過MCP接入

更新時間:Mar 14, 2026

AgentBay平台基於開源標準化協議MCP(Model Context Protocol)為AI模型與運行環境之間提供了統一的互動介面。該平台實現了與雲端運行環境的深度整合,使開發人員能夠通過MCP直接存取會話管理、檔案操作、命令執行、應用管理及視窗控制等雲端功能。

前提條件

擷取API Key

  1. 登入AgentBay控制台

  2. 在左側導覽列中單擊服務管理

  3. 服務管理頁面上單擊建立API KEY

  4. 建立API KEY對話方塊中輸入名稱,並單擊確定

    重要

    為保障資料安全,請勿共用API Key。

選擇鏡像

根據業務需求在MCP地址的IMAGEID欄位中指定合適的鏡像。下文MCP地址僅為程式碼範例,實際請以控制台的代碼為準。關於查看MCP地址的更多資訊,請參見擷取MCP地址

選擇最新鏡像

請根據環境選擇設定為最新鏡像後,將始終為您使用該環境的latest鏡像。

  • 雲電腦(Windows):windows_latest

  • 雲電腦(Linux):linux_latest

  • 雲瀏覽器:browser_latest

  • 代碼沙箱:code_latest

  • 雲手機:mobile_latest

選擇指定版本鏡像

可以將IMAGEID欄位設定為指定版本的系統鏡像,包括系統鏡像和自訂鏡像。

系統鏡像

  1. 登入AgentBay控制台

  2. 在左側導覽列選擇鏡像管理(Beta)

  3. 鏡像管理(Beta)中選擇系統鏡像頁簽,在鏡像列表中擷取鏡像ID。

自訂鏡像

  1. 登入AgentBay控制台

  2. 在左側導覽列選擇鏡像管理(Beta)

  3. 鏡像管理(Beta)中選擇自訂鏡像頁簽,在鏡像列表中擷取鏡像ID。

配置MCP服務

在支援MCP的工具(例如:Cline、Cursor等)中添加MCP地址的代碼塊。下文以Cursor V0.50.5版本為例說明。

  1. 開啟Cursor Settings(Cursor設定)面板,在左側導覽列中單擊MCP

  2. MCP Servers(MCP伺服器)面板上單擊右上方的Add new global MCP server(添加全域MCP伺服器)。

  3. 在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為例。

  1. 執行以下命令,Agent將建立AgentBay雲瀏覽器會話,在瀏覽器中開啟阿里雲官網。

    訪問阿里雲官網
  2. 可通過如下指令,要求工具返回指定的沙箱環境連結,可通過此連結訪問沙箱環境,查看任務執行情況。

    返回無影 MCP 服務沙箱環境的url
    • 該連結具有有效期間限制和開啟次數限制,建議立即使用。

    • 可以通過URL中的參數&input=true&keyboard=true來配置鍵鼠互動開關,也可以通過Web SDK中的介面即時配置互動開關。詳細資料,請參見Web SDK

後續步驟

  • 使用自訂鏡像:在實際的使用與開發過程中,如果遇到網路效能不足,預設鏡像缺少所需應用等原因時,可通過使用自訂鏡像解決相關問題,詳情請參見建立鏡像

  • 瞭解MCP Tools:在實際的使用與開發過程中,如果想要瞭解無影AgentBay MCP工具的使用和支援範圍,請參見MCP工具匯總