Transports

Inside a remote server

A remote server is a web service at a URL. You deploy it once, many clients connect over HTTPS, and users sign in with OAuth instead of pasting keys.

Your machine
Deployed anywhere with HTTPS
HTTPS + Bearer token
Claude Codestores and refreshes tokens
MCP serverPOST /mcp
Upstream APIits own credentials
Auth serverOAuth 2.1
connect from Claude Codebash
# Add a remote serverclaude mcp add --transport http \  notion https://mcp.notion.com/mcp # Sign in (OAuth), from the shell or inside a sessionclaude mcp login notion        # or: /mcp
server sidepython
# Serve over Streamable HTTP instead of stdiomcp.run(transport="streamable-http", host="0.0.0.0", port=8000)
  • Sessions are tracked with an Mcp-Session-Id header.
  • The older SSE transport is deprecated: use --transport http.

19 / 28