使用MCP快速接入_无影 Agent 开发套件 AgentBay(AgentBay)-阿里云帮助中心

本文介绍如何创建无影Agent Bay API Key，并以Cursor为例介绍如何通过MCP将无影Agent Bay接入工具。

获取API Key

创建API Key

说明

如账号尚未进行实名认证，需先完成个人或企业实名认证后使用该功能。更多操作，请参见个人实名认证及企业实名认证。
公测期间最多可以创建10个API Key。

为项目创建API Key，以灵活选择可用的虚拟化云服务和 MCP 镜像范围。

登录AgentBay控制台。
在左侧导航栏中单击服务管理。
在服务管理页面上单击创建API KEY。
在创建API KEY对话框中输入名称，并单击确定。
重要
为保障数据安全，请严格保密API Key，避免任何形式的外泄或共享。

查看API Key

查看：在服务管理页面上，在目标API KEY的API KEY名称/值列中单击图标。
复制：在服务管理页面上，在目标API KEY的API KEY名称/值列中单击图标。

说明

关于管理API Key的更多操作，请参见创建和管理API Key。

设置镜像

根据业务需求，在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，设置完成后将使用该指定镜像。

设置指定系统镜像

登录AgentBay控制台，单击镜像管理（Beta），选择系统镜像页签，在列表中单击复制按钮，获取目标镜像ID，并替换<YOUR_IMAGEID>。

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

设置指定自定义镜像

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

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

配置MCP服务

在支持MCP的工具中添加MCP地址，下文以Cursor V0.50.5版本为例。

打开Cursor Settings面板，在左侧导航栏中单击MCP。
在MCP Servers面板上单击右上角Add new global MCP server。
在mcp.json文件中粘贴获取MCP地址复制的MCP地址代码块，并保存文件，完成服务配置。
- 默认支持SSE连接方式，SSE会在每次服务通过线上长连接完成握手，不依赖插件下载。
```
{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay.wuying.aliyuncs.com/sse?APIKEY=akm-1692b7b6-******************9961&IMAGEID=linux_latest"
    }
  }
}
```
- SESSIONIDSSE（可选参数）：SSE连接默认创建新云桌面，添加SESSIONIDSSE=xxxxxx（字符串）参数可连接同一桌面（在云桌面超时期限内），示例如下。
```
{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay.wuying.aliyuncs.com/sse?APIKEY=akm-1692b7b6-******************9961&IMAGEID=linux_latest&SESSIONIDSSE=xxxxxx"
    }
  }
}
```