Follow Discord
Sweep 08 Oct 2026 · 18:53Z Build v2.1.295 516 read Stable v2.1.286 Latest v2.1.295 Next v2.1.295 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.295 ·

claude mcp serve gains an HTTP mode and --session-tunnel, limited to cloud-remote sessions

In cloud-remote sessions only, claude mcp serve can run over HTTP, dial a session tunnel, read tokens from a descriptor and return tool output objects

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

What

claude mcp serve runs Claude Code as an MCP server, so another program can use its tools. New options appear only when CLAUDE_CODE_REMOTE is true and CLAUDE_CODE_ENVIRONMENT_KIND is empty; ordinary local installs never see them and stay on stdio with raw results.

  • --transport <transport> (stdio or http, default stdio), --port <port>, --result-format <format> (raw or rendered) and --session-tunnel.
  • With http the server starts listening on the network. --port without http fails with Error: --port only applies to --transport http, and http must come right after claude mcp serve.
  • --session-tunnel needs --transport http and --port 28471, and reads one line of JSON on standard input with session_id, session_token and api_base_url. It dials a tunnel that relays tool calls and exits when the token expires or policy refuses. A bad envelope exits with EX_CONFIG.
  • With --session-tunnel, Claude Code can also read one JSON line from a file descriptor (a numbered input channel) holding oauth_token and agent_proxy_token. A non-empty sign-in token is installed and CLAUDE_CODE_OAUTH_TOKEN_FILE_DESCRIPTOR is cleared.
  • A relay token can come from CCR_AGENT_PROXY_TOKEN_FILE_DESCRIPTOR, refused unless it is a descriptor number of 3 or more and the process has no IPC channel. In a tool container with no session id, the proxy uses that or agent_proxy_token, uses the session id tool-container, and is disabled with a logged message if neither is given.
  • Structured tool output objects are returned only when CLAUDE_CODE_MCP_SERVE_TOOL_OUTPUT is on, with allow and deny rules from CLAUDE_CODE_MCP_SERVE_SETTINGS. Otherwise requests are refused with a message that it is not on.
  • A call can become a request for a person's approval, using anthropic/permissionAsks, anthropic/returnToolOutput and anthropic/toolHostInterface. New served tools include RunMonitorCommand, StageFile and PlaceFiles.
  • As a tool-server daemon, hooks from settings or plugins are dropped with a warning, and in http mode the file watcher does not start. An HTTP hook that cannot be asked on certain events gives a 'Refused, and a retry will be too' message.

Why

This lets remote or hosted setups run Claude Code's tools on a machine through a tunnel. Most users will not see it, since it only appears in cloud-remote sessions.

Read from
Names in the bundleclaude mcp serve--transport
What the documentation says
--transport Recipes modified, high confidence `<target>` below is an [ad-hoc target](/docs/2026-07-28/tools/inspector/configuration#ad-hoc-targets): a positional stdio command, or `--server-url <url> --transport http`. see the edit
--transport TUI client modified, high confidence The TUI also takes the [shared server-selection flags](/docs/2026-07-28/tools/inspector/configuration#shared-server-selection-flags) (`--server-url`, `--transport`, `--header`, `-e`, `--cwd`) plus `--protocol-era` for an ad-hoc server, and… see the edit
--transport Recipes modified, high confidence `<target>` below is an [ad-hoc target](/docs/draft/tools/inspector/configuration#ad-hoc-targets): a positional stdio command, or `--server-url <url> --transport http`. see the edit
--transport TUI client modified, high confidence The TUI also takes the [shared server-selection flags](/docs/draft/tools/inspector/configuration#shared-server-selection-flags) (`--server-url`, `--transport`, `--header`, `-e`, `--cwd`) plus `--protocol-era` for an ad-hoc server, and the … see the edit
How sure we are
Two sources agreeTwo things we can check say the same as this entry.
Anthropic's documentation agrees--transport on Recipes
Anthropic's release notes agreeFixed CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC hiding the Claude apps gateway spend limit in /usage and the status line. The spend limit…

See this entry in the whole of v2.1.295 →

Feedback