インストール
npx add-mcp next-devtools-mcp@latest誰向けか
Next.js 16+ の開発サーバーをすでに走らせており、コーディングエージェント（証拠の例は Claude と Cursor）にリアルタイムの実行時エラー、ルート、ログを見せたい人向け。証拠は次を述べる：next-devtools-mcp は薄いコネクタであり、このマシンの Next.js 16+ dev server を発見し、組み込み MCP エンドポイント /_next/mcp をプロキシする。
すでに Node.js v20.19 またはより新しい LTS と、npm または pnpm が必要。nextjs_index / nextjs_call は開発サーバーが実行中であることも要求する。動いている Next 16+ プロセスがなければ、ランタイムツールを期待しない。
ドキュメントと移行ワークフローはもうこのサーバーにはない。ドキュメントは node_modules/next/dist/docs/。アップグレード / Cache Components は agent skills として配布される。
3 分で最初の試行を完了する
ページのインストールコマンドに従う（手動 JSON を同時に第二の主経路にしない）：
npx add-mcp next-devtools-mcp@latest
-y を足すとプロンプトを飛ばし、検出された全エージェントに入れる。-g を足すとプロジェクト横断でグローバルインストール。同等のクライアント設定は npx -y next-devtools-mcp@latest で、対照用。最初は add-mcp に従う。
前提条件：このマシンに Next.js 16+ プロジェクトがあり、next dev がすでに走っている。今回はこのマシンの開発サーバーを発見しランタイム情報を読む。ネットワークもローカルプロジェクトもないサンドボックスではない。
設定場所：add-mcp が検出した MCP クライアントに書き込む。またはクライアントの mcpServers.next-devtools に手動で書く。
低リスクな最初の呼び出し：先に nextjs_index を呼び、実行中の dev server を発見し、各々のランタイム MCP ツールを列挙する。先に nextjs_call で Server Actions を起こさない。nextjs_docs と browser_eval はゲートウェイであり、仕事をする worker ではない。
成功シグナル：nextjs_index が少なくとも 1 台の実行中 Next.js 16+ サーバーとそのランタイムツールを列挙する。リストが空なら先に dev server を起こし、ブラウザ自動化へ切り替えない。
使用例
事例 1：エージェントが現在の dev server を見えるか確認する。nextjs_index を呼ぶ。証拠は実行中サーバーを発見し各台のランタイム MCP ツールを列挙すると保証する。ポート走査範囲や複数プロジェクト選択パラメータは書いていない。確認できるのは、今発見されている台を見ることである。
事例 2：すでに発見した 1 台のエラー、ルート、ログを読む。nextjs_index のあと nextjs_call を呼ぶ。証拠は呼べるランタイム能力として errors、routes、logs、Server Actions を挙げる。前三者は観察寄り。Server Actions はアプリ状態を変え得る。最初は errors/routes/logs だけを取り、先に Server Actions を呼ばない。nextjs_docs はエージェントを版に対応する node_modules/next/dist/docs/ へ向けるだけである。
利用上の境界
これはプロキシであり、完全な Next ドキュメントサイトでもブラウザ自動化本体でもない。browser_eval は agent-browser CLI を指すだけ。ドキュメントと移行はこのサーバーに住まない。ランタイムツールは Next.js 16+ かつ dev server 実行中に依存する。証拠は nextjs_call のパラメータ欄を書かず、Server Actions の undo 経路もない。読み取り専用のログ照会と Server Actions の起動を同じリスクにしない。