ParallelSandbox — MCP-сервер для Claude Code: функции и установка
MCP-сервер подключает агента к Linux-песочнице и даёт инструменты для работы с файлами проекта и логами. Пригодится, чтобы отправить рабочую копию в бокс без коммита.
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Что делает ParallelSandbox
ParallelSandbox предоставляет инструменты sandbox_* и logs_* для удалённого бокса. Через sandbox_sync можно передать файлы проекта в /work/<dest>, а sandbox_pull записывает файлы из бокса на локальную машину. Для синхронизации адаптер должен работать как stdio-сервер: при подключении по HTTP эти две команды завершаются ошибкой.
Для входа можно использовать OAuth или задать PARALLELSANDBOX_API_KEY. При первом входе OAuth открывается браузер; если клиент не обновляет список инструментов после авторизации, подключитесь повторно. В git-проекте синхронизация отправляет отслеживаемые файлы и неигнорируемые новые файлы, но не .git и node_modules. По умолчанию передача свыше 100 MB останавливается, поэтому большие проекты потребуют maxMB.
Какие задачи решает
- передать рабочие файлы в Linux-бокс без коммита
- отправить изменения проекта в
/work/<dest> - забрать файлы из бокса на локальную машину
- проверить логи удалённого бокса
Примеры запросов агенту
- Подключись к ParallelSandbox и отправь проект из
/abs/path/to/repoв бокс, в/work/repo. - Синхронизируй изменения через
sandbox_sync, но сначала покажи, что будет отправлено. - Забери нужные файлы из бокса на мою машину через
sandbox_pull.
Как установить ParallelSandbox
1Командой платформы
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Командой платформы: удалённый сервер
claude mcp add --transport http parallelsandbox https://mcp.parallelsandbox.com/mcp1Командой платформы: удалённый сервер
codex mcp add parallelsandbox --url https://mcp.parallelsandbox.com/mcp2Командой платформы
codex mcp add parallelsandbox --env PARALLELSANDBOX_API_KEY=<PARALLELSANDBOX_API_KEY> --env PSBX_TOOL_TIMEOUT_SEC=<PSBX_TOOL_TIMEOUT_SEC> -- npx -y parallelsandbox-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"parallelsandbox": {
"url": "https://mcp.parallelsandbox.com/mcp"
}
}
}{
"mcpServers": {
"parallelsandbox": {
"command": "npx",
"args": [
"-y",
"parallelsandbox-mcp"
],
"env": {
"PARALLELSANDBOX_API_KEY": "<PARALLELSANDBOX_API_KEY>",
"PSBX_TOOL_TIMEOUT_SEC": "<PSBX_TOOL_TIMEOUT_SEC>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"parallelsandbox": {
"type": "http",
"url": "https://mcp.parallelsandbox.com/mcp"
}
}
}{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http parallelsandbox https://mcp.parallelsandbox.com/mcp2Командой платформы
gemini mcp add -e PARALLELSANDBOX_API_KEY=<PARALLELSANDBOX_API_KEY> -e PSBX_TOOL_TIMEOUT_SEC=<PSBX_TOOL_TIMEOUT_SEC> parallelsandbox npx -y parallelsandbox-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ParallelSandbox
Как установить ParallelSandbox в Claude Code?
Добавьте сервер командой claude mcp add parallelsandbox -e PARALLELSANDBOX_API_KEY=<PARALLELSANDBOX_API_KEY> -- npx -y parallelsandbox-mcp. Подставьте значение API-ключа вместо плейсхолдера.
Что делает ParallelSandbox?
Подключает Claude Code к удалённому боксу и предоставляет инструменты для работы с песочницей и логами. sandbox_sync отправляет туда файлы, а sandbox_pull возвращает файлы на локальную машину.
Работают ли sandbox_sync и sandbox_pull через HTTP?
Нет. Эти команды читают файлы локальной машины, поэтому для них нужен stdio-адаптер.
