Zo

Servidor MCP

Potencialize qualquer IA compatível com MCP usando as ferramentas e o contexto do Zo

Use o Servidor MCP do Zo para potencializar qualquer IA que suporte MCP com as ferramentas e o contexto do Zo. O Zo expõe um endpoint de MCP (Model Context Protocol), então ferramentas de IA como Claude Code, Gemini CLI, Codex ou qualquer outra ferramenta compatível com MCP podem acessar seu Zo diretamente — seus arquivos, seus aplicativos conectados como Gmail e Google Agenda, e todas as ferramentas do Zo.

Por que usar o Zo como servidor MCP?

O Zo é um servidor Linux completo na nuvem com mais de 50 ferramentas integradas:

• Arquivos e shell — ler, escrever, pesquisar, executar comandos
• Integrações — Gmail, Agenda, Notion, Linear, Airtable, Dropbox, Spotify
• Recursos — navegação na web, geração de imagens, tarefas agendadas, envio de mensagens de texto e e-mails
• Totalmente seu — acesso root, armazenamento persistente, instale o que quiser

Início rápido

1. Vá em Configurações > Avançado e crie um token de acesso
2. Copie-o imediatamente — você não o verá novamente
3. Configure sua ferramenta de IA usando as instruções abaixo

Aviso

Sua chave de API concede acesso total ao seu Zo. Mantenha-a em segredo e nunca a envie para o controle de versão.

Configuração

[Claude Code](https://docs.anthropic.com/en/docs/claude-code) é a ferramenta CLI da Anthropic para Claude.

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

Ou adicione manualmente ao `~/.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) é o aplicativo de desktop da Anthropic para Claude.

Adicione ao seu `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"
      ]
    }
  }
}
```

Local do arquivo de configuração: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) ou `%APPDATA%\Claude\claude_desktop_config.json` (Windows).

[Cursor](https://cursor.com) é um editor de código com tecnologia de IA.

Adicione às configurações de MCP do Cursor (`~/.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) é um editor de código de alto desempenho.

Adicione às configurações do 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) é um agente de codificação de IA de código aberto para o terminal.

Adicione ao seu `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/) é a ferramenta de linha de comando do Google para 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"
```

Ou adicione manualmente ao `~/.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) é a ferramenta CLI da 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
```

Ou adicione manualmente ao `~/.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"]
```

O endpoint MCP do Zo usa transporte HTTP padrão. Para qualquer cliente compatível com MCP, use:

| Configuração | Valor |
| - | - |
| Transporte | HTTP |
| URL | `https://api.zo.computer/mcp` |
| Cabeçalho de autenticação | `Authorization: Bearer zo_sk_your_key_here` |

Se o seu cliente suportar apenas transporte stdio (não HTTP), você pode usar [mcp-remote](https://www.npmjs.com/package/mcp-remote) como ponte. Configure seu cliente para executar este comando:

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

Por exemplo, em uma configuração JSON que espera `command` e `args`:

```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"]
}
```

Ferramentas disponíveis

Todas as ferramentas do Zo são expostas via MCP com recursos idênticos:

Ler, escrever, editar arquivos no seu computador Zo Executar comandos de shell Pesquisar na web, ler páginas, tirar capturas de tela Gerar e editar imagens com IA

Esta documentação é construída e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.