nextjs-devtools-mcp - Next.js DevTools, ошибки сайта

Что понадобится: Node.js 20.19 или новее; проект на Next.js 16 или новее с запущенным dev-сервером.

Когда звать

• Когда страница на Next.js падает при разработке, а агент чинит по пересказу ошибки и промахивается мимо настоящей причины.
• Когда нужно, чтобы агент сам посмотрел структуру маршрутов проекта и лог dev-сервера, а не просил тебя скопировать их.

Что это

Когда в проекте на Next.js что-то ломается, ошибка видна в окне браузера и в терминале dev-сервера. Агент этого не видит. Он получает от тебя кусок текста и чинит по нему. Часто промахивается: настоящая причина осталась в логе, который ты не скопировал.

Next.js DevTools MCP закрывает эту дыру. Версия 16 сама поднимает встроенную MCP-точку на запущенном dev-сервере, а этот сервер находит её и передаёт агенту. По README автор Vercel называет его «тонким соединителем»: сам он ничего не придумывает, только проксирует то, что уже знает Next.js.

Что агент получает

Четыре инструмента, по README:

• nextjs_index ищет запущенные dev-серверы и перечисляет их встроенные инструменты.
• nextjs_call вызывает один из этих встроенных инструментов: ошибки, логи, маршруты, Server Actions.
• nextjs_docs направляет агента к документации той версии Next.js, что стоит у тебя в проекте. Сам он ничего не качает.
• browser_eval объясняет, как поставить и запускать отдельную программу agent-browser для проверок в браузере. Сам браузером не управляет.

Встроенные инструменты самого Next.js зависят от версии. В README перечислены: текущие ошибки, путь к файлу логов, метаданные страниц и проекта и поиск файла по идентификатору Server Action.

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

Команды из README автора.

В Claude Code:

claude mcp add next-devtools npx next-devtools-mcp@latest

В Codex:

codex mcp add next-devtools -- npx next-devtools-mcp@latest

Потом запусти проект как обычно командой npm run dev и спроси агента: «какие ошибки сейчас в моём приложении на Next.js?». Он вызовет nextjs_index, найдёт сервер и расскажет, что нашёл. Дополнительных настроек README не требует.

Основы подключения серверов к Claude Code разобраны в статье про MCP.

Что учесть

Сервер сам сканирует порты на твоём компьютере. Это его задача, но знать об этом полезно, если на машине одновременно запущено несколько проектов: агент увидит их все и может спросить, к какому подключиться.

Статистика по умолчанию включена. Что в неё попадает, автор описал в README, там же есть переменная для отключения. Если не хочешь отправлять даже имена вызванных инструментов, пропиши её в профиле оболочки.

Ещё один важный момент: в репозитории нет отдельного файла лицензии. MIT указана только в package.json. Для личного использования это не мешает; если собираешься встраивать код в свой продукт, уточни лицензию у автора.

Мы сверили всё с README и package.json на 22 октября 2026 года, сервер не запускали. У репозитория последний коммит от 15 сентября 2026, а последний выпуск на GitHub - 0.4.0 от 24 июня, в package.json уже 0.4.1.