Follow Discord
Sweep 22 Oct 2026 · 04:32Z Build v2.1.308 527 read Stable v2.1.308 Latest v2.1.308 Next v2.1.308 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeReleasesv2.1.302entry #3

Claude Code v2.1.302 ·

MCP serve gains a workspace-root setting for registering a subfolder

CLAUDE_CODE_MCP_SERVE_WORKSPACE_ROOT lets a host running claude mcp serve limit folder registration to a folder below the server's own

Group of 2 Use it now Notable New Features
JSON All of v2.1.302
Use it nowTier: how much it should matter to you
5Useful: my rating, 1 to 5
3Signal: worth watching, 1 to 5
MCPArea: what it touches
New FeaturesKind: in v2.1.302,
What probably matters to youSection of the release

What

claude mcp serve runs Claude Code as an MCP server, a program another application (the host) connects to and drives. A new environment variable, CLAUDE_CODE_MCP_SERVE_WORKSPACE_ROOT, lets the host name a workspace root for it. An environment variable is a setting passed to a program when it starts.

  • It is listed alongside the other CLAUDE_CODE_MCP_SERVE_* variables, such as CLAUDE_CODE_MCP_SERVE_AUTH_TOKEN and CLAUDE_CODE_MCP_SERVE_SETTINGS, and next to CLAUDE_CODE_REMOTE_TOOLS_FORWARD. One of these lists appears to hold sensitive variables and the other variables passed on to child processes.
  • mcp serve in HTTP mode reads the value once and then removes it from its environment.
  • The value must be a valid absolute path, must not be the current folder, and must not overlap a private folder (that refusal is reported as private_folder).
  • A valid root is added as an extra working folder for the tool that registers folders. Registering a folder that is not below that root fails with outside_scope.
  • An invalid value is ignored, with a warning that only a folder below the server's own can be registered.

Why

A host that launches claude mcp serve can now keep a session to one subfolder. Ordinary users who never set the variable see no difference.

Read from
Names in the bundleclaude mcp serve
Since it was published

The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.

Confirmed since Anthropic's documentation has since written up claude mcp serve, on Connect Claude Code to tools via MCP. A `backgroundOutputPath` field in a Bash or PowerShell result from `claude mcp serve` means the call left its command running [in the background](/docs/en/tools-reference#background-commands). A command runs in the background when your cli… mcp see the edit
How sure we are
Two sources agreeTwo things we can check say the same as this entry.
Anthropic's documentation agreesAnthropic's documentation has since written up claude mcp serve, on Connect Claude Code to tools via MCP.
Anthropic's release notes agreeChanged fork subagents (subagent_type: "fork") to be on by default in claude -p, the Agent SDK, the desktop app and VS Code, as they already…

See this entry in the whole of v2.1.302 →

Feedback