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.wuying.aliyuncs.com/v2/sse?APIKEY=YOUR_API_KEY&IMAGEID=browser_latest" } } }Stdio
{ "mcpServers": { "wuying_mcp_server": { "command": "npx", "args": ["-y", "wuying-agentbay-mcp-server"], "env": { "APIKEY": "akm—*****", "IMAGEID": "browser_latest" } } } }Streamable
{ "mcpServers": { "wuying_mcp_server": { "url": "https://agentbay.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。