Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [DOCS] `/mcp` documentation omits how to navigate long server lists in the terminal

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Root Cause

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.

Code Example

> # 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
>
RAW_BUFFERClick to expand / collapse

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:

# 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:

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

Related context:

PageLine(s)Context
https://code.claude.com/docs/en/commands62/mcp is listed only as "Manage MCP server connections and OAuth authentication"
https://code.claude.com/docs/en/fullscreen61-84Separate 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"

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#ISR setup#authentication setup#request error#file not found#serialization error

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [DOCS] `/mcp` documentation omits how to navigate long server lists in the terminal