docs: reflect feature lifecycle deprecations and the Tasks recategorization#3064
Draft
claude[bot] wants to merge 4 commits into
Draft
docs: reflect feature lifecycle deprecations and the Tasks recategorization#3064claude[bot] wants to merge 4 commits into
claude[bot] wants to merge 4 commits into
Conversation
Tasks moved out of the core protocol into an official extension for the 2026-07-28 release. Point the architecture page at the Tasks extension instead of listing Tasks as an experimental core utility, and group Tasks with MCP Apps as extensions in the SDK tiering page. Co-Authored-By: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016WBaED7Rta4YsYVz66Qoru
The draft spec lets stdio servers write any logging to stderr and tells clients not to assume stderr output indicates errors. Update the two develop guides that still described the Claude Desktop per-server log files as error-only. Co-Authored-By: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016WBaED7Rta4YsYVz66Qoru
The 2026-07-28 draft reclassifies the HTTP+SSE transport as Deprecated under the feature lifecycle policy. Recommend Streamable HTTP on the registry remote-servers page and caveat the SSE-based Spring starters in the build-client and build-server guides, linking the deprecated features registry. Co-Authored-By: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016WBaED7Rta4YsYVz66Qoru
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Den Delimarsky · Slack thread
The architecture page used to list Tasks as an experimental core primitive and now describes it as an optional protocol extension with links to the extension docs. The local-server troubleshooting steps used to say the Claude Desktop log files contain error output from a server, and they now explain that stdio servers may send all of their logging to stderr. The registry guide and the Java client and server guides now note that the HTTP+SSE transport is deprecated and point readers to Streamable HTTP. A follow-up sweep also cleaned up remaining Tasks, SSE transport, and client logging references in the community, roadmap, tutorial, and architecture pages.
Motivation and Context
This bundle is part of preparing the docs for the 2026-07-28 release. The draft specification moved Tasks out of core into the official
io.modelcontextprotocol/tasksextension, but the architecture page still presented Tasks as an experimental core primitive. The spec also describes stderr as a channel stdio servers may use for any logging and marks the HTTP+SSE transport as deprecated, while the troubleshooting and transport guidance still reflected the earlier state.Closes #3036
Closes #3037
Closes #3045
How Has This Been Tested?
Documentation-only change.
npm installsucceeded, a prettier check on the touched files passed, and the fullnpm run check:docspassed (format, js-comments, and mint broken-links reported no broken links).Breaking Changes
None.
Types of changes
Checklist
Additional context
This bundle edits
docs/docs/draft/learn/architecture.mdx, which other rc-high-priority bundle PRs also touch, so merge order may need care.AI assistance disclosure: this PR and its documentation changes were drafted by Claude Code, and the diff receives human review before merge.
Generated by Claude Code