SandBase Harness — MCP-сервер для Claude Code: обзор и запуск
Мост по протоколу stdio связывает среду SandBase Harness с ассистентом для управления агентами, сессиями и артефактами. Помогает запускать код в изолированных песочницах.
claude mcp add --env MANAGED_AGENTS_URL=<MANAGED_AGENTS_URL> --env MANAGED_AGENTS_API_KEY=<MANAGED_AGENTS_API_KEY> --transport stdio sandbase-harness -- docker run -i --rm -e MANAGED_AGENTS_URL -e MANAGED_AGENTS_API_KEY ghcr.io/sandbaseai/sandbase-harness-mcp:0.3.8Что делает SandBase Harness
Сервер транслирует запросы ИИ-ассистента в среду SandBase Harness по протоколу stdio. Он открывает управление агентскими сессиями, пошаговыми ходами (turns) и выгрузкой артефактов. Все метаданные локального рантайма сохраняются в SQLite.
Для запуска кода доступны разные изолированные среды: отдельные процессы хоста, контейнеры Docker на сессию, поды Kubernetes или собственные воркеры. Провайдерами моделей могут выступать Anthropic, OpenAI, MiniMax и совместимые с OpenAI API сервисы вроде DeepSeek.
Для работы контейнера моста ghcr.io/sandbaseai/sandbase-harness-mcp:0.3.8 обязательно нужен запущенный Docker. Без предварительно поднятого инстанса Harness и настроенных переменных MANAGED_AGENTS_URL и MANAGED_AGENTS_API_KEY подключение завершится сбоем.
Какие задачи решает
- изолировать выполнение сгенерированного кода в контейнерах Docker или Kubernetes
- управлять жизненным циклом сессий и ходов автономных агентов
- прерывать зависшие задачи и выгружать готовые артефакты
- контролировать политики доступа к инструментам и ключам
Примеры запросов агенту
- Создай новую сессию в SandBase Harness и запусти тестового агента
- Проверь статус текущего хода в агенте и выведи созданные файлы
- Останови выполнение активной задачи в текущей сессии SandBase Harness
Как установить SandBase Harness
Командой платформы
claude mcp add --env MANAGED_AGENTS_URL=<MANAGED_AGENTS_URL> --env MANAGED_AGENTS_API_KEY=<MANAGED_AGENTS_API_KEY> --transport stdio sandbase-harness -- docker run -i --rm -e MANAGED_AGENTS_URL -e MANAGED_AGENTS_API_KEY ghcr.io/sandbaseai/sandbase-harness-mcp:0.3.8Вместо <…> подставьте свои значения
Командой платформы
codex mcp add sandbase-harness --env MANAGED_AGENTS_URL=<MANAGED_AGENTS_URL> --env MANAGED_AGENTS_API_KEY=<MANAGED_AGENTS_API_KEY> -- docker run -i --rm -e MANAGED_AGENTS_URL -e MANAGED_AGENTS_API_KEY ghcr.io/sandbaseai/sandbase-harness-mcp:0.3.8Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"sandbase-harness": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MANAGED_AGENTS_URL",
"-e",
"MANAGED_AGENTS_API_KEY",
"ghcr.io/sandbaseai/sandbase-harness-mcp:0.3.8"
],
"env": {
"MANAGED_AGENTS_URL": "<MANAGED_AGENTS_URL>",
"MANAGED_AGENTS_API_KEY": "<MANAGED_AGENTS_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"sandbase-harness": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MANAGED_AGENTS_URL",
"-e",
"MANAGED_AGENTS_API_KEY",
"ghcr.io/sandbaseai/sandbase-harness-mcp:0.3.8"
],
"env": {
"MANAGED_AGENTS_URL": "<MANAGED_AGENTS_URL>",
"MANAGED_AGENTS_API_KEY": "<MANAGED_AGENTS_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e MANAGED_AGENTS_URL=<MANAGED_AGENTS_URL> -e MANAGED_AGENTS_API_KEY=<MANAGED_AGENTS_API_KEY> sandbase-harness docker run -i --rm -e MANAGED_AGENTS_URL -e MANAGED_AGENTS_API_KEY ghcr.io/sandbaseai/sandbase-harness-mcp:0.3.8Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о SandBase Harness
Как установить SandBase Harness в Claude Code?
Выполните команду `claude mcp add --env MANAGED_AGENTS_URL=<MANAGED_AGENTS_URL> --env MANAGED_AGENTS_API_KEY=<MANAGED_AGENTS_API_KEY> --transport stdio sandbase-harness -- docker run -i --rm -e MANAGED_AGENTS_URL -e MANAGED_AGENTS_API_KEY ghcr.io/sandbaseai/sandbase-harness-mcp:0.3.8`. Подставьте свои значения адреса инстанса и API-ключа.
Что делает SandBase Harness?
Сервер связывает ИИ-клиент с локальной средой управления агентами. Через него ассистент управляет ходами сессий, создаёт артефакты и безопасно исполняет команды в песочницах.
Что нужно подготовить перед запуском сервера?
Понадобится запущенный Docker для развёртывания образа, а также работающий сервис SandBase Harness, адрес которого передаётся в переменной MANAGED_AGENTS_URL.
