[DOCS] Platform MCP Connector documentation missing SSE transport deprecation warning

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://platform.claude.com/docs/en/agents-and-tools/mcp-connector

Section/Topic

The transport configuration sections and code examples throughout the MCP Connector documentation.

Current Documentation

The Platform MCP Connector documentation presents SSE and Streamable HTTP as equally valid options without any deprecation warning:

Line 25:

The server must be publicly exposed through HTTP (supports both Streamable HTTP and SSE transports).

Line 402:

In the sidebar on the left, for "Transport type", select either "SSE" or "Streamable HTTP".

Multiple code examples use SSE URLs without warning:

"url": "https://example-server.modelcontextprotocol.io/sse"

What's Wrong or Missing?

The Claude Code MCP documentation explicitly warns that SSE is deprecated, but the Platform MCP Connector documentation has no such warning.

From code.claude.com/docs/en/mcp (line 263):

<Warning>
  The SSE (Server-Sent Events) transport is deprecated. Use HTTP servers instead, where available.
</Warning>

Impact:

• Users following Platform docs may build new MCP integrations using the deprecated SSE transport
• Inconsistent guidance between Anthropic documentation sources creates confusion
• Future breaking changes will affect users who followed Platform docs without warning
• New users should be guided toward Streamable HTTP, not given SSE as an equal option

Suggested Improvement

1. Add a deprecation warning to the transport section:

<Warning>
  The SSE (Server-Sent Events) transport is deprecated. New MCP server implementations
  should use Streamable HTTP transport. Existing SSE servers will continue to work
  but should migrate to HTTP.
</Warning>

1. Update examples to prioritize Streamable HTTP URLs over SSE URLs

1. In the transport type selection guidance, recommend Streamable HTTP:

In the sidebar on the left, for "Transport type", select "Streamable HTTP" (recommended)
or "SSE" (deprecated).

Impact

High - Prevents users from using a feature

Additional Context

• Claude Code docs with deprecation warning: https://code.claude.com/docs/en/mcp (line 263)
• Platform docs missing warning: https://platform.claude.com/docs/en/agents-and-tools/mcp-connector
• Mirror location: platform.claude.com/docs/en/agents-and-tools/mcp-connector.md
• The Platform docs do document the mcp-client-2025-04-04 version deprecation, so the pattern of adding deprecation notices exists