Агенты MCP

MCP позволяет Codex, Claude Code или Antigravity CLI пользоваться инструментами DR-Terminal. Агент может просматривать сеансы и сохранённые подключения, открывать подключение, читать вывод терминала, вводить команды, передавать файлы и перемещаться по приложению. Режим MCP доступен в течение активного пробного периода и с планом Pro.

Добавление DR-Terminal к агенту

  1. Нажмите MCP в панели заголовка DR-Terminal.
  2. Выберите Add to Codex, Add to Claude или Add to Antigravity. Будет создана пользовательская запись dr-terminal, запускающая bridge из установленного DR-Terminal; ни токен, ни конечная точка не сохраняются в конфигурации клиента. Antigravity 2.0, Antigravity IDE и agy используют одну и ту же запись в ~/.gemini/config/mcp_config.json.
  3. Выберите Открыть или запустите клиент как обычно. При первом подключении DR-Terminal выйдет на передний план и попросит вас выбрать Allow или Отклонить.
  4. Разрешив подключение, вставьте первый промпт и отправьте его.
Покажи мои активные сеансы DR-Terminal.

Выбранный CLI должен быть установлен и доступен в PATH. Установка поддерживается из установленного пакета DR-Terminal; запуск в режиме разработки из Gradle или IDE намеренно не создаёт постоянную запись. Remove удаляет только запись, точно принадлежащую DR-Terminal, и запрашивает подтверждение. Другая существующая запись dr-terminal сообщается как конфликт и никогда не перезаписывается.

Полезные промпты

Когда открыто больше одного сеанса, указывайте его имя или идентификатор. Если агент сообщает, что сеансов нет, откройте подключение в DR-Terminal или сначала попросите агента показать сохранённые подключения.

Подтверждения и индикаторы

Чтение метаданных сеанса и вывода терминала обычно не прерывает вашу работу. Чувствительные действия — ввод текста, нажатие клавиш, передача файлов и отключение — требуют вашего подтверждения.

Когда нужно подтверждение, чип MCP пульсирует, а диалог подтверждения получает фокус клавиатуры. Проверьте целевой сеанс и payload, затем выберите Разрешить один раз, Разрешить для этой сессии или Отклонить. Вкладка затронутого сеанса помечена статическим маркером MCP, пока действие выполняется; цвет чипа показывает глобальное состояние MCP.

Агент никогда не получает пароли и приватные ключи, сохранённые в DR-Terminal. Подтверждение для сеанса действует, только пока активен текущий запуск сервера MCP.

Безопасность локального подключения

Сервер MCP слушает только loopback-интерфейс, поэтому недоступен из сети. Каждый запрос всё равно требует токена bearer, хранящегося в локальном файле, доступном только владельцу. Popover в панели заголовка никогда не показывает и не копирует этот токен.

Конечная точка отображается только в разделе Конечная точка и последние действия для диагностики. Не передавайте файл токена и не копируйте его содержимое в промпты, сообщения чатов, журналы или снимки экрана.

Остановка MCP

Выберите Остановить в popover MCP, чтобы отклонить ожидающее подтверждение, перестать принимать вызовы инструментов и закрыть клиентов, запущенных текущим запуском MCP. Повторный запуск MCP создаёт новый запуск; прежние подтверждения для сеансов не переносятся.

Щелчок по значку MCP лишь открывает popover. Он никогда не запускает сервер неявно. Для ручного запуска используйте явное действие Start MCP; зарегистрированный клиент также может запустить сервер через видимый диалог подтверждения подключения.

Устранение неполадок

CLI не найден

Установите выбранный CLI — Codex, Claude Code или Antigravity (agy) — и убедитесь, что его исполняемый файл доступен в PATH. После изменения окружения оболочки перезапустите DR-Terminal, затем выберите Проверить снова.

Порт уже занят

Настроенный порт MCP использует другой процесс. Остановите этот процесс или выберите другой порт в Настройки → Режим MCP, затем снова запустите MCP.

Нет активного сеанса

Сначала откройте сеанс SSH, Telnet, последовательного порта или локального терминала. Можно также попросить агента показать сохранённые подключения и открыть одно из них после вашего подтверждения.

Клиент работает, но MCP не подтверждён

Процесс CLI запустился, но DR-Terminal ещё не получил вызов инструмента MCP. Проверьте новую вкладку терминала на ошибки входа, конфигурации или рукопожатия (handshake). Затем снова отправьте пример промпта. Состояние запущен описывает локальный процесс, а не подтверждённое подключение MCP.

Диалог ждёт подтверждения

Вернитесь в DR-Terminal и просмотрите диалог с фокусом. Агент не может продолжить это чувствительное действие, пока вы его не разрешите или не отклоните. Остановка MCP отклоняет ожидающий запрос.

Previous
Telnet