> ## 文档索引
> 获取完整文档索引： https://fushouagent.com/docs/llms.txt
> 先阅读此索引，了解所有可用页面。

# computer mcp

> 将当前电脑的原生桌面操作能力作为本地 MCP 服务提供给兼容客户端。

`fushou-agent computer mcp` 启动本地 MCP 服务，让兼容的 MCP 客户端操作运行命令的电脑。该进程由 MCP 客户端通过标准输入输出管理。首次工具调用前需通过 `fushou-agent login` 登录，登录过期后请重新登录。

## 收费与连接要求

MCP 与 RPA 脚本执行共用分钟单价，标准价为 0.1 元/分钟。首次工具调用前检查登录与余额并预扣一分钟费用，随后 60 秒内的调用共用付费窗口；满一分钟后的下一次调用重新检查并扣费。仅启动、发现工具或保持空闲不产生费用。首次扣费后即使使用不足一分钟、退出进程或工具执行失败，已扣费用也不退还。多个 MCP 进程分别计费。

限时免费：截至 2026 年 12 月 31 日，此功能免费；之后恢复标准价格 0.1 元/分钟。当前实际价格以[价格页面](/pricing)为准。

调用需要连接赋手智能体服务器。登录失效时提示重新登录；余额为负时提示充值，充值后再次调用可恢复。计费接口失败时工具调用会失败，请检查网络后重试。重新登录或充值后，未到期的同账号付费窗口可以继续使用。

## 命令格式

```bash title="Terminal"
fushou-agent computer mcp
```

命令不接受其他参数。进程会持续运行，直到 MCP 客户端关闭连接或终止进程。

## MCP 客户端配置

将 `<FUSHOU_AGENT_BIN>` 替换为 `fushou-agent` 可执行文件的绝对路径：

```json title="mcp.json"
{
  "mcpServers": {
    "fushou-agent-computer": {
      "type": "stdio",
      "command": "<FUSHOU_AGENT_BIN>",
      "args": ["computer", "mcp"]
    }
  }
}
```

MCP 客户端启动后会自动发现当前版本提供的工具。命令必须独占标准输入和标准输出，不要在外层脚本中向 stdout 写入额外内容。

## 可用工具

当前版本提供以下 16 个工具。工具参数由 MCP 客户端自动获取；涉及界面位置的操作应以最近一次 `get_app_state` 返回的截图和元素状态为准。

| 工具 | 用途 |
| --- | --- |
| `read` | 通过绝对路径读取运行客户端电脑上的本地文本文件或 PNG/JPEG 图片。 |
| `bash` | 在运行客户端的电脑上执行本地 shell 命令，可指定工作目录和超时时间。 |
| `get_app_state` | 获取指定应用关键窗口的截图和可操作元素状态，供后续界面操作定位。 |
| `list_apps` | 列出可操作的图形界面应用，以及 `launch_app` 接受的应用名称、路径或平台标识。 |
| `wait` | 等待指定时间，让界面完成加载或恢复为可操作状态。 |
| `launch_app` | 启动尚未运行的应用；应用已经运行时返回成功，但不会改变当前前台窗口。 |
| `bring_to_front` | 将已经运行的应用窗口切换到前台；不会启动应用。 |
| `set_window_bounds` | 将应用切换到前台，并以屏幕像素设置其主窗口的位置和大小。 |
| `click` | 按元素编号或截图坐标点击，可设置点击次数和鼠标按键。 |
| `drag` | 在两个坐标点之间拖动对象、滑块、分隔条或选择手柄；普通页面滚动应使用 `scroll`。 |
| `press_key` | 按下单个键或组合键，包括修饰键和导航键。 |
| `scroll` | 从指定位置按上、下、左、右方向滚动页面、列表或可滚动区域。 |
| `select_text` | 选择元素中的指定文本，或将光标放在文本之前或之后。 |
| `set_value` | 为支持赋值的界面元素设置值。 |
| `type_text` | 通过键盘输入原样文本。 |
| `perform_secondary_action` | 执行界面元素提供的辅助操作。 |

## 系统权限

- macOS 需要为 `fushou-agent` 及其宿主 MCP 客户端授予辅助功能和屏幕录制权限。
- Windows 不需要额外驱动。
- Linux 支持 Ubuntu Desktop 24.04 x86_64 的 GNOME Wayland 图形会话，不支持 Xorg、WSL、无头会话或 ARM64。

## 常见错误

- MCP 客户端立即报告服务退出：在终端直接运行相同命令，查看 stderr 中的错误信息。
- 客户端配置找不到命令：将 `command` 改为可执行文件绝对路径。
- macOS 工具无法读取窗口：确认宿主 MCP 客户端和 `fushou-agent` 都具备所需权限。

## 相关主题

- [computer exec](/docs/client/computer/exec.md)
- [computer rpa exec](/docs/client/computer/rpa/exec.md)
- [客户端授权管理](/docs/console/client-authorizations.md)