Install
npx add-mcp next-devtools-mcp@latestPara quién
Para quien ya ejecuta un servidor de desarrollo Next.js 16+ y quiere que un agente de código (la evidencia cita Claude y Cursor) vea errores de runtime, rutas y registros en vivo. La evidencia indica: next-devtools-mcp es un conector delgado; descubre dev servers Next.js 16+ locales y hace proxy de su extremo MCP integrado /_next/mcp.
Debe tener ya Node.js v20.19 o una LTS más nueva, más npm o pnpm. nextjs_index / nextjs_call también exigen que el servidor de desarrollo esté en marcha. Sin un proceso Next 16+ en ejecución, no espere las herramientas de runtime.
La documentación y los flujos de migración ya no viven en este servidor: la documentación está en node_modules/next/dist/docs/; upgrade / Cache Components se distribuyen como agent skills.
Completar el primer intento en 3 minutos
Siga el comando de instalación de la página (no tome el JSON manual como segunda ruta principal a la vez):
npx add-mcp next-devtools-mcp@latest
Añada -y para saltar el aviso e instalar en todos los agentes detectados; -g para instalar globalmente entre proyectos. La config de cliente equivalente es npx -y next-devtools-mcp@latest, solo para comparar; el primer intento sigue add-mcp.
Condiciones previas: ya tiene un proyecto Next.js 16+ en local y next dev ya corre. Esto descubrirá el servidor de desarrollo local y leerá información de runtime; no es un entorno sin red ni proyecto local.
Dónde configurar: add-mcp escribe en los clientes MCP detectados; o manualmente bajo mcpServers.next-devtools del cliente.
Primera llamada de bajo riesgo: primero llame a nextjs_index para descubrir dev servers en marcha y listar las herramientas MCP de runtime de cada uno. No llame primero a nextjs_call para disparar Server Actions. nextjs_docs y browser_eval son pasarelas, no workers que hacen el trabajo.
Señal de éxito: nextjs_index lista al menos un servidor Next.js 16+ en marcha y sus herramientas de runtime. Si la lista está vacía, arranque primero el dev server; no pase a automatización de navegador.
Casos de uso
Caso 1: Confirmar si el agente ve el dev server actual. Llame a nextjs_index. La evidencia garantiza que descubre servidores en marcha y lista las herramientas MCP de runtime de cada uno; no escribe un rango de barrido de puertos ni parámetros de varios proyectos. Lo que puede confirmar: ve los que están descubiertos ahora.
Caso 2: Leer errores, rutas o registros de un servidor ya descubierto. Tras nextjs_index, llame a nextjs_call. La evidencia indica capacidades de runtime invocables: errors, routes, logs, Server Actions. Las tres primeras son observacionales; Server Actions puede cambiar el estado de la aplicación. La primera vez, solo tome errors/routes/logs; no invoque Server Actions primero. nextjs_docs solo apunta al agente a node_modules/next/dist/docs/ de la versión correcta.
Límites de uso
Es un proxy, no un sitio de documentación Next completo ni el cuerpo de la automatización de navegador. browser_eval solo apunta a la CLI agent-browser. La documentación y la migración ya no viven aquí. Las herramientas de runtime dependen de Next.js 16+ y de un dev server en marcha. La evidencia no escribe los campos de parámetros de nextjs_call ni tiene vía para deshacer Server Actions. No trate una consulta de registro de solo lectura y disparar Server Actions como el mismo riesgo.