[DOCS] `/mcp` documentation omits how to navigate long server lists in the terminal

Documentation Type

Unclear/confusing documentation

Documentation Location

https://code.claude.com/docs/en/mcp

Section/Topic

"Managing your servers" and /mcp panel behavior

Current Documentation

The docs currently say:

Once configured, you can manage your MCP servers with these commands: ``bash # List all configured servers claude mcp list # Get details for a specific server claude mcp get github # Remove a server claude mcp remove github # (within Claude Code) Check server status /mcp ` The /mcp` panel shows the tool count next to each connected server and flags servers that advertise the tools capability but expose no tools.

What's Wrong or Missing?

The page explains that /mcp opens a panel and describes some status information shown there, but it does not explain how to navigate the panel when the server list is longer than the terminal height.

That omission matters because the v2.1.136 release notes specifically call out a fix for /mcp server lists not scrolling when there are more servers than fit in the terminal. Users reading the MCP docs still do not get any guidance that long /mcp lists are scrollable or which keys/input methods work when the panel overflows.

Suggested Improvement

Add a short note near the /mcp panel description that documents overflow behavior for long server lists.

For example, after the current /mcp panel paragraph, add something like:

If your configured server list is longer than the visible terminal area, the /mcp panel is scrollable. Use the arrow keys, PgUp/PgDn, Home/End, or mouse wheel to move through the list, depending on your terminal.

If the supported navigation differs between fullscreen and non-fullscreen mode, document that distinction explicitly.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/mcp | 312-330 | /mcp is documented as a panel for checking server status, but no overflow or scrolling guidance is included |

Related context:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/commands | 62 | /mcp is listed only as "Manage MCP server connections and OAuth authentication" |
| https://code.claude.com/docs/en/fullscreen | 61-84 | Separate fullscreen docs already explain generic scrolling controls such as arrow keys, PgUp/PgDn, Home/End, and mouse wheel |

Total scope: 2 primary docs pages plus fullscreen cross-reference

Relevant release context: v2.1.136 entry "Fixed /mcp server list not scrolling when there are more servers than fit in the terminal"