安装
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 列出至少一台正在跑的 Next.js 16+ 服务器及其运行时工具。若列表为空，先把 dev server 拉起来，不要改去浏览器自动化。
使用案例
案例 1：确认代理能不能看见当前 dev server。调用 nextjs_index。证据保证它发现运行中的服务器并列出每台的运行时 MCP 工具，没有写端口扫描范围或多项目选择参数。因此能确认的是：你看到当前被发现的那几台。
案例 2：读取某一台已发现服务器上的错误、路由或日志。在 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 的参数字段，也没有 undo Server Actions 的路径。不要把只读日志查询和触发 Server Actions 当成同一风险。