hatchbox — MCP-сервер для Claude Code: что делает и как установить
Управляет деплоями и переменными окружения приложений Rails на хостинге Hatchbox прямо через диалог с ассистентом.
claude mcp add --env HATCHBOX_API_KEY=<HATCHBOX_API_KEY> --env HATCHBOX_ACCOUNT_ID=<HATCHBOX_ACCOUNT_ID> --env HATCHBOX_APP_ID=<HATCHBOX_APP_ID> --env HATCHBOX_DEPLOY_KEY=<HATCHBOX_DEPLOY_KEY> --env WEB_SERVER_IP_ADDRESS=<WEB_SERVER_IP_ADDRESS> --transport stdio hatchbox -- npx -y hatchbox-mcp-serverЧто делает hatchbox
Сервер связывает ассистента с API Hatchbox и сервером приложения по SSH. Инструмент умеет запускать сборку нужного коммита по его хешу SHA, проверять статус текущей выкатки и менять конфигурационные переменные проекта.
По умолчанию включён безопасный режим READONLY. Из-за этого сервер не позволит записать или удалить переменные окружения, пока в настройках не будет выставлен флаг READONLY=false. Чтение переменных работает отдельно через SSH-подключение к веб-серверу, поэтому без указания WEB_SERVER_IP_ADDRESS и рабочего SSH-ключа эти команды останутся недоступными.
Если на одной машине крутится сразу несколько приложений, понадобится переменная HATCHBOX_APP_NAME. Она фильтрует список процессов Puma и не даёт перепутать настройки соседних сервисов.
Какие задачи решает
- Запустить деплой конкретного коммита Rails-приложения
- Посмотреть текущие переменные окружения на сервере через SSH
- Проверить статус активной сборки по activityId
- Обновить или удалить конфигурационные ключи проекта
Примеры запросов агенту
- Покажи значение переменной RAILS_ENV на сервере Hatchbox
- Запусти деплой коммита abc123def456 в Hatchbox и проверь статус
- Удали переменную OLD_VAR из настроек приложения
Как установить hatchbox
Командой платформы
claude mcp add --env HATCHBOX_API_KEY=<HATCHBOX_API_KEY> --env HATCHBOX_ACCOUNT_ID=<HATCHBOX_ACCOUNT_ID> --env HATCHBOX_APP_ID=<HATCHBOX_APP_ID> --env HATCHBOX_DEPLOY_KEY=<HATCHBOX_DEPLOY_KEY> --env WEB_SERVER_IP_ADDRESS=<WEB_SERVER_IP_ADDRESS> --transport stdio hatchbox -- npx -y hatchbox-mcp-serverВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Командой платформы
codex mcp add hatchbox --env HATCHBOX_API_KEY=<HATCHBOX_API_KEY> --env HATCHBOX_ACCOUNT_ID=<HATCHBOX_ACCOUNT_ID> --env HATCHBOX_APP_ID=<HATCHBOX_APP_ID> --env HATCHBOX_DEPLOY_KEY=<HATCHBOX_DEPLOY_KEY> --env WEB_SERVER_IP_ADDRESS=<WEB_SERVER_IP_ADDRESS> -- npx -y hatchbox-mcp-serverВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"hatchbox": {
"command": "npx",
"args": [
"-y",
"hatchbox-mcp-server"
],
"env": {
"HATCHBOX_API_KEY": "<HATCHBOX_API_KEY>",
"HATCHBOX_ACCOUNT_ID": "<HATCHBOX_ACCOUNT_ID>",
"HATCHBOX_APP_ID": "<HATCHBOX_APP_ID>",
"HATCHBOX_DEPLOY_KEY": "<HATCHBOX_DEPLOY_KEY>",
"WEB_SERVER_IP_ADDRESS": "<WEB_SERVER_IP_ADDRESS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"hatchbox": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hatchbox-mcp-server"
],
"env": {
"HATCHBOX_API_KEY": "<HATCHBOX_API_KEY>",
"HATCHBOX_ACCOUNT_ID": "<HATCHBOX_ACCOUNT_ID>",
"HATCHBOX_APP_ID": "<HATCHBOX_APP_ID>",
"HATCHBOX_DEPLOY_KEY": "<HATCHBOX_DEPLOY_KEY>",
"WEB_SERVER_IP_ADDRESS": "<WEB_SERVER_IP_ADDRESS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e HATCHBOX_API_KEY=<HATCHBOX_API_KEY> -e HATCHBOX_ACCOUNT_ID=<HATCHBOX_ACCOUNT_ID> -e HATCHBOX_APP_ID=<HATCHBOX_APP_ID> -e HATCHBOX_DEPLOY_KEY=<HATCHBOX_DEPLOY_KEY> -e WEB_SERVER_IP_ADDRESS=<WEB_SERVER_IP_ADDRESS> hatchbox npx -y hatchbox-mcp-serverВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о hatchbox
Как установить hatchbox в Claude Code?
Выполните команду `claude mcp add hatchbox -e HATCHBOX_API_KEY=<HATCHBOX_API_KEY> -e HATCHBOX_ACCOUNT_ID=<HATCHBOX_ACCOUNT_ID> -e HATCHBOX_APP_ID=<HATCHBOX_APP_ID> -e HATCHBOX_DEPLOY_KEY=<HATCHBOX_DEPLOY_KEY> -- npx -y hatchbox-mcp-server`. Вместо плейсхолдеров подставьте данные из личного кабинета Hatchbox.
Что делает MCP-сервер hatchbox?
Он предоставляет набор инструментов для вызова деплоев, мониторинга их прогресса и чтения или редактирования переменных окружения в приложениях на Hatchbox.
Зачем серверу нужен IP-адрес и SSH-доступ?
Чтение переменных окружения происходит с машины через SSH, а не через панель управления. Без WEB_SERVER_IP_ADDRESS и настроенного ключа команды getEnvVars и getEnvVar работать не смогут.
