Skip to content

docs: add deployment guide for proxying MCP servers#2781

Open
founder-OmniPA wants to merge 4 commits into
modelcontextprotocol:mainfrom
founder-OmniPA:docs/deploy-mcp-behind-proxy
Open

docs: add deployment guide for proxying MCP servers#2781
founder-OmniPA wants to merge 4 commits into
modelcontextprotocol:mainfrom
founder-OmniPA:docs/deploy-mcp-behind-proxy

Conversation

@founder-OmniPA

Copy link
Copy Markdown

Closes #2528

Adds operational guidance for running MCP servers behind reverse proxies and API gateways — SSE buffering, header forwarding, session affinity, SSRF protection, logging, and a pre-production checklist. nginx, Caddy, Traefik, AWS ALB, and Cloudflare examples included. No spec changes.

Closes modelcontextprotocol#2528

Covers the proxy-specific config changes needed for production MCP deployments: required header forwarding (Mcp-Session-Id, Mcp-Protocol-Version, Authorization, Last-Event-ID), SSE buffering disabled, session affinity, connection timeouts, SSRF protection for user-supplied backend URLs, payload logging guidance, and TLS end-to-end recommendations.

Includes config examples for nginx, Caddy, Traefik, AWS ALB, and Cloudflare, plus a summary checklist.
@founder-OmniPA founder-OmniPA requested review from a team as code owners May 23, 2026 15:12
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label May 23, 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.

1 participant