Zo

官方

Zo 是您在云端的个人氛围服务器,拥有50多种工具和集成。轻松将短信、邮件、日历、研究等功能添加到您的工具包中。

你可以用 Zo MCP 做什么?

  • 读取和写入文件 — 让你的 AI 助手读取、写入或编辑 Zo 电脑上的文件。
  • 运行 Shell 命令 — 让你的助手在 Zo 服务器上执行 bash 命令。
  • 浏览网页 — 通过 Zo 搜索网页、阅读页面并截取屏幕截图。
  • 生成图像 — 让你的助手使用 AI 生成或编辑图像。
  • 使用已连接的应用 — 访问 Gmail、Google Calendar、Notion、Linear、Airtable、Dropbox 和 Spotify 等集成。

文档

MCP 服务器

为任何兼容 MCP 的 AI 提供 Zo 的工具和上下文

使用 Zo MCP Server,为任何支持 MCP 的 AI 提供 Zo 的工具和上下文。Zo 提供一个 MCP(模型上下文协议) 端点,因此 Claude Code、Gemini CLI、Codex 等 AI 工具,以及任何其他兼容 MCP 的工具,都可以直接访问你的 Zo——包括你的文件、已连接的应用(如 Gmail 和 Google Calendar),以及 Zo 的所有工具。

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

Zo 是一台位于云端的完整 Linux 服务器,内置 50 多种工具:

  • 文件和 shell — 读取、写入、搜索文件,运行命令
  • 集成服务 — Gmail、Calendar、Notion、Linear、Airtable、Dropbox、Spotify
  • 功能 — 网页浏览、图像生成、定时任务、短信、电子邮件
  • 完全由你掌控 — root 访问权限、持久化存储,可安装任何你想要的内容

快速开始

  1. 前往 Settings > Advanced 并创建访问令牌
  2. 立即复制令牌——之后将无法再次查看
  3. 按照下方说明配置你的 AI 工具

[!WARNING]

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

配置

[accordion] Claude Code

Claude Code 是 Anthropic 为 Claude 提供的 CLI 工具。

claude mcp add --transport http zo https://api.zo.computer/mcp \
  --header "Authorization: Bearer zo_sk_your_key_here"

或手动将其添加到 ~/.claude/settings.json:

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

[accordion] Claude Desktop

Claude Desktop 是 Anthropic 为 Claude 提供的桌面应用。

添加到你的 claude_desktop_config.json:

{
  "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)。

[accordion] Cursor

Cursor 是一款 AI 驱动的代码编辑器。

添加到 Cursor MCP 设置(~/.cursor/mcp.json):

{
  "mcpServers": {
    "zo": {
      "url": "https://api.zo.computer/mcp",
      "headers": {
        "Authorization": "Bearer zo_sk_your_key_here"
      }
    }
  }
}

[accordion] Zed

Zed 是一款高性能代码编辑器。

添加到 Zed 设置(~/.config/zed/settings.json):

{
  "context_servers": {
    "zo": {
      "settings": {},
      "url": "https://api.zo.computer/mcp",
      "headers": {
        "Authorization": "Bearer zo_sk_your_key_here"
      }
    }
  }
}

[accordion] OpenCode

OpenCode 是一款面向终端的开源 AI 编码代理。

添加到你的 opencode.json:

{
  "mcp": {
    "zo": {
      "type": "remote",
      "url": "https://api.zo.computer/mcp",
      "headers": {
        "Authorization": "Bearer zo_sk_your_key_here"
      }
    }
  }
}

[accordion] Gemini CLI

Gemini CLI 是 Google 为 Gemini 提供的命令行工具。

gemini mcp add zo https://api.zo.computer/mcp --transport http --scope user \
  -H "Authorization: Bearer zo_sk_your_key_here"

或手动将其添加到 ~/.gemini/settings.json:

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

[accordion] Codex

Codex 是 OpenAI 的 CLI 工具。

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:

[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"]

[accordion] 其他 MCP 客户端

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

设置值
传输方式HTTP
URLhttps://api.zo.computer/mcp
身份验证标头Authorization: Bearer zo_sk_your_key_here

如果你的客户端仅支持 stdio 传输(不支持 HTTP),可以使用 mcp-remote 作为桥接工具。将客户端配置为运行以下命令:

npx -y mcp-remote https://api.zo.computer/mcp --header "Authorization:Bearer zo_sk_your_key_here" --transport http-only

例如,在需要 command 和 args 的 JSON 配置中:

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

可用工具

所有 Zo 工具 都通过 MCP 提供,功能完全相同:

[card] 文件操作

在你的 Zo 计算机上读取、写入和编辑文件

[card] Bash 命令

执行 shell 命令

[card] 网页浏览

搜索网页、阅读页面、截取屏幕截图

[card] 图像生成

使用 AI 生成和编辑图像

本文档使用开发者文档平台 Mintlify 构建并托管。