Superserve — MCP-сервер для Claude Code: песочницы Firecracker
Даёт агенту доступ к изолированным микро-VM Firecracker: создать песочницу, выполнить команду, поработать с файлами. Пригодится, когда код надо запускать вне основной машины.
claude mcp add --env SUPERSERVE_API_KEY=<SUPERSERVE_API_KEY> --env SUPERSERVE_BASE_URL=<SUPERSERVE_BASE_URL> --transport stdio mcp -- npx -y @superserve/mcpЧто делает Superserve
Superserve подключается к MCP-клиенту и работает с песочницами Superserve. Локально запускается через npx по stdio, каждый вызов адресует песочницу по id. Есть и удалённый вариант на https://mcp.superserve.ai по Streamable HTTP — тогда локальная установка не нужна, а ключ уходит в заголовке bearer.
Инструментов много: sandbox_create заводит песочницу и возвращает id, sandbox_exec выполняет shell-команду и отдаёт stdout, stderr и код возврата, sandbox_files_read и sandbox_files_write работают с файлами. Отдельно стоит sandbox_computer — он управляет GUI-десктопом: скриншот, мышь, клавиатура, прокрутка, ссылка на живой просмотр. Ещё есть пауза, возобновление, удаление, публикация порта через sandbox_preview_url и аудит исходящих соединений.
Ключ SUPERSERVE_API_KEY клиенты не наследуют из оболочки, его надо прописать в env конфигурации. Удалённый эндпоинт принимает статический bearer, а вот Claude.ai, Custom Connector в Claude Desktop и режим разработчика в ChatGPT ждут OAuth, которого там пока нет. Чтение файла отклоняется, если он больше 1 MiB, а скачивание каталога в ZIP упирается в 10 MiB.
Какие задачи решает
- запустить незнакомый код в изоляции от рабочей машины
- выполнить shell-команду и забрать её вывод
- прочитать или записать файл внутри песочницы
- опубликовать порт и получить ссылку на превью
- посмотреть, куда песочница ходила по сети
Примеры запросов агенту
- Создай песочницу и выполни в ней
npm test - Запиши этот скрипт в файл внутри песочницы и запусти его
- Сделай скриншот десктопа в песочнице и покажи, что на экране
Как установить Superserve
1Командой платформы
claude mcp add --env SUPERSERVE_API_KEY=<SUPERSERVE_API_KEY> --env SUPERSERVE_BASE_URL=<SUPERSERVE_BASE_URL> --transport stdio mcp -- npx -y @superserve/mcpВместо <…> подставьте свои значения
2Командой платформы: удалённый сервер
claude mcp add --transport http mcp https://mcp.superserve.ai1Командой платформы: удалённый сервер
codex mcp add mcp --url https://mcp.superserve.ai2Командой платформы
codex mcp add mcp --env SUPERSERVE_API_KEY=<SUPERSERVE_API_KEY> --env SUPERSERVE_BASE_URL=<SUPERSERVE_BASE_URL> -- npx -y @superserve/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp": {
"url": "https://mcp.superserve.ai"
}
}
}{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@superserve/mcp"
],
"env": {
"SUPERSERVE_API_KEY": "<SUPERSERVE_API_KEY>",
"SUPERSERVE_BASE_URL": "<SUPERSERVE_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.superserve.ai"
}
}
}{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@superserve/mcp"
],
"env": {
"SUPERSERVE_API_KEY": "<SUPERSERVE_API_KEY>",
"SUPERSERVE_BASE_URL": "<SUPERSERVE_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http mcp https://mcp.superserve.ai2Командой платформы
gemini mcp add -e SUPERSERVE_API_KEY=<SUPERSERVE_API_KEY> -e SUPERSERVE_BASE_URL=<SUPERSERVE_BASE_URL> mcp npx -y @superserve/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Superserve
Как установить Superserve в Claude Code?
Добавьте сервер командой claude mcp add mcp -e SUPERSERVE_API_KEY=<SUPERSERVE_API_KEY> -- npx -y @superserve/mcp. Ключ создаётся в консоли Superserve.
Что делает Superserve?
Это MCP-сервер для песочниц Superserve на Firecracker. Через него агент создаёт микро-VM, выполняет в них команды, читает и пишет файлы, управляет GUI-десктопом.
Можно подключить без локальной установки?
Да, есть удалённый эндпоинт https://mcp.superserve.ai по Streamable HTTP. Ключ передаётся как bearer-токен, сервер без состояния и привязан к аккаунту.
