本文介绍如何通过 MCP 接入 AIuse 云电脑能力。MCP 接入适合在支持 MCP 的 IDE、AI 开发工具或自动化工具中，以标准工具调用方式使用云电脑的桌面控制和文件系统能力。
当前 MCP Server 采用本地 STDIO 方式运行。本文以 Qoder 为例说明接入方式，其他支持 STDIO MCP Server 的客户端也可以参考同样的配置思路。
能力范围
当前版本 MCP Server 已开放以下能力。
Computer Use 工具：
move_mouse：移动鼠标到指定坐标。click_mouse：点击鼠标。drag_mouse：拖拽鼠标。scroll：滚动页面或列表。press_key：按下键盘按键或组合键。type_text：输入文本。screen_shot：截取当前桌面屏幕。get_cursor_position：获取当前鼠标位置。
FileSystem 工具：
create_directory：创建目录。read_file：读取文本文件。write_file：写入文本文件。move_file：移动或重命名文件、目录。search_files：搜索文件。
前提条件
| 项目 | 说明 |
|---|---|
| MCP Client | 支持本地 STDIO MCP Server，例如 Qoder |
| Node.js | 建议使用 Node.js 18 或以上 LTS 版本 |
| npx | 本地终端可执行 npx -v |
| AccessKey ID | 控制台创建的 AccessKey ID |
| AccessKey Secret | 控制台创建的 AccessKey Secret |
| desktopCode | 需要操作的云电脑桌面编码 |
当前 MCP Server 暂不从环境变量读取 DESKTOP_CODE。调用工具时，需要在自然语言指令或工具参数中明确目标桌面编码，例如：“在 desktopCode=xxx 桌面，创建一下 C:/ai-user-test 文件夹”。
Node.js 安装方式如下：
打开 Node.js 官网下载页面
选择维护期内的 LTS 版本安装包
按安装向导完成安装
安装完成后重新打开终端
依次执行 node -v 和 npx -v，确认命令可正常使用
如果本地已安装 Node.js，但仍无法执行 npx，请检查：
Node.js 是否安装完整
当前终端是否已重新打开
Node.js 安装目录是否已加入系统 PATH
在 Qoder 中配置
打开 Qoder。
进入 Qoder 的设置页面。
找到 MCP 配置入口。
添加自定义 MCP Server。
粘贴以下 JSON 配置。
保存后刷新或重启 Qoder，确认 MCP Server 状态正常。
{
"mcpServers": {
"aiuse-desktop": {
"command": "npx",
"args": ["-y", "@ctyun/desktop-agent-mcp"],
"env": {
"CTG_APIKEY": "your-access-key-id",
"CTG_APISECRET": "your-access-key-secret",
"CTG_SERVICEURL": "https://desk.ctyun.cn:8816"
}
}
}
}参数说明：
| 字段 | 是否必填 | 说明 |
|---|---|---|
| command | 是 | 启动 MCP Server 的命令，推荐使用 npx |
| args | 是 | MCP Server 包名和启动参数 |
| CTG_APIKEY | 是 | AccessKey ID |
| CTG_APISECRET | 是 | AccessKey Secret |
| CTG_SERVICEURL | 否 | 服务地址，未配置时使用 SDK 默认地址 |
验证接入
配置完成后，在 Qoder 中查看 MCP 工具列表。若能看到 move_mouse、click_mouse、type_text、screen_shot、read_file、write_file 等工具，通常表示 MCP Server 已成功启动。
可以在 Qoder 中输入类似指令进行验证：
在 desktopCode=xxx 桌面，截取当前屏幕。也可以请求文件系统操作：
在 desktopCode=xxx 桌面，创建一下 C:/ai-user-test 文件夹。工具调用示例
移动鼠标：
{
"name": "move_mouse",
"arguments": {
"desktopCode": "xxx",
"x": 500,
"y": 300
}
}输入文本：
{
"name": "type_text",
"arguments": {
"desktopCode": "xxx",
"text": "Hello from AIuse MCP"
}
}创建目录：
{
"name": "create_directory",
"arguments": {
"desktopCode": "xxx",
"path": "C:/ai-user-test"
}
}常见问题
如果 Qoder 中没有加载出工具列表，请优先检查：
本地是否已安装 Node.js，且
npx -v可正常输出版本号。MCP 配置中的
command、args和env是否填写正确。CTG_APIKEY和CTG_APISECRET是否正确。AccessKey 是否已关联目标云电脑。
目标云电脑是否在线。
调用工具时是否明确传入或说明了
desktopCode。
安全建议
不要将包含 AccessKey Secret 的 MCP 配置提交到公开仓库。
多人共享开发环境时，建议使用个人或项目级 AccessKey。
如 Qoder 或 MCP Client 支持密钥管理，建议优先使用密钥管理能力。
AccessKey 泄露后，应立即在控制台禁用并更换。
