--- title: Как установить npx на Windows, macOS и Linux: пошаговая инструкция description: Зачем нужен npx, почему через него запускается большинство MCP-серверов и как поставить его вместе с Node.js на Windows, macOS и Linux. Пошаговая инструкция с проверкой установки. createdAt: 2026-07-11 updatedAt: 2026-07-11 --- Открываете инструкцию к MCP-серверу, а там первой же строкой стоит `npx`. И почти ни слова о том, откуда его взять и как поставить. Разберёмся, что это за штука, почему на ней держится половина MCP-серверов и как поставить её на Windows, macOS и Linux. ## Зачем вообще нужен npx Большинство MCP-серверов написано на JavaScript и лежит в реестре npm. Чтобы клиент (Claude Desktop, Cursor, VS Code) поднял такой сервер, пакет нужно сперва скачать и запустить. Этим `npx` и занимается. В конфиге это выглядит так: ```json { "mcpServers": { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/Documents"] } } } ``` Клиент читает конфиг и выполняет `npx -y @modelcontextprotocol/server-filesystem ...`. `npx` скачивает пакет во временную папку, запускает его и не тянет ничего в глобальные зависимости. Флаг `-y` тут велит не переспрашивать, а поставить пакет молча, если того ещё нет в кэше. Штука удобная: не надо ставить каждый сервер руками и следить за версиями. Обновился пакет в реестре, и при следующем запуске подтянется свежий. Так что без `npx` большинство инструкций по установке MCP-серверов попросту не сработает. Но ставить его отдельно не придётся, и вот почему. ## Что такое npx и откуда он берётся `npx` это спутник `npm`, пакетного менеджера Node.js. А `npm`, в свою очередь, идёт в комплекте с самой Node.js. Цепочка простая: ставите Node.js, вместе с ней получаете `npm`, а с ним и `npx`. Отдельного установщика у `npx` нет, искать его по интернету не нужно. Отсюда и главное правило: **чтобы получить `npx`, ставим Node.js**. Брать лучше LTS-версию (Long Term Support), она стабильнее и её дольше поддерживают. Дальше пройдёмся по установке для каждой системы по очереди. ## Установка на Windows Проще всего через официальный установщик: 1. Зайдите на [nodejs.org](https://nodejs.org) и скачайте LTS-версию (файл `.msi`). 2. Запустите установщик и жмите «Next», ничего не трогая. Галочку «Add to PATH» не снимайте, она и так стоит по умолчанию. 3. Дойдите до конца и нажмите «Install». Любите ставить программы из терминала? Тогда всё сводится к одной команде в PowerShell через пакетный менеджер `winget`: ```powershell winget install OpenJS.NodeJS.LTS ``` После установки закройте терминал (PowerShell или cmd) и откройте заново, открытые окна про новый `PATH` ещё не знают. Потом проверьте, что всё встало: ```powershell node -v npx -v ``` Обе команды должны выдать номер версии. Выдали, значит `npx` готов к работе. ## Установка на macOS На Mac есть два пути. **Официальный установщик.** Скачайте `.pkg`-файл LTS-версии с [nodejs.org](https://nodejs.org), запустите и пройдите установку по шагам. Способ рабочий и ничего сверх этого не требует. **Через Homebrew.** Если у вас стоит пакетный менеджер Homebrew, хватит одной команды в терминале: ```bash brew install node ``` Проверяем результат: ```bash node -v npx -v ``` Обе команды показали версию, всё на месте. А если терминал отвечает `command not found`, закройте его и откройте заново, чтобы подтянулись свежие пути. ## Установка на Linux На Linux вариантов тоже хватает, но удобнее всего nvm (Node Version Manager). Он ставит Node прямо в домашнюю папку, не просит `sudo` и не дерётся с системными пакетами. Сначала ставим сам nvm: ```bash curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash ``` Затем закройте и снова откройте терминал (либо выполните `source ~/.bashrc`) и поставьте LTS-версию Node: ```bash nvm install --lts ``` nvm сам скачает Node, а заодно `npm` и `npx`. Проверяем: ```bash node -v npx -v ``` Версии вывелись, готово. Node можно поставить и через штатный пакетный менеджер дистрибутива (`apt`, `dnf` и им подобные), но там частенько лежит устаревшая версия, которую потом неудобно обновлять. Для MCP-серверов с nvm обычно спокойнее. ## Проверка и что дальше Проверка на любой системе одна и та же: ```bash node -v npx -v ``` Обе команды отвечают номером версии, значит Node.js и `npx` на месте, и можно возвращаться к настройке MCP-сервера. Только обязательно **полностью перезапустите клиент** (Claude Desktop, Cursor, VS Code): не свернуть, а закрыть и открыть заново. Иначе он подтянет старое окружение и `npx` не увидит. ## Клиент не видит npx, хотя он установлен: проблема с PATH Частая ситуация: в терминале `npx -v` честно показывает версию, а клиент всё равно падает с `npx is not recognized` или `command not found`. Значит, установка тут ни при чём, дело в `PATH`. `PATH` это переменная окружения со списком папок, где система ищет исполняемые файлы. Набрали `npx`, и система идёт по списку папка за папкой, пока не наткнётся на нужный файл. Терминал при запуске подгружает ваши настройки (`.zshrc`, `.bashrc` на macOS и Linux, системный `PATH` на Windows), и папка с Node туда попадает, поэтому в терминале `npx` работает. А вот Claude Desktop, Cursor и прочие приложения с графическим интерфейсом стартуют в обход этих настроек, с урезанным `PATH`, где про вашу папку с Node ничего не сказано. Отсюда и `command not found` при живом `npx` в соседнем окне. Лечится в лоб: не заставляйте клиент искать `npx` по имени, пропишите в конфиге полный путь до файла. Узнать путь: ```bash which npx # macOS / Linux where.exe npx # Windows ``` Дальше в конфиге меняете короткое имя на этот путь: ```json "command": "/usr/local/bin/npx" ``` На Windows путь будет вида `"C:\\Program Files\\nodejs\\npx.cmd"`. Тут два нюанса: в JSON обратные слэши обязательно удваиваются, а у файла расширение `.cmd`. После правки снова полностью перезапустите клиент, чтобы он перечитал конфиг. Если Node ставили через nvm, путь будет меняться после каждого `nvm use`, и конфиг придётся поправлять заново. Этот и другие частные случаи подробно разобраны в статье [Ошибки npx при запуске MCP-сервера](/blog/oshibki-npx-pri-zapuske-mcp-servera).