Helmdeck — MCP-сервер для Claude Code: песочница, браузер, код
Self-hosted MCP-сервер с наборами capability packs: браузер, десктоп, работа с кодом и документами. Пригодится, если агент должен работать на локальной модели или внутри своего контура.
claude mcp add helmdeck -e HELMDECK_URL=<HELMDECK_URL> -e HELMDECK_TOKEN=<HELMDECK_TOKEN> -- npx -y @helmdeck/mcp-bridgeЧто делает Helmdeck
Helmdeck — это разворачиваемая у себя платформа, которая отдаёт агенту готовые типизированные JSON-вызовы вместо открытых интерфейсов. Каждый такой вызов — capability pack: браузер, десктоп, git, правка кода, разбор PDF. Мелкая модель заполняет контракт пака, а не изобретает шаги заново.
Ставится одной командой: ./scripts/install.sh поднимает Compose-стек, собирает Management UI, Go-бинарники и образ браузерного сайдкара, печатает адрес и сгенерированный пароль администратора. Скрипт заранее проверяет docker, node ≥20, go ≥1.26, make, openssl и curl. Без docker в системе установка просто не пойдёт. Есть флаги --reset и --no-build.
Дальше стек надо подключить к клиенту — сам по себе он ничего не делает. Для Claude мост запускается через npx -y @helmdeck/mcp-bridge, а в переменных окружения передаются HELMDECK_URL и HELMDECK_TOKEN. В бинарной сборке заявлено 57 паков, 21 встроенный pipeline и маркетплейс паков.
Какие задачи решает
- дать агенту браузер и десктоп без выхода за периметр
- запустить цикл правки кода на локальной модели
- разобрать PDF в структурированный Markdown
- подключить агента к SaaS, не отдавая ему пароли
- собрать многошаговый план из одного запроса
Примеры запросов агенту
- Подбери пак под задачу: нужно скачать страницу и оставить комментарий в GitHub
- Разложи запрос на шаги через
helmdeck.planи покажи план - Сохрани в память, что я работаю в ветке
release/1.2
Как установить Helmdeck
Командой платформы
claude mcp add helmdeck -e HELMDECK_URL=<HELMDECK_URL> -e HELMDECK_TOKEN=<HELMDECK_TOKEN> -- npx -y @helmdeck/mcp-bridgeВместо <…> подставьте свои значения
Командой платформы
codex mcp add helmdeck --env HELMDECK_URL=<HELMDECK_URL> --env HELMDECK_TOKEN=<HELMDECK_TOKEN> -- npx -y @helmdeck/mcp-bridgeВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"helmdeck": {
"command": "npx",
"args": [
"-y",
"@helmdeck/mcp-bridge"
],
"env": {
"HELMDECK_URL": "<HELMDECK_URL>",
"HELMDECK_TOKEN": "<HELMDECK_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"helmdeck": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@helmdeck/mcp-bridge"
],
"env": {
"HELMDECK_URL": "<HELMDECK_URL>",
"HELMDECK_TOKEN": "<HELMDECK_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e HELMDECK_URL=<HELMDECK_URL> -e HELMDECK_TOKEN=<HELMDECK_TOKEN> helmdeck npx -y @helmdeck/mcp-bridgeВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Helmdeck
Как установить Helmdeck в Claude Code?
Сначала поднимите сам стек: git clone https://github.com/tosin2013/helmdeck, затем cd helmdeck и ./scripts/install.sh. После этого подключите мост командой claude mcp add helmdeck -e HELMDECK_URL=<HELMDECK_URL> -e HELMDECK_TOKEN=<HELMDECK_TOKEN> -- npx -y @helmdeck/mcp-bridge.
Что делает Helmdeck?
Отдаёт агенту наборы capability packs — типизированные JSON-вызовы для браузера, десктопа, git, правки кода и разбора документов. Плюс мета-паки для маршрутизации, планирования и памяти.
Что нужно для работы Helmdeck?
Установщик проверяет docker, node ≥20, go ≥1.26, make, openssl и curl. Для подключения клиента нужны адрес стека и токен — они уходят в HELMDECK_URL и HELMDECK_TOKEN.
