Zo MCP Server

MCP 伺服器

使用 Zo 的工具與脈絡，為任何相容 MCP 的 AI 注入強大能力

使用 Zo MCP 伺服器，為任何支援 MCP 的 AI 注入 Zo 的工具與脈絡。Zo 提供一個 MCP（模型脈絡協定）端點，因此像 Claude Code、Gemini CLI、Codex 或其他任何相容 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 打造的 CLI 工具。

```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 的 CLI 工具。

```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 生成和編輯圖片