Install
npx add-mcp next-devtools-mcp@latestÀ qui s’adresse
Pour celles et ceux qui font déjà tourner un serveur de développement Next.js 16+ et veulent qu’un agent de code (exemples des preuves : Claude et Cursor) voie les erreurs d’exécution, routes et journaux en direct. Les preuves indiquent : next-devtools-mcp est un connecteur mince ; il découvre les dev servers Next.js 16+ locaux et proxifie leur extrémité MCP intégrée /_next/mcp.
Vous devez déjà avoir Node.js v20.19 ou une LTS plus récente, plus npm ou pnpm. nextjs_index / nextjs_call exigent aussi que le serveur de développement tourne. Sans processus Next 16+ en cours, n’attendez pas les outils runtime.
La doc et les workflows de migration ne vivent plus dans ce serveur : la doc est dans node_modules/next/dist/docs/ ; upgrade / Cache Components sont distribués en agent skills.
Réussir le premier essai en 3 minutes
Suivez la commande d’installation de la page (ne prenez pas le JSON manuel comme second chemin principal en même temps) :
npx add-mcp next-devtools-mcp@latest
Ajoutez -y pour sauter l’invite et installer sur tous les agents détectés ; -g pour installer globalement entre projets. La config client équivalente est npx -y next-devtools-mcp@latest, pour comparaison seulement ; le premier essai suit add-mcp.
Préconditions : vous avez déjà un projet Next.js 16+ en local, et next dev tourne déjà. Cela découvrira le serveur de développement local et lira des informations runtime ; ce n’est pas un bac à sable sans réseau ni projet local.
Emplacement de configuration : add-mcp écrit dans les clients MCP détectés ; ou manuellement sous mcpServers.next-devtools du client.
Premier appel à faible risque : d’abord nextjs_index pour découvrir les dev servers en cours et lister leurs outils MCP runtime. N’appelez pas nextjs_call d’abord pour déclencher des Server Actions. nextjs_docs et browser_eval sont des passerelles, pas des workers qui font le travail.
Signal de succès : nextjs_index liste au moins un serveur Next.js 16+ en cours et ses outils runtime. Si la liste est vide, démarrez d’abord le dev server ; ne passez pas à l’automatisation navigateur.
Cas d’usage
Cas 1 : Confirmer que l’agent voit le dev server actuel. Appelez nextjs_index. Les preuves garantissent qu’il découvre les serveurs en cours et liste les outils MCP runtime de chacun ; pas de plage de scan de ports ni de paramètres multi-projets. Ce que vous pouvez confirmer : vous voyez ceux actuellement découverts.
Cas 2 : Lire erreurs, routes ou journaux d’un serveur déjà découvert. Après nextjs_index, appelez nextjs_call. Les preuves indiquent des capacités runtime appelables : errors, routes, logs, Server Actions. Les trois premières sont observationnelles ; les Server Actions peuvent changer l’état de l’application. La première fois, ne prenez que errors/routes/logs ; n’invoquez pas d’abord les Server Actions. nextjs_docs ne fait que pointer l’agent vers node_modules/next/dist/docs/ à la bonne version.
Limites d’usage
C’est un proxy, pas un site de doc Next complet, ni le corps de l’automatisation navigateur. browser_eval ne pointe que vers la CLI agent-browser. La doc et la migration ne vivent plus ici. Les outils runtime dépendent de Next.js 16+ et d’un dev server en cours. Les preuves n’écrivent pas les champs de paramètres de nextjs_call et n’ont pas de chemin d’annulation des Server Actions. Ne traitez pas une requête de journal en lecture seule et le déclenchement de Server Actions au même risque.