MCP接入指南 - AgentBay

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

前提條件

請確保您已建立API Key，否則在操作步驟中將缺少必要的資訊。更多操作，請參見建立API Key。

操作步驟

步驟1：設定鏡像

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

設定最新鏡像

請根據您的環境在下文中查看樣本，設定為最新鏡像後，將始終為您使用該環境的latest鏡像。

Windows

{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay.wuying.aliyuncs.com/v2/sse?APIKEY=akm-**************&IMAGEID=windows_latest"
    }
  }
}

Linux

{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay.wuying.aliyuncs.com/v2/sse?APIKEY=akm-**************&IMAGEID=linux_latest"
    }
  }
}

Browser

{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay.wuying.aliyuncs.com/v2/sse?APIKEY=akm-**************&IMAGEID=browser_latest"
    }
  }
}

Code

{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay.wuying.aliyuncs.com/v2/sse?APIKEY=akm-**************&IMAGEID=code_latest"
    }
  }
}

Mobile

{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay.wuying.aliyuncs.com/v2/sse?APIKEY=akm-**************&IMAGEID=mobile_latest"
    }
  }
}

設定指定鏡像ID

您也可以將IMAGEID欄位設定為系統鏡像或自訂鏡像的鏡像ID，設定完成後將使用該鏡像ID對應的鏡像。

設定指定的系統鏡像

說明

擷取鏡像ID：

請登入AgentBay控制台，單擊鏡像管理（Beta）。在鏡像管理（Beta）中選擇系統鏡像頁簽，然後在鏡像列表中擷取您的目標鏡像ID，並替換<YOUR_IMAGEID>。

{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay.wuying.aliyuncs.com/v2/sse?APIKEY=akm-**************&IMAGEID=<YOUR_IMAGEID>"
    }
  }
}

設定指定的自訂鏡像

說明

擷取鏡像ID：

請登入AgentBay控制台，單擊鏡像管理（Beta）。在鏡像管理（Beta）中選擇自訂鏡像頁簽，然後在鏡像列表中擷取您的目標鏡像ID，並替換<YOUR_IMAGEID>。

{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay.wuying.aliyuncs.com/v2/sse?APIKEY=akm-**************&IMAGEID=<YOUR_IMAGEID>"
    }
  }
}

步驟2：配置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=linux_latest"
    }
  }
}

Streamable

{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay-intl.wuying.aliyuncs.com/v2/mcp?APIKEY=YOUR_API_KEY&IMAGEID=linux_latest"
    }
  }
}

步驟3（可選）：使用畫面流

若資源類型為通用資源集區或獨立資源集區，則支援通過無影Web SDK iframe內嵌或通過瀏覽器拉取無影Web用戶端的方式開啟雲電腦畫面。需要調用雲電腦畫面流時，MCP會返回帶登入參數的連結，格式為https://wuying.aliyun.com?mcp.html?authcode=<authCode>&resourceId=<resourceId>。

重要

其中authcode和resourceId作為重要的登入憑證，將通過MCP一併返回，請勿隨意修改。

該連結具有有效期間限制和開啟次數限制，建議立即使用。
可以通過URL中的參數&input=true&keyboard=true來配置鍵鼠互動開關，也可以通過Web SDK中的介面即時配置互動開關。詳細資料，請參見Web SDK文檔。

MCP Tool List

MCP Tool list工具使用和支援範圍請參考下文，請根據您的環境進行選擇以查看更多資訊。

類	描述	環境（鏡像）
類	描述	Computer Use Windows	Computer Use Linux	Browser Use	Mobile Use	CodeSpace
Sessions	Session類表示AgentBay雲環境中的會話。它提供了管理檔案系統、執行命令等的方法。	支援	支援	支援	支援	支援
Filesystem	FileSystem類提供在AgentBay雲環境會話中進行檔案操作的方法，包括讀取、寫入、編輯、搜尋檔案以及目錄操作。	支援	支援	支援	暫不支援	支援
OSS	OSS（Object Storage Service服務）模組提供與雲端儲存體服務互動的功能。	支援	支援	暫不支援	支援	支援
UI	UI 類提供在 AgentBay 雲環境與 UI 元素互動的方法。這包括擷取 UI 元素、發送按鍵事件、輸入文本、執行手勢操作以及截屏。	支援	支援	暫不支援	支援	不涉及
Application	Application類提供在AgentBay雲環境中管理應用程式的方法，包括列出已安裝的應用程式、啟動應用程式以及停止運行中的進程。	支援	暫不支援	暫不支援	暫不支援	不涉及
Context	Context API提供在AgentBay雲環境中管理持久化儲存內容相關的功能。上下文允許您在會話間持久化資料並在未來會話中複用。	不涉及	不涉及	不涉及	不涉及	不涉及
Command	Command 類提供在 AgentBay 雲環境會話中執行命令的方法。	支援	支援	支援	支援	支援
CodeSpace	在指定的程式設計語言中執行代碼，並設定逾時時間。	不涉及	不涉及	不涉及	不涉及	支援