场景目标

本教程完成以下动作：

1. 在 Qoder 中配置 MCP Server。

2. 确认可用工具列表。

3. 截取云电脑屏幕。

4. 创建一个测试目录。

5. 写入并读取一个文本文件。

6. 执行一次鼠标移动或文本输入。

准备信息

请准备以下信息：

配置 MCP Server

在 Qoder 的 MCP 设置页面中添加自定义 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"
      }
    }
  }
}

保存后刷新或重启 Qoder。

确认工具加载

初始化完成后，Qoder 应能展示 MCP 工具列表。当前版本工具包括：

• move_mouse

• click_mouse

• drag_mouse

• scroll

• press_key

• type_text

• screen_shot

• get_cursor_position

• create_directory

• read_file

• write_file

• move_file

• search_files

如果工具列表为空或 MCP Server 状态异常，请先检查 Node.js、npx、包名和 AccessKey 配置。

截图验证桌面

在 Qoder 中输入：

在 desktopCode=xxx 桌面，截取当前屏幕。

结构化工具调用等价于：

{
  "name": "screen_shot",
  "arguments": {
    "desktopCode": "xxx"
  }
}

创建测试目录

在 Qoder 中输入：

在 desktopCode=xxx 桌面，创建一下 C:/ai-user-test 文件夹。

结构化工具调用等价于：

{
  "name": "create_directory",
  "arguments": {
    "desktopCode": "xxx",
    "path": "C:/ai-user-test"
  }
}

写入文件

{
  "name": "write_file",
  "arguments": {
    "desktopCode": "xxx",
    "path": "C:/ai-user-test/hello.txt",
    "mode": "overwrite",
    "content": "Hello from AIuse MCP"
  }
}

读取文件

{
  "name": "read_file",
  "arguments": {
    "desktopCode": "xxx",
    "path": "C:/ai-user-test/hello.txt",
    "offset": 0,
    "length": 0
  }
}

length 为 0 时表示读取从 offset 开始的剩余内容。

执行 GUI 操作

移动鼠标：

{
  "name": "move_mouse",
  "arguments": {
    "desktopCode": "xxx",
    "x": 500,
    "y": 300
  }
}

输入文本：

{
  "name": "type_text",
  "arguments": {
    "desktopCode": "xxx",
    "text": "Hello from AIuse MCP"
  }
}

排查建议

如果没有看到工具列表，请检查：

• npx 是否可用。

• MCP Server 包名是否正确。

• CTG_APIKEY 和 CTG_APISECRET 是否填写正确。

• AccessKey 是否已关联目标云电脑。

• 云电脑是否在线。

如果工具调用失败，请检查：

• 指令或工具参数中是否包含 desktopCode。

• 文件路径是否存在或可写。

• 鼠标键盘操作前是否已通过截图确认界面状态。