MCP-сервер не появляется в Claude — как починить (2026)
Установил MCP-сервер, а в Claude Desktop или Claude Code его нет? В 9 случаях из 10 это одна из пяти причин. Вот чек-лист.
Если MCP-сервер не появляется в Claude, причина почти всегда одна из пяти, по убыванию частоты: не перезапустил приложение, невалидный JSON, неверная команда, не установлен Node/uv, или сервер упал на старте.
1. Полностью перезапусти клиент
Claude Desktop читает claude_desktop_config.json только при запуске. Закрой его полностью (Cmd+Q на macOS — не просто окно) и открой заново. Claude Code подхватывает claude mcp add сразу, но активной сессии может понадобиться перезагрузка.
2. Проверь JSON
Одна лишняя запятая или незакрытая скобка — и Claude молча пропускает весь файл. Вставь конфиг в любой JSON-валидатор. Файл лежит: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\claude_desktop_config.json (Windows).
3. Запусти команду руками
Скопируй command + args из конфига и выполни в терминале. Если npx -y some-mcp там падает — в Claude он тоже молча не запустится. Так быстро вылезают недостающие пакеты.
4. Убедись, что рантайм установлен
Большинство серверов запускаются через npx (Node.js) или uvx (Python/uv). Если ни того ни другого нет в PATH — сервер не стартует. Поставь Node.js LTS или uv для Python-серверов.
5. Поищи падение
Сервер, который бросает исключение на старте (нет env-переменной, битый токен), исчезает без ошибки в UI. Смотри логи клиента и проверь, что все нужные переменные окружения заданы.
Короткий путь
Почти всё это — от ручной правки JSON. На Unyly кнопка Install записывает валидный конфиг под выбранный клиент, и шаги 2–3 отпадают. Находишь сервер, жмёшь Install, перезапуск, готово.