Zo MCP Server

MCP 服务器

使用 Zo 的工具和上下文，为任何兼容 MCP 的 AI 赋能

使用 Zo MCP 服务器，为任何支持 MCP 的 AI 提供 Zo 的工具和上下文。Zo 公开了一个 MCP（模型上下文协议）端点，因此像 Claude Code、Gemini CLI、Codex 等 AI 工具，或任何其他兼容 MCP 的工具，都可以直接访问你的 Zo——包括你的文件、你连接的 Gmail 和 Google 日历等应用，以及 Zo 的所有工具。

为什么将 Zo 用作 MCP 服务器？

Zo 是一个完整的云端 Linux 服务器，内置 50 多种工具：

• 文件和 Shell — 读取、写入、搜索、运行命令
• 集成 — Gmail、日历、Notion、Linear、Airtable、Dropbox、Spotify
• 功能 — 网页浏览、图像生成、计划任务、短信、电子邮件
• 完全属于你 — root 访问权限、持久化存储、安装任何你想要的软件

快速开始

1. 前往 设置 > 高级 并创建一个访问令牌
2. 立即复制——你将无法再次查看它
3. 使用以下说明配置你的 AI 工具

你的 API 密钥授予对你的 Zo 的完全访问权限。请妥善保管，切勿将其提交到版本控制中。

配置

[Claude Code](https://docs.anthropic.com/en/docs/claude-code) 是 Anthropic 为 Claude 提供的命令行工具。

```bash theme={null}
claude mcp add --transport http zo https://api.zo.computer/mcp \
  --header "Authorization: Bearer zo_sk_your_key_here"
```

或手动添加到 `~/.claude/settings.json`：

```json theme={null}
{
  "mcpServers": {
    "zo": {
      "type": "http",
      "url": "https://api.zo.computer/mcp",
      "headers": {
        "Authorization": "Bearer zo_sk_your_key_here"
      }
    }
  }
}
```

[Claude Desktop](https://claude.ai/download) 是 Anthropic 为 Claude 提供的桌面应用。

添加到你的 `claude_desktop_config.json`：

```json theme={null}
{
  "mcpServers": {
    "zo": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://api.zo.computer/mcp",
        "--header",
        "Authorization: Bearer zo_sk_your_key_here"
      ]
    }
  }
}
```

配置文件位置：`~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）。

[Cursor](https://cursor.com) 是一款 AI 驱动的代码编辑器。

添加到你的 Cursor MCP 设置（`~/.cursor/mcp.json`）：

```json theme={null}
{
  "mcpServers": {
    "zo": {
      "url": "https://api.zo.computer/mcp",
      "headers": {
        "Authorization": "Bearer zo_sk_your_key_here"
      }
    }
  }
}
```

[Zed](https://zed.dev) 是一款高性能代码编辑器。

添加到你的 Zed 设置（`~/.config/zed/settings.json`）：

```json theme={null}
{
  "context_servers": {
    "zo": {
      "settings": {},
      "url": "https://api.zo.computer/mcp",
      "headers": {
        "Authorization": "Bearer zo_sk_your_key_here"
      }
    }
  }
}
```

[OpenCode](https://opencode.ai) 是一个用于终端的开源 AI 编码代理。

添加到你的 `opencode.json`：

```json theme={null}
{
  "mcp": {
    "zo": {
      "type": "remote",
      "url": "https://api.zo.computer/mcp",
      "headers": {
        "Authorization": "Bearer zo_sk_your_key_here"
      }
    }
  }
}
```

[Gemini CLI](https://geminicli.com/) 是 Google 为 Gemini 提供的命令行工具。

```bash theme={null}
gemini mcp add zo https://api.zo.computer/mcp --transport http --scope user \
  -H "Authorization: Bearer zo_sk_your_key_here"
```

或手动添加到 `~/.gemini/settings.json`：

```json theme={null}
{
  "mcpServers": {
    "zo": {
      "url": "https://api.zo.computer/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer zo_sk_your_key_here"
      }
    }
  }
}
```

[Codex](https://github.com/openai/codex) 是 OpenAI 的命令行工具。

```bash theme={null}
codex mcp add zo -- npx -y mcp-remote https://api.zo.computer/mcp \
  --header "Authorization:Bearer zo_sk_your_key_here" --transport http-only
```

或手动添加到 `~/.codex/config.toml`：

```toml theme={null}
[mcp_servers.zo]
command = "npx"
args = ["-y", "mcp-remote", "https://api.zo.computer/mcp", "--header", "Authorization:Bearer zo_sk_your_key_here", "--transport", "http-only"]
```

Zo 的 MCP 端点使用标准 HTTP 传输。对于任何兼容 MCP 的客户端，请使用：

| 设置       | 值                                         |
| ---------- | ------------------------------------------ |
| 传输方式   | HTTP                                       |
| URL        | `https://api.zo.computer/mcp`               |
| 认证头     | `Authorization: Bearer zo_sk_your_key_here` |

如果你的客户端仅支持 stdio 传输（不支持 HTTP），你可以使用 [mcp-remote](https://www.npmjs.com/package/mcp-remote) 作为桥接。配置你的客户端运行此命令：

```bash theme={null}
npx -y mcp-remote https://api.zo.computer/mcp --header "Authorization:Bearer zo_sk_your_key_here" --transport http-only
```

例如，在需要 `command` 和 `args` 的 JSON 配置中：

```json theme={null}
{
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://api.zo.computer/mcp", "--header", "Authorization:Bearer zo_sk_your_key_here", "--transport", "http-only"]
}
```

可用工具

所有 Zo 工具 都通过 MCP 公开，具有相同的功能：

在你的 Zo 计算机上读取、写入、编辑文件 执行 Shell 命令 搜索网页、阅读页面、截取屏幕截图 使用 AI 生成和编辑图像