3. Описание MCP-сервера › 3.8 Сервер › remote_exec

Выполняет команду bash на сервере магазина от имени root и возвращает вывод и код завершения.

Право

Прав магазина не требует: доступ даёт окно «Сервер» программы — «Сервер».

Параметры

Параметр	Тип	Что это
`command`	строка	что выполнить: одна команда или целый сценарий, можно в несколько строк
[`timeout`]	целое	через сколько секунд остановить команду, от 1 до 600. По умолчанию 60

Команда выполняется в отдельном запуске bash: переменные и текущая папка одного вызова в следующий не переходят. Поток ошибок приходит вперемешку с выводом, а на вход не приходит ничего, поэтому команда, которая ждёт ввода, сразу получает его конец. Остановленная по таймауту команда завершается с кодом 124.

Размер команды не ограничен: длинный сценарий уходит на сервер файлом в домашнюю папку и удаляется после запуска. Вывод приходит байт в байт, каким его напечатал сервер.

Ответ

Первый блок — JSON, второй — вывод команды, обрезанный до 8000 байт.

{"exit": 0, "bytes": 212, "time": 640, "file": "D:\\Melbis\\shop.example.com\\mcp\\claude-code\\nginx-check\\remote\\exec-20261021-114502-118.txt", "cut": false}

Поле	Что это
`exit`	код завершения команды; `null`, если конец вывода не вернулся
`bytes`	размер всего вывода
`time`	сколько шёл вызов, в миллисекундах
`file`	файл, где лежит весь вывод — в `remote\` папки разговора
`cut`	обрезан ли вывод во втором блоке

Вывод, который не является текстом в UTF-8, во второй блок не попадает и лежит только в файле.

Отказы

Ответ	Когда
`command is required: what bash runs on the server.`	не указана команда
`timeout is a whole number of seconds, 1 to 600.`	`timeout` не целое число или вне диапазона
`The command did not run: <причина>`	соединение оборвалось до ответа

Отказы доступа и подключения — на странице «Сервер».