MCP接入指南

步骤1：创建API Key

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

1. 登录AgentBay控制台。

2. 在左侧导航栏中单击服务管理。

3. 在服务管理页面上单击创建API KEY。

4. 在创建API KEY对话框中输入名称，并单击确定。

   说明

   • 如您的账号尚未进行实名认证，请在完成个人或企业实名认证后使用该功能。更多操作，请参见个人实名认证及企业实名认证。

   • 公测期间最多可以创建10个API Key。

   重要

   为保障数据安全，请不要与他人共享您的API Key。

步骤2：查看MCP地址

1. 登录AgentBay控制台。

2. 在左侧导航栏中单击服务管理。

3. 在服务管理页面上，在目标API KEY的操作列中单击查看MCP地址。

4. 在MCP地址对话框中，根据业务需求选择以下任一页签。

   • Windows

   • Linux

   • Browser

   • Code

   • Mobile

5. 单击复制代码。

步骤3：设置镜像

请根据您的业务需求，通过在MCP地址的IMAGEID字段中指定合适的镜像。下文MCP地址仅为代码示例，实际请以您在步骤2中复制的代码为准。

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

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

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

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

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

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

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

步骤4：配置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文件中粘贴步骤2：查看MCP地址复制的MCP地址代码块，并保存文件。

   • 默认支持SSE连接方式，SSE会在每次服务通过线上长连接完成握手，不依赖插件下载。

     {
       "mcpServers": {
         "wuying_mcp_server": {
           "url": "https://pre-mcp-wuying.aliyun-inc.com/sse?APIKEY=YOUR_API_KEY&IMAGEID=linux_latest"
         }
       }
     }

   • SESSIONIDSSE（可选参数）：SSE连接默认创建新云桌面，添加SESSIONIDSSE=xxxxxx（字符串）参数可连接同一桌面（在云桌面超时期限内）。示例如下。

     {
       "mcpServers": {
         "wuying_mcp_server": {
           "url": "https://pre-mcp-wuying.aliyun-inc.com/sse?APIKEY=YOUR_API_KEY&IMAGEID=linux_latest&SESSIONIDSSE=xxxxxx"
         }
       }
     }

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

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

• 该链接具有有效期限制和打开次数限制，建议立即使用。

• 可以通过URL中的参数&input=true&keyboard=true来配置键鼠交互开关，也可以通过Web SDK中的接口实时配置交互开关。详细信息，请参见Web SDK文档。