next-devtools-mcp는 Claude와 Cursor 같은 코딩 에이전트를 실행 중인 Next.js 개발 서버에 연결하는 모델 컨텍스트 프로토콜(MCP) 서버입니다.

이 커넥터는 얇은 커넥터입니다. 16+ 개발 서버를 Next.js 실행 중임을 감지하고, 내장된 MCP 엔드포인트(/_next/mcp)를 프록시하여 에이전트가 실시간 런타임 오류, 경로, 로그를 받을 수 있도록 합니다. 또한 에이전트가 직접 실행하는 도구, 즉 버전 정확 문서와 agent-browser CLI를 연결하는 두 개의 게이트웨이를 제공합니다.

[! 참고] 문서와 마이그레이션 워크플로우는 더 이상 이 서버에 존재하지 않습니다. Next.js 자체 문서를 node_modules/next/dist/docs/에 번들로 제공하며, 업그레이드 및 캐시 컴포넌트 워크플로우는 에이전트 스킬로 배포됩니다. 0.3.x에서의 마이그레이션을 참조하세요.

요구 사항

• Node.js v20.19 또는 최신 LTS 버전
• NPM 또는 PNPM
• Next.js 16+ (nextjs_index / nextjs_call용)

설치

모든 코딩 에이전트에 add-mcp로 설치하세요:

-y을 추가하면 프롬프트를 건너뛰고 모든 감지된 에이전트에 설치하세요. -g을 추가하면 모든 프로젝트에 걸쳐 전역적으로 설치됩니다.

또는 설정을 수동으로 MCP 클라이언트에 추가하세요:

[! 참고] next-devtools-mcp@latest는 클라이언트가 최신 버전을 유지하도록 합니다.

클라이언트별 설정

앰프

Next.js DevTools MCP

next-devtools-mcp is a Model Context Protocol (MCP) server that connects coding agents like Claude and Cursor to your running Next.js dev server.

It is a thin connector. It discovers running Next.js 16+ dev servers and proxies their built-in MCP endpoint (/_next/mcp) so agents get live runtime errors, routes, and logs. It also ships two gateways that point agents at tools they run directly: version-accurate docs and the agent-browser CLI.

[!NOTE] Docs and migration workflows no longer live in this server. Next.js bundles its own docs at node_modules/next/dist/docs/, and upgrade / Cache Components workflows are distributed as agent skills. See Migrating from 0.3.x.

Requirements

• Node.js v20.19 or a newer LTS version
• npm or pnpm
• Next.js 16+ with a running dev server (for nextjs_index / nextjs_call)

Install

Install for all your coding agents with add-mcp:

npx add-mcp next-devtools-mcp@latest

Add -y to skip the prompt and install to all detected agents. Add -g to install globally across all projects.

Or add the config to your MCP client manually:

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

[!NOTE] next-devtools-mcp@latest keeps your client on the latest version.

Client-specific setup