docs: make streamable-http the primary transport in examples (#602)
## Summary Changes `streamable-http` to be the recommended and primary transport type in documentation examples, while keeping SSE as a secondary option during the preview period. ## Changes - ✅ Update all primary remote server examples to use `streamable-http` - ✅ Reorder multi-transport examples to show `streamable-http` first - ✅ Add note that SSE is deprecated but still supported during preview - ✅ Update transport protocol requirements text to indicate `streamable-http` (recommended) and `sse` (deprecated) ## Context As noted in issue #487, the docs were using SSE as the primary example despite it being deprecated in the MCP specification (2025-06-18) in favor of streamable HTTP. This PR aligns the documentation with the spec while maintaining backward compatibility information for the preview period. Per maintainer feedback on the issue: - SSE is still supported during the preview phase - Eventually SSE support will be removed - The community would benefit from consistent messaging about the preferred transport ## Files Changed - `docs/guides/publishing/publish-server.md` - Main publishing guide - `docs/reference/server-json/generic-server-json.md` - Reference documentation with examples ## Approach This takes a balanced approach: - Makes streamable-http the clear primary/recommended option - Keeps SSE documented as supported during preview (not hidden) - Adds explicit note about deprecation status - Minimal changes, focused on examples and ordering Fixes #487 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
parent
b04b013246
commit
843783ac18
1 changed files with 16 additions and 16 deletions
|
|
@ -260,8 +260,8 @@ This will essentially instruct the MCP client to execute `dnx Knapcode.SampleMcp
|
|||
"version": "2.0.0",
|
||||
"remotes": [
|
||||
{
|
||||
"type": "sse",
|
||||
"url": "http://mcp-fs.anonymous.modelcontextprotocol.io/sse"
|
||||
"type": "streamable-http",
|
||||
"url": "http://mcp-fs.anonymous.modelcontextprotocol.io/http"
|
||||
}
|
||||
],
|
||||
"_meta": {
|
||||
|
|
@ -531,8 +531,8 @@ The `dnx` tool ships with the .NET 10 SDK, starting with Preview 6.
|
|||
],
|
||||
"remotes": [
|
||||
{
|
||||
"type": "sse",
|
||||
"url": "https://mcp.anonymous.modelcontextprotocol.io/sse",
|
||||
"type": "streamable-http",
|
||||
"url": "https://mcp.anonymous.modelcontextprotocol.io/http",
|
||||
"headers": [
|
||||
{
|
||||
"name": "X-API-Key",
|
||||
|
|
@ -553,8 +553,8 @@ The `dnx` tool ships with the .NET 10 SDK, starting with Preview 6.
|
|||
]
|
||||
},
|
||||
{
|
||||
"type": "streamable-http",
|
||||
"url": "https://mcp.anonymous.modelcontextprotocol.io/http"
|
||||
"type": "sse",
|
||||
"url": "https://mcp.anonymous.modelcontextprotocol.io/sse"
|
||||
}
|
||||
],
|
||||
"_meta": {
|
||||
|
|
|
|||
Loading…
Reference in a new issue