[DOCS] `/mcp` server list screen-reader focus tracking is fixed in v2.1.200 but never described in MCP docs

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

The "Managing MCP servers" section of mcp.md (around /mcp panel behavior) and the matching --ax-screen-reader / CLAUDE_AX_SCREEN_READER / axScreenReader rows in cli-reference.md, env-vars.md, and settings.md.

Current Documentation

mcp.md:176-178 documents the /mcp panel only in terms of tool counts and capability flags:

The /mcp panel shows the tool count next to each connected server and flags servers that advertise the tools capability but expose no tools.

The screen-reader accessibility settings are documented in three places:

• cli-reference.md:64 — --ax-screen-reader: "Render screen-reader friendly output: flat text without decorative borders or animations."
• env-vars.md:145 — CLAUDE_AX_SCREEN_READER: "Set to 1 to render screen-reader friendly output: flat text without decorative borders or animations."
• settings.md:226 — axScreenReader: "Render screen-reader friendly output: flat text without decorative borders or animations."

None of these descriptions mention the /mcp server list or focus tracking for screen readers and magnifiers.

What's Wrong or Missing?

A. Focus tracking in the /mcp panel is a real surface

The v2.1.200 changelog says:

Fixed /mcp server list not tracking focus for screen readers and magnifiers

Before v2.1.200, opening /mcp in a screen-reader-enabled session did not move the assistive-tech cursor to the server list, so users had to navigate from the prompt manually. After v2.1.200 the focus follows the panel. Neither the MCP reference page nor any of the screen-reader reference rows mention the /mcp panel as a place where focus matters.

B. The screen-reader reference prose is generic

The three screen-reader rows each describe the mode as "flat text without decorative borders or animations". After v2.1.200, the screen-reader mode also routes focus to the active panel (such as /mcp) and keeps it in sync with native cursor tracking. None of that is in the reference prose, so a screen-reader user reading the docs has no way to learn what the mode does beyond the visual flatness.

C. There is no link between the MCP page and the screen-reader docs

The /mcp panel section in mcp.md does not cross-reference axScreenReader or CLAUDE_AX_SCREEN_READER, and the screen-reader docs do not list /mcp as a panel where the mode takes effect. After the v2.1.200 fix, both pages should mention the other.

Suggested Improvement

Update mcp.md to add a short accessibility note under the /mcp description, for example:

{/ min-version: 2.1.200 /}The /mcp panel moves the native terminal cursor to the server list when it opens, so screen readers and magnifiers track the panel's focus without extra navigation. This takes effect whether or not screen-reader mode is enabled.

Update each of the three screen-reader reference rows to expand the description:

axScreenReader — Render screen-reader friendly output: flat text without decorative borders or animations. The native terminal cursor moves to the active panel (such as /mcp) so assistive tools follow focus. …

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/mcp | 176-178 | /mcp panel description |
| https://code.claude.com/docs/en/cli-reference | 64 | --ax-screen-reader row |
| https://code.claude.com/docs/en/env-vars | 145 | CLAUDE_AX_SCREEN_READER row |
| https://code.claude.com/docs/en/settings | 226 | axScreenReader row |

Total scope: 4 pages, all should add the focus-tracking behavior.

The release note for this fix appears in v2.1.200 (July 3, 2026).