# ParallelSandbox

MCP-сервер подключает агента к Linux-песочнице и даёт инструменты для работы с файлами проекта и логами. Пригодится, чтобы отправить рабочую копию в бокс без коммита.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: parallel-sandbox
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/parallel-sandbox/parallelsandbox-mcp
- Обновлён: 2026-10-19
- HTML: https://affpapa.org/nevibecode/mcp/parallelsandbox

## Что делает

ParallelSandbox предоставляет инструменты `sandbox_*` и `logs_*` для удалённого бокса. Через `sandbox_sync` можно передать файлы проекта в `/work/<dest>`, а `sandbox_pull` записывает файлы из бокса на локальную машину. Для синхронизации адаптер должен работать как stdio-сервер: при подключении по HTTP эти две команды завершаются ошибкой.

Для входа можно использовать OAuth или задать `PARALLELSANDBOX_API_KEY`. При первом входе OAuth открывается браузер; если клиент не обновляет список инструментов после авторизации, подключитесь повторно. В git-проекте синхронизация отправляет отслеживаемые файлы и неигнорируемые новые файлы, но не `.git` и `node_modules`. По умолчанию передача свыше 100 MB останавливается, поэтому большие проекты потребуют `maxMB`.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.parallelsandbox.com/mcp`
- Переменные окружения: `PARALLELSANDBOX_API_KEY`, `PSBX_TOOL_TIMEOUT_SEC` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы**
```bash
claude mcp add --env PARALLELSANDBOX_API_KEY=<PARALLELSANDBOX_API_KEY> --env PSBX_TOOL_TIMEOUT_SEC=<PSBX_TOOL_TIMEOUT_SEC> --transport stdio parallelsandbox -- npx -y parallelsandbox-mcp
```
Вместо <…> подставьте свои значения

2. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http parallelsandbox https://mcp.parallelsandbox.com/mcp
```

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add parallelsandbox --url https://mcp.parallelsandbox.com/mcp
```

2. **Командой платформы**
```bash
codex mcp add parallelsandbox --env PARALLELSANDBOX_API_KEY=<PARALLELSANDBOX_API_KEY> --env PSBX_TOOL_TIMEOUT_SEC=<PSBX_TOOL_TIMEOUT_SEC> -- npx -y parallelsandbox-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "parallelsandbox": {
            "url": "https://mcp.parallelsandbox.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "parallelsandbox": {
            "command": "npx",
            "args": [
                "-y",
                "parallelsandbox-mcp"
            ],
            "env": {
                "PARALLELSANDBOX_API_KEY": "<PARALLELSANDBOX_API_KEY>",
                "PSBX_TOOL_TIMEOUT_SEC": "<PSBX_TOOL_TIMEOUT_SEC>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "parallelsandbox": {
            "type": "http",
            "url": "https://mcp.parallelsandbox.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "parallelsandbox": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "parallelsandbox-mcp"
            ],
            "env": {
                "PARALLELSANDBOX_API_KEY": "<PARALLELSANDBOX_API_KEY>",
                "PSBX_TOOL_TIMEOUT_SEC": "<PSBX_TOOL_TIMEOUT_SEC>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http parallelsandbox https://mcp.parallelsandbox.com/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e PARALLELSANDBOX_API_KEY=<PARALLELSANDBOX_API_KEY> -e PSBX_TOOL_TIMEOUT_SEC=<PSBX_TOOL_TIMEOUT_SEC> parallelsandbox npx -y parallelsandbox-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- передать рабочие файлы в Linux-бокс без коммита
- отправить изменения проекта в `/work/<dest>`
- забрать файлы из бокса на локальную машину
- проверить логи удалённого бокса

## Примеры запросов агенту
- Подключись к ParallelSandbox и отправь проект из `/abs/path/to/repo` в бокс, в `/work/repo`.
- Синхронизируй изменения через `sandbox_sync`, но сначала покажи, что будет отправлено.
- Забери нужные файлы из бокса на мою машину через `sandbox_pull`.

## Похожие
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33989
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81163
- [Oh My Posh Validator](https://affpapa.org/nevibecode/mcp/oh-my-posh-validator.md) — MCP-сервер · ★ 23654
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18779
- [Coder](https://affpapa.org/nevibecode/mcp/coder.md) — MCP-сервер · ★ 17191
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12110

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md