Unverified Commit 8cb7b04a authored by Aurora Scharff's avatar Aurora Scharff Committed by GitHub

docs: update the MCP guide for next-devtools-mcp 0.4 (#99583)

## Summary

Bring the MCP guide in line with `next-devtools-mcp` 0.4.0 and the
runtime tools on canary.

- describe the four connector tools (`nextjs_index`, `nextjs_call`,
`nextjs_docs`, `browser_eval`) and explain that the docs and browser
tools point the agent elsewhere instead of doing the work
- replace the Playwright MCP integration with `agent-browser`, which
`next-browser` merged into in 16.3
- list the runtime tools at `/_next/mcp` using the descriptions
registered in `packages/next/src/server/mcp/tools`, including the
previously missing `get_request_insights`, and correct `get_errors` (it
does not return type errors) and `get_server_action_by_id` (it does not
inspect component hierarchies)
- add the `npx add-mcp next-devtools-mcp@latest` install option and note
that Skills such as `next-dev-loop` call `/_next/mcp` directly
- rebuild the example transcript with `nextjs_index` and `nextjs_call`,
replacing the removed `nextjs_runtime` tool
- document that the endpoint is enabled by default and can be turned off
with `experimental.mcpServer: false`, and add that to troubleshooting
- remove the "Using with agents" section, which repeated the
capabilities in vaguer terms

Stacked on #99293. Also removes the stale upgrade example, which relied
on the `upgrade_nextjs_16` tool removed in `next-devtools-mcp` 0.4.0.

## Verification

- Tool names and descriptions checked against
`get-or-create-mcp-server.ts` and each tool file on canary
- Connector tools checked against the `next-devtools-mcp` 0.4.0 README
- `mcpServer` default checked in `config-shared.ts`
- Prettier and `alex` pass on the changed file

🤖 Generated with [Claude Code](https://claude.com/claude-code)

<!-- NEXT_JS_LLM -->

---------
Co-authored-by: 's avatarClaude Opus 5.5 <noreply@anthropic.com>
parent d2608c10
This diff is collapsed.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment