Skip to content

SEP: Remote Server Deployment Guidelines#2521

Closed
jeffyaw wants to merge 3 commits into
modelcontextprotocol:mainfrom
jeffyaw:sep/remote-server-deployment-guidelines
Closed

SEP: Remote Server Deployment Guidelines#2521
jeffyaw wants to merge 3 commits into
modelcontextprotocol:mainfrom
jeffyaw:sep/remote-server-deployment-guidelines

Conversation

@jeffyaw

@jeffyaw jeffyaw commented Apr 6, 2026

Copy link
Copy Markdown

Summary

Informational SEP documenting operational guidelines for deploying MCP servers as remote HTTP services, based on production experience running multi-tenant MCP proxy infrastructure.

Covers three areas:

  • Session affinity for stateful servers behind load balancers (addresses Add guidance on session affinity for Mcp-Session-Id in stateful deployments #2064) -- routing via MCP-Session-Id header with a shared key-value store
  • Server discovery via /.well-known/mcp -- opt-in JSON metadata endpoint following RFC 8615 conventions
  • Proxy-layer considerations for Streamable HTTP -- SSE buffering, timeouts, header forwarding, backpressure, SSRF protection

These patterns are running in production at mcp.hosting. The SEP is informational and proposes no protocol changes.

Relevant context

Seeking sponsor

Looking for a Core Maintainer or Maintainer sponsor per the SEP-1850 process. Given the subject matter, tagging the Transports Interest Group maintainers.


After PR number is assigned, I will rename the file from 0000- to {PR#}- and update the header.

jeffyaw added a commit to jeffyaw/modelcontextprotocol that referenced this pull request Apr 6, 2026
Includes generated docs from npm run generate:seps.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@jeffyaw jeffyaw force-pushed the sep/remote-server-deployment-guidelines branch from eff3127 to ef5d5ad Compare April 6, 2026 04:57
@jeffyaw jeffyaw requested review from a team as code owners April 6, 2026 04:57
@localden

localden commented Apr 6, 2026

Copy link
Copy Markdown
Contributor

@jeffyaw there's a few things mixed in here that I would recommend pulling apart and treating as separate contributions. Regarding sessions, there will be changes happening here - would recommend checking with the Transports Working Group on Discord (cc: @kurtisvg @CaitieM20) on the latest here.

Additionally, the server discovery piece is likely its own SEP related to #2127 - that should be your starting point for this work.

Lastly, on the general deployment guidelines, we should have that as a separate article/guideline - that doesn't require a SEP and can move a lot faster since it's just a set of recommendations. If you can pull it into a separate PR and align it with the rest of the docs, we can review it much quicker.

@jeffyaw

jeffyaw commented Apr 6, 2026

Copy link
Copy Markdown
Author

Thank you @localden — this is very helpful. I'll split this into the right pieces:

  1. Sessions — I'll join the Transports Working Group on Discord and share what we've learned about session affinity routing there. Happy to contribute to whatever direction the group takes.

  2. Server discovery — I'll open a separate contribution building on SEP-2127: MCP Server Cards - HTTP Server Discovery via .well-known #2127 rather than proposing a competing approach.

  3. Deployment guidelines — I'll pull the proxy/deployment recommendations into a separate docs PR. That section is purely operational guidance (SSE buffering, timeout config, header forwarding, SSRF protection) so it makes sense outside the SEP process.

I'll close this PR once the docs PR is up. Thanks for the direction.

@dend dend added the documentation Improvements or additions to documentation label Apr 14, 2026
@jeffyaw jeffyaw closed this Apr 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants