协议能力

当前 MCP Server 基于 MCP STDIO 通信，主要面向以下 MCP 能力：

• initialize

• notifications/initialized

• ping

• tools/list

• tools/call

通用参数

所有 AIuse 云电脑 MCP 工具都需要明确目标桌面编码。当前版本通过工具参数传入 desktopCode：

{
  "desktopCode": "xxx"
}

在 Qoder 等支持自然语言工具调用的客户端中，也可以在指令中说明：

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

Computer Use 工具

FileSystem 工具

返回结构

当前 MCP Server 将工具调用结果以文本内容返回，结构如下：

{
  "content": [
    {
      "type": "text",
      "text": "The operation(move_mouse) was successfully executed on the desktop code xxx,the result is ..."
    }
  ]
}

如果业务调用失败，返回文本中会包含失败信息：

{
  "content": [
    {
      "type": "text",
      "text": "The operation(click_mouse) failed on the desktop code xxx,the error message is desktop is offline"
    }
  ]
}

当前版本未承诺返回 structuredContent 或 isError 字段。调用方应以 MCP Client 展示的工具调用结果为准。

错误处理建议

调用方应区分以下两类问题：

• MCP Server 启动或协议层问题：通常表现为 Qoder 中工具列表加载失败、MCP Server 状态异常或工具不可见。

• 业务执行问题：工具已被调用，但因桌面不在线、AccessKey 无权限、参数缺失或文件路径无效导致失败。

排查时建议优先确认：

• CTG_APIKEY 和 CTG_APISECRET 是否正确。

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

• 目标云电脑是否在线。

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

• 文件路径是否存在，或是否具备读写权限。