文档/开发者接入

连接 MCP 客户端

通过标准 MCP 工具让外部 AI 访问获授权的设备，无需自己实现远程连接协议。

更新于 2026-09-094 分钟阅读

本页内容

准备地址与密钥

进入MCP 管理，复制当前部署的 MCP 服务地址，并创建专用 Key。协议为 Streamable HTTP，路径是 /mcp，认证使用 Authorization: Bearer 请求头。

服务地址必须来自你实际使用的工作区部署，不能把官网页面地址或远程设备地址当成 MCP 地址。先阅读访问密钥，只开启必要权限。

在支持远程 HTTP MCP 与 Bearer 认证的客户端中新建连接，填入服务地址，并通过客户端支持的凭据设置传入 Key。若客户端仅支持本地 stdio，不能直接把 HTTP 地址当作本地命令运行。

MCP 管理页还提供可复制的客户端配置。配置中的环境变量名称必须和运行客户端的环境一致；修改环境后，重新启动或重新连接客户端。不要把 Key 直接粘贴进聊天消息。

先让客户端刷新工具列表，再调用 devices_list，确认返回的是你获准访问的设备。工具列表按 Key 的已启用权限生成，缺少写工具不一定是连接失败。

任务	工具示例	权限
列出设备	`devices_list`	`devices.list`
系统信息	`device_info_read`	`device.read`
查看屏幕	`desktop_open`、`desktop_snapshot`	`desktop.view`
操作屏幕	`desktop_action`	`desktop.control`
读取文件	`files_open`、`files_read_text`	`files.read`
修改文件	`files_write_text`	`files.write`
远程终端	`terminal_open`、`terminal_write`	`terminal.open`

具体参数以客户端发现的工具 schema 为准。当前未开放的能力不会因密钥权限选择而变为可用。

桌面先调用 desktop_open，再调用 desktop_snapshot 获取当前画面。坐标动作需携带最新的 frame_id，并按返回图像的像素坐标操作；旧画面被拒绝时重新截图，不要反复重发旧坐标。

文件修改前先读取现有内容，覆盖时携带 expected_sha256。文本和二进制单次正文上限为 1 MiB。终端输入、文件修改和桌面控制会改变目标状态，按宿主客户端的审批规则处理。

会话结束时调用 session_close。远程会话有最长 10 分钟的到期限制，到期后重新打开，不要复用已关闭或其他客户端的会话 ID。

认证失败先检查地址、Key 有效期及是否已撤销。连接成功但看不到设备，检查设备组访问。看得到设备却无法操作，检查具体 scope、在线状态和目标能力。

自定义程序可继续阅读API 与代码示例。通用问题见故障排查。

还需要帮助？

带上遇到的问题和操作步骤，我们会更容易定位。