内置工作空间
使用账户访问设备页面和 AI 对话。第一方浏览器操作使用已登录身份，无需另外创建控制端 Key。
从适合你的接入方式开始。
桌面控制端
使用桌面客户端支持的协议与连接方式。使用 Key 的外部控制端需要获得对应设备组与操作权限。
下载通过 MCP 接入外部 AI
兼容的 Agent 使用 Streamable HTTP 和 Bearer 鉴权连接远程 MCP 服务。可见工具与 Key 允许的操作范围一致。
自定义 API 工作流程
围绕设备发现和限定权限的操作请求构建控制端。按照授权流程接入，而不是直接连接数据节点。
从你的 Agent，到你的设备。
在工作空间创建 Key，配置 MCP 客户端，再从只读检查开始。下方地址对应当前部署。
- MCP 服务地址
https://agentwan.ai/mcp- 传输协议
- Streamable HTTP
- 鉴权方式
- Bearer Key
创建限定范围的 Key
在 MCP 设置中选择允许的设备组与操作。妥善保存仅显示一次的 Key，不要放入共享配置文件。
配置客户端
使用当前部署的 MCP 地址，通过客户端的密钥或环境变量机制提供 Bearer Key，并遵循客户端的远程 MCP 配置说明。
先验证只读操作
先列出可用设备并查看一台设备的信息，再按需要开放写操作。工具缺失时，检查 Key 权限和当前部署已启用的能力。
每类工具，都有明确权限。
以下示例说明 Agent 工具与访问范围的关系，并非完整 API 参考。
| 用途 | 工具示例 | 所需权限 |
|---|---|---|
| 列出可访问的设备 | devices_list | devices.list |
| 读取设备信息 | device_info_read | device.read |
| 查看桌面画面 | desktop_snapshot | desktop.view |
| 读取文本文件 | files_read_text | files.read |
| 打开终端会话 | terminal_open | terminal.open |