Desktop Commander MCP: терминал и файлы для Claude, Codex и ChatGPT

wonderwhy-er/DesktopCommanderMCP· Проверено 13.11.2026· 10,3 тыс.на GitHub

Даёт агенту терминал и файлы вашего компьютера: запускать команды и долгие процессы, искать по коду и точечно править файлы. Excel, PDF и DOCX сервер читает и пишет без сторонних программ.

Как подключить

Что сделать до подключения

1

Node.js 22.12 или новее

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio desktop-commander \
  -- npx -y @wonderwhy-er/desktop-commander@latest

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Собрать вместе с другими серверами в одном mcp.json →

Инструменты сервера

start_processзапускает программу или команду
interact_with_processотправляет команды в процесс
read_process_outputчитает вывод процесса
list_sessionsпоказывает открытые сессии терминала
force_terminateостанавливает сессию терминала
list_processesпоказывает запущенные процессы
kill_processзавершает процесс по PID
read_fileчитает файл, адрес, Excel или PDF
read_multiple_filesчитает несколько файлов сразу
write_fileзаписывает или дописывает файл
write_pdfсоздаёт и правит PDF
edit_blockточечно заменяет текст в файле
list_directoryпоказывает дерево папки
create_directoryсоздаёт папку
move_fileпереносит или переименовывает файл
start_searchищет файлы по имени и содержимому
get_more_search_resultsвыдаёт следующие результаты поиска
get_file_infoпоказывает сведения о файле
get_configпоказывает настройки сервера
set_config_valueменяет настройку сервера

Показано 20 из 25.

Что попросить агента

«Разбери <файл>.csv и покажи главных клиентов»Агент запустит Python через start_process, передаст код interact_with_process и прочитает результат
«Подключись по SSH к <сервер> и проверь место на диске»Агент откроет сессию через start_process, отправит команды interact_with_process и будет держать её открытой
«Запусти Node.js и проверь этот API»Агент поднимет интерактивную сессию Node через start_process и отправит запросы interact_with_process
«Найди в <папка> все вызовы <функция> и замени их на <новая функция>»Агент вызовет start_search, соберёт совпадения get_more_search_results и поправит каждое место edit_block
«Разложи файлы в папке «Загрузки» по типам»Агент просмотрит папку list_directory, создаст папки create_directory и перенесёт файлы move_file

Для каких задач

Запустить сборку, тесты или dev-сервер и следить за выводом
Держать открытой сессию SSH, базы данных или Python и отправлять в неё команды
Найти файлы по имени или содержимому в большом проекте
Заменить кусок кода в файле без переписывания файла целиком
Разобрать CSV или Excel: агент запустит Python в памяти, без сохранения скрипта
Прочитать и изменить Excel, PDF и DOCX

Ограничения

!

Ограничение allowedDirectories действует только на файловые инструменты: команды терминала видят весь диск, а запреты обходятся через симлинки, подстановку команд и абсолютные пути

!

Сервер отправляет псевдонимную телеметрию без содержимого файлов, путей и аргументов команд; отключается настройкой telemetryEnabled: false

!

write_file по умолчанию пишет не больше 50 строк за вызов, длинные файлы агент записывает кусками; порог меняется настройкой fileWriteLineLimit

!

Удалённый режим для ChatGPT и Claude в браузере идёт через сервис Desktop Commander, для него нужен аккаунт

Если не работает

При входе в удалённом режиме браузер не открылся
Откройте адрес проверки вручную и введите код, которые команда remote напечатала в терминале.
Устройство в панели Remote MCP показано как offline
Окно терминала с командой remote должно оставаться открытым. Запустите npx @wonderwhy-er/desktop-commander@latest remote снова: сохранённый вход подхватится.
ChatGPT или Claude не достают до компьютера
Проверьте, что процесс remote запущен, устройство в панели подключено, а коннектор Remote MCP в клиенте не отключён. Для подробного вывода перезапустите с флагом --debug.
Claude Desktop не запускается после удаления сервера
Верните резервную копию конфига, которую сделал remove, или исправьте синтаксис JSON в claude_desktop_config.json.
Установка через Docker сломалась
Сбросьте данные и поставьте заново: запустите install-docker.sh с флагом --reset, затем без флагов.

Частые вопросы

К каким папкам у агента есть доступ?
Папки задаёт настройка allowedDirectories. Пустой список открывает файловым инструментам весь диск, поэтому указывайте конкретные папки. Команды терминала эту настройку не учитывают.
Как запустить сервер изолированно от системы?
Поставьте его через Docker: установщик install-docker.sh или install-docker.ps1 скачает образ, спросит, какие папки подключить, и пропишет сервер в Claude Desktop. Node.js для этого не нужен, нужен запущенный Docker Desktop.
Как отключить телеметрию?
Попросите агента «disable Desktop Commander telemetry» или задайте telemetryEnabled: false через set_config_value. Локальный журнал вызовов в ~/.claude-server-commander от этого не зависит, он не отправляется.
Почему агент пишет файл по частям?
Так работает fileWriteLineLimit: по умолчанию 50 строк за вызов. Мелкие куски экономят токены, и при обрыве ответа сделанная часть сохраняется. Порог поднимается set_config_value, хоть до тысяч строк.
Где менять настройки, чтобы агент их не сбил?
Меняйте конфигурацию в отдельном чате. Наткнувшись на запрет доступа к папке, Claude может сам попытаться поправить allowedDirectories. После правки проверьте результат через get_config.
Что такое Desktop Commander Remote MCP?
Режим для ChatGPT, Claude в браузере и других веб-клиентов. На компьютере работает процесс Remote Device, он связывает машину с сервисом Desktop Commander; команды выполняются у вас, с правами вашего пользователя, и только пока процесс запущен.
Как подключить remote MCP сервер Desktop Commander?
Нужны Node.js 18 или новее и аккаунт Desktop Commander. Выполните npx @wonderwhy-er/desktop-commander@latest remote, подтвердите вход в браузере, сверив код с терминалом, затем откройте mcp.desktopcommander.app и подключите свой ИИ-клиент по инструкции. Ctrl+C отключает компьютер до следующего запуска.
Что открывается по адресу mcp.desktopcommander.app?
Панель Remote MCP: подключение ChatGPT и Claude, список устройств, расход вызовов и тариф. Там же отзывают доступ устройства; с компьютера то же делает команда remote --logout, она ещё и стирает сохранённые ключи.
Как подключить Desktop Commander MCP к Claude Code?
Выполните claude mcp add --scope user desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latest. Без --scope user сервер добавится только в текущий проект. Для Codex: codex mcp add desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latest.
Работает ли сервер из России?
Локальный сервер работает на вашем компьютере без ключей и аккаунтов; для удалённого режима нужен аккаунт Desktop Commander и вход через браузер.

Похожие серверы