Unterm — MCP-сервер для Claude Code: что делает и как установить
Терминал с локальным MCP-сервером: агент открывает панели, гоняет команды и снимает скриншоты. Пригодится, когда несколько агентов работают в одном окне.
Открыть на GitHubЧто делает Unterm
Unterm — терминал для macOS, Linux и Windows, который в каждом окне поднимает локальный MCP-сервер. Агент стучится к нему по TCP и работает с панелями снаружи: открыть оболочку, выполнить команду, прочитать состояние экрана, снять скриншот, записать сессию. Наружу торчат 152 метода плюс auth.login.
Сервер и страница настроек слушают только 127.0.0.1 на автоматически выбранных портах, вход по токену. Каждое запущенное окно пишет свои порты и токен в ~/.unterm/instances/<name>.json, и без этого файла агенту некуда подключаться. Тему, язык и unterm.conf через MCP не поменять — их правят в веб-настройках или через unterm-cli: форму в браузере сделали потому, что сеточный TUI не даёт нормальных полей ввода и предпросмотра.
С версии v0.55 в терминале живёт Agent Cockpit: видно, что делает агент в каждой панели, очередь ждущих ответа открывается по Ctrl+Shift+A, одна задача запускается сразу в нескольких изолированных git-worktree, а страница Review показывает диффы с проверкой, слиянием и откатом. Всем этим тоже можно управлять по MCP, поэтому оркестратор запускает флоты и разбирает диффы без человека за клавиатурой.
Какие задачи решает
- Открыть новую панель и выполнить в ней команду из агента
- Прочитать экран живой сессии, не переключая окно
- Снять скриншот или записать сессию для отчёта
- Прогнать одну задачу в нескольких изолированных worktree и сравнить диффы
- Найти агента, который ждёт ответа, и перейти к его панели
Примеры запросов агенту
- Подключись к окну bravo через файлы в
~/.unterm/instancesи покажи, что сейчас в каждой панели - Запусти
pytestв новой панели и пришли скриншот экрана, когда тест упадёт - Запусти одну задачу в трёх worktree через
unterm-cli fleet launchи открой диффы на ревью
Как установить Unterm
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Unterm
Как установить Unterm в Claude Code?
Unterm ставится как обычное приложение с GitHub Releases: Unterm-macos-<version>.dmg для macOS, unterm-<version>.deb или AppImage для Linux, MSI либо zip для Windows. Дальше каждое окно само поднимает MCP-сервер, и агент подключается к нему по токену из ~/.unterm/instances/<name>.json.
Что делает Unterm?
Даёт ИИ-агенту управлять терминалом снаружи: открывать панели, выполнять команды, читать состояние экрана, снимать скриншоты и записывать сессии. Внутри работает Agent Cockpit — состояние агентов по панелям, очередь ждущих и ревью диффов из изолированных worktree.
Нужен ли облачный аккаунт или ключ API?
Нет. MCP-сервер и сервер настроек живут на 127.0.0.1 на автоматически выбранных портах и проверяют токен, запросы не уходят в облако.
