Next.js DevTools MCP: primeiro descobrir um dev server 16+ local

Para quem serve

Para quem já corre um servidor de desenvolvimento Next.js 16+ e quer que um agente de código (a evidência cita Claude e Cursor) veja erros de runtime, rotas e registos em direto. A evidência afirma: next-devtools-mcp é um conector fino; descobre dev servers Next.js 16+ locais e faz proxy do extremo MCP integrado /_next/mcp.

Já tem de ter Node.js v20.19 ou uma LTS mais recente, mais npm ou pnpm. nextjs_index / nextjs_call também exigem que o servidor de desenvolvimento esteja a correr. Sem um processo Next 16+ em execução, não espere as ferramentas de runtime.

A documentação e os fluxos de migração já não vivem neste servidor: a documentação está em node_modules/next/dist/docs/; upgrade / Cache Components distribuem-se como agent skills.

Concluir a primeira tentativa em 3 minutos

Siga o comando de instalação da página (não tome o JSON manual como segundo caminho principal ao mesmo tempo):

npx add-mcp next-devtools-mcp@latest

Acrescente -y para saltar o aviso e instalar em todos os agentes detetados; -g para instalar globalmente entre projetos. A config de cliente equivalente é npx -y next-devtools-mcp@latest, só para comparar; a primeira tentativa segue add-mcp.

Pré-condições: já tem um projeto Next.js 16+ em local e next dev já corre. Isto vai descobrir o servidor de desenvolvimento local e ler informação de runtime; não é uma sandbox sem rede nem projeto local.

Onde configurar: add-mcp escreve nos clientes MCP detetados; ou manualmente sob mcpServers.next-devtools do cliente.

Primeira chamada de baixo risco: primeiro chame nextjs_index para descobrir dev servers a correr e listar as ferramentas MCP de runtime de cada um. Não chame primeiro nextjs_call para disparar Server Actions. nextjs_docs e browser_eval são portas, não workers que fazem o trabalho.

Sinal de sucesso: nextjs_index lista pelo menos um servidor Next.js 16+ a correr e as respetivas ferramentas de runtime. Se a lista estiver vazia, arranque primeiro o dev server; não mude para automatização de navegador.

Casos de uso

Caso 1: Confirmar se o agente vê o dev server atual. Chame nextjs_index. A evidência garante que descobre servidores a correr e lista as ferramentas MCP de runtime de cada um; não escreve um intervalo de varrimento de portas nem parâmetros de vários projetos. O que pode confirmar: vê os que estão descobertos agora.

Caso 2: Ler erros, rotas ou registos de um servidor já descoberto. Depois de nextjs_index, chame nextjs_call. A evidência indica capacidades de runtime invocáveis: errors, routes, logs, Server Actions. As três primeiras são observacionais; Server Actions pode alterar o estado da aplicação. Da primeira vez, só tire errors/routes/logs; não invoque Server Actions primeiro. nextjs_docs só aponta o agente para node_modules/next/dist/docs/ da versão certa.

Limites de uso

É um proxy, não um sítio de documentação Next completo nem o corpo da automatização de navegador. browser_eval só aponta para a CLI agent-browser. A documentação e a migração já não vivem aqui. As ferramentas de runtime dependem de Next.js 16+ e de um dev server a correr. A evidência não escreve os campos de parâmetros de nextjs_call nem tem caminho para anular Server Actions. Não trate uma consulta de registo só de leitura e disparar Server Actions como o mesmo risco.