next-devtools-mcp — MCP-сервер для Claude Code: что делает
Подключает агента к запущенному dev-серверу Next.js: ошибки, маршруты и логи прямо из рантайма.
claude mcp add next-devtools-mcp -- npx -y next-devtools-mcpЧто делает next-devtools-mcp
Сервер работает как тонкий коннектор. Он находит запущенные dev-серверы Next.js 16+ и проксирует их встроенную MCP-точку /_next/mcp, поэтому агент видит настоящие ошибки сборки, список маршрутов и вывод сервера, а не догадки по файлам.
Инструментов четыре. nextjs_index сканирует порты и показывает найденные серверы с их рантайм-инструментами, nextjs_call вызывает нужный инструмент на конкретном порту. Ещё два — шлюзы: nextjs_docs указывает агенту на документацию установленной версии в node_modules/next/dist/docs/, browser_eval подсказывает, как поставить и запустить CLI agent-browser для автоматизации браузера. Сами шлюзы работу не делают, они только направляют агента.
Нужен Node.js v20.19 или более новый LTS и npm либо pnpm. Для nextjs_index и nextjs_call обязателен работающий dev-сервер Next.js 16+. Запросы к рантайму, включая чтение тела ответа, обрываются по 60-секундному дедлайну — долгие операции так не вытянуть.
Какие задачи решает
- посмотреть, какие ошибки сейчас в приложении Next.js
- получить список маршрутов и метаданные страниц из работающего сервера
- найти путь к файлу лога dev-сервера
- разрешить ID Server Action в исходный файл
- свериться с документацией именно установленной версии Next.js
Примеры запросов агенту
- Какие ошибки сейчас в моём приложении Next.js?
- Покажи, какие маршруты есть в запущенном dev-сервере
- Что пишется в логах dev-сервера?
Как установить next-devtools-mcp
Командой платформы
claude mcp add next-devtools-mcp -- npx -y next-devtools-mcpКомандой платформы
codex mcp add next-devtools-mcp -- npx -y next-devtools-mcpФайл настроек
{
"mcpServers": {
"next-devtools-mcp": {
"command": "npx",
"args": [
"-y",
"next-devtools-mcp"
]
}
}
}Файл настроек
{
"servers": {
"next-devtools-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"next-devtools-mcp"
]
}
}
}Командой платформы
gemini mcp add next-devtools-mcp npx -y next-devtools-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о next-devtools-mcp
Как установить next-devtools-mcp в Claude Code?
Одна команда: claude mcp add next-devtools-mcp -- npx -y next-devtools-mcp. После этого сервер появится в списке MCP-серверов клиента.
Что делает next-devtools-mcp?
Соединяет кодинг-агента с запущенным dev-сервером Next.js 16+ через его точку /_next/mcp. Агент получает ошибки, маршруты и логи, а также ссылки на документацию установленной версии и на CLI agent-browser.
Что нужно для работы next-devtools-mcp?
Node.js v20.19 или новее из LTS и npm либо pnpm. Рантайм-инструменты nextjs_index и nextjs_call заработают только при запущенном dev-сервере Next.js 16+.
