MCP 接入适用于支持 MCP 协议的客户端、AI 开发工具或 IDE 插件。当前版本建议采用本地 STDIO MCP Server 方式接入。
接入模型
MCP Client 通过本地 STDIO 启动 AIuse 云电脑 MCP Server。MCP Server 读取 AccessKey 配置后，通过 AIuse 云电脑服务创建会话、发送工具调用请求，并将结果返回给 MCP Client。
简化流程如下：
Qoder / MCP Client
-> 本地 STDIO MCP Server
-> AIuse 云电脑服务
-> 目标云电脑执行 Computer Use / FileSystem 操作
-> 返回结果环境要求
| 项目 | 要求 |
|---|---|
| Node.js | 建议 Node.js 18 或以上 LTS 版本 |
| npx | 本地可执行 npx -v |
| MCP Client | 支持本地 STDIO MCP Server |
| AccessKey | 已获取 AccessKey ID 和 AccessKey Secret |
| 云电脑 | 已获取目标云电脑的 desktopCode，且云电脑在线 |
Node.js 安装方式如下：
打开 Node.js 官网下载页面
选择维护期内的 LTS 版本安装包
按安装向导完成安装
安装完成后重新打开终端
依次执行 node -v 和 npx -v，确认命令可正常使用
如果本地已安装 Node.js，但仍无法执行 npx，请检查：
Node.js 是否安装完整
当前终端是否已重新打开
Node.js 安装目录是否已加入系统 PATH
Qoder 配置示例
Qoder 支持通过 JSON 配置添加自定义 MCP Server。可以在 Qoder 的 MCP 设置页面中添加以下配置：
{
"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 | 是 | 启动命令，当前示例使用 npx |
| args | 是 | 启动参数，包含 MCP Server 包名 |
| CTG_APIKEY | 是 | AccessKey ID |
| CTG_APISECRET | 是 | AccessKey Secret |
| CTG_SERVICEURL | 否 | 服务地址，未配置时使用默认服务地址 |
当前 MCP Server 暂不支持通过 DESKTOP_CODE 环境变量指定固定桌面。调用工具时，需要在工具参数或自然语言指令中包含 desktopCode。
调用方式
在 Qoder 中可以直接用自然语言说明目标桌面和任务：
在 desktopCode=xxx 桌面，创建一下 C:/ai-user-test 文件夹。如果 MCP Client 展示结构化工具参数，则需要填写：
{
"desktopCode": "xxx",
"path": "C:/ai-user-test"
}接入流程
准备 AccessKey ID、AccessKey Secret 和目标云电脑
desktopCode。确认本地 Node.js 和
npx可用。在 Qoder 或其他 MCP Client 中添加 MCP Server 配置。
保存配置并刷新 MCP Client。
确认工具列表加载成功。
调用 Computer Use 或 FileSystem 工具，并在请求中指定
desktopCode。
验证建议
建议先执行低风险工具验证配置是否可用：
在 desktopCode=xxx 桌面，获取当前鼠标位置。然后再执行文件或鼠标键盘操作：
在 desktopCode=xxx 桌面，创建一下 C:/ai-user-test 文件夹。安全建议
不要将包含 AccessKey Secret 的 MCP 配置提交到公开仓库。
多人共享开发环境时，应使用个人或项目级 AccessKey。
AccessKey 应只关联必要的云电脑资源。
AccessKey 泄露后应立即在控制台禁用。
文件系统工具具备读写目标云电脑文件的能力，建议只在可信任务和可信桌面中启用。
