[DOCS] Contradictory instructions: "Option 2" recommends deprecated SSE transport for MCP

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

The Installing MCP servers section, specifically under Option 2: Add a remote SSE server.

Current Documentation

### Option 2: Add a remote SSE server <Warning> The SSE (Server-Sent Events) transport is deprecated. Use HTTP servers instead, where available. </Warning> ``bash theme={null} # Basic syntax claude mcp add --transport sse <name> <url> ... ``

What's Wrong or Missing?

The documentation presents a confusing user experience. It prominently displays a warning that the SSE transport is deprecated, yet immediately presents it as "Option 2" (a primary configuration choice) with copy-pasteable code blocks.

By listing it as a main numbered option alongside the recommended HTTP method, users skimming the document are likely to adopt a deprecated standard despite the warning box.

Suggested Improvement

Do not list the deprecated method as a primary "Option" in the main installation flow.

Recommended Actions:

1. Remove "Option 2" from the main list.
2. Rename "Option 3: Add a local stdio server" to "Option 2".
3. Move the SSE instructions to a collapsible section at the bottom of the page titled "Legacy/Deprecated Configurations" or remove them entirely if the feature is no longer supported.

Impact

High - Prevents users from using a feature

Additional Context

• Users often copy/paste command blocks without reading warning callouts.
• Keeping deprecated patterns as top-level options encourages technical debt for new users setting up their environment for the first time.