Next.js DevTools MCP einrichten

Next.js DevTools MCP verbindet einen Coding-Agenten mit dem eingebauten /_next/mcp-Endpunkt eines lokal laufenden Next.js-16-Dev-Servers. Die Einrichtung dauert wenige Minuten und erfordert kein Konto.

Voraussetzungen prüfen

Der Server setzt Node.js ab Version 20.19 sowie ein Projekt auf Next.js 16 oder neuer voraus. Ältere Next.js-Versionen bieten keinen /_next/mcp-Endpunkt, sodass die Laufzeitwerkzeuge dort nicht funktionieren; ein Upgrade lässt sich später über den Agenten selbst anstoßen.

Server in der .mcp.json eintragen

Im Projektstamm eine .mcp.json-Datei mit folgendem Inhalt anlegen oder ergänzen:

{
  "mcpServers": {
    "next-devtools": {
      "command": "npx",
      "args": ["-y", "next-devtools-mcp@latest"]
    }
  }
}

Wer den Server stattdessen automatisch in allen erkannten Coding-Agenten einrichten möchte, kann alternativ npx add-mcp next-devtools-mcp@latest ausführen.

Entwicklungsserver starten und verbinden

Den gewohnten Next.js-Dev-Server starten, etwa mit npm run dev, pnpm dev, yarn dev oder bun dev. next-devtools-mcp entdeckt den laufenden Prozess automatisch und verbindet sich mit dessen /_next/mcp-Endpunkt; ein manuelles Konfigurieren von Port oder URL ist im Regelfall nicht nötig.

Mit dem Agenten arbeiten

Sobald die Verbindung steht, kann der Agent Fragen wie "Welche Fehler stecken gerade in meiner Anwendung?" oder "Zeig mir alle Routen meines App Routers" direkt beantworten, weil er über die Werkzeuge des Servers auf Live-Fehler, Logs, Routen- und Seitenmetadaten zugreift. Für Upgrades genügt eine Bitte wie "Hilf mir, auf Next.js 16 zu aktualisieren" – der Agent nutzt dafür laut Dokumentation das offizielle Upgrade-Codemod und erläutert Breaking Changes.

Bei Verbindungsproblemen

Verbindet sich der Server nicht, zunächst die installierte Next.js-Version prüfen (mindestens 16), die .mcp.json-Konfiguration kontrollieren, den Dev-Server neu starten, falls er bereits vor der MCP-Einrichtung lief, und sicherstellen, dass der Coding-Agent die MCP-Konfiguration tatsächlich geladen hat.