MCP接入指南_无影 Agent 开发套件 AgentBay(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/sse?APIKEY=akm-**************&IMAGEID=windows_latest"
    }
  }
}

Linux

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

Browser

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

Code

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

Mobile

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

设置指定的自定义镜像

说明

获取镜像ID：

请登录AgentBay控制台，单击镜像管理（Beta）。在镜像管理（Beta）中选择自定义镜像页签，然后在镜像列表中获取您的目标镜像ID，并替换<YOUR_IMAGEID>。

{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay.wuying.aliyuncs.com/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连接方式，SSE会在每次服务通过线上长连接完成握手，不依赖插件下载。
```
{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay.wuying.aliyuncs.com/sse?APIKEY=YOUR_API_KEY&IMAGEID=linux_latest"
    }
  }
}
```
- SESSIONIDSSE（可选参数）：SSE连接默认创建新云桌面，添加SESSIONIDSSE=xxxxxx（字符串）参数可连接同一桌面（在云桌面超时期限内）。示例如下。
```
{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay.wuying.aliyuncs.com/sse?APIKEY=YOUR_API_KEY&IMAGEID=linux_latest&SESSIONIDSSE=xxxxxx"
    }
  }
}
```

步骤3（可选）：使用画面流

若资源类型为通用资源池或独立资源池，则支持通过无影Web SDK iframe内嵌或通过浏览器拉取无影Web客户端的方式打开云电脑画面。需要调用云电脑画面流时，MCP会返回带登录参数的链接，格式为https://wuying.aliyun.com?mcp.html?authcode=<authCode>&resourceId=<resourceId>。

该链接具有有效期限制和打开次数限制，建议立即使用。
可以通过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（对象存储服务）模块提供与云存储服务交互的功能。	支持	支持	暂不支持	支持	支持
UI	UI 类提供在 AgentBay 云环境与 UI 元素交互的方法。这包括获取 UI 元素、发送按键事件、输入文本、执行手势操作以及截屏。	支持	支持	暂不支持	支持	不涉及
Application	Application类提供在AgentBay云环境中管理应用程序的方法，包括列出已安装的应用程序、启动应用程序以及停止运行中的进程。	支持	暂不支持	暂不支持	暂不支持	不涉及
Context	Context API提供在AgentBay云环境中管理持久化存储上下文的功能。上下文允许您在会话间持久化数据并在未来会话中复用。	不涉及	不涉及	不涉及	不涉及	不涉及
Command	Command 类提供在 AgentBay 云环境会话中执行命令的方法。	支持	支持	支持	支持	支持
CodeSpace	在指定的编程语言中执行代码，并设置超时时间。	不涉及	不涉及	不涉及	不涉及	支持

上一篇: Application 下一篇: Computer Use Linux