Follow Discord
Sweep 27 Oct 2026 · 19:04Z Build v2.1.312 531 read Stable v2.1.308 Latest v2.1.312 Next v2.1.312 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.312 ·

MCP server settings no longer collect handed_listing values

Claude Code stops reading handed_listing from MCP server settings and --mcp-config entries; only the config, errors and as-written entries remain

Group of 2 Under the hood Internal Changes
JSON All of v2.1.312
Under the hoodTier: how much it should matter to you
1Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
MCPArea: what it touches
Internal ChangesKind: in v2.1.312,
Internal ChangesSection of the release

What

MCP (Model Context Protocol) servers are outside programs that give Claude extra tools. Claude Code no longer picks up a handed_listing value from MCP server settings.

  • The step that expands MCP config now returns only the config, errors and asWrittenEntries. It no longer returns handedListings.
  • Entries passed with --mcp-config, the flag for loading MCP servers from JSON files or strings, no longer have handed listings collected from them. Only asWrittenEntries is kept.
  • A related internal map of as-written entries was removed.

Why

A ready-made listing supplied in the settings is no longer passed along at startup. If your MCP settings include handed_listing, expect it to have no effect.

What the documentation says
--mcp-config Choose a permission mode modified, high confidence * A file you passed to [`--settings`](https://code.claude.com/docs/en/cli-reference#cli-flags), `--mcp-config`, or `--agents` when you started the session see the edit
--mcp-config Best practices for Claude Code modified, high confidence * `--append-system-prompt`, `--mcp-config`, and `--settings` pass in whatever the run *does* need, explicitly. see the edit
--mcp-config Manage Claude Code plugins for your organization modified, medium confidence | `disableSideloadFlags` | Rejects `--plugin-dir`, `--plugin-url`, `--agents`, the Agent SDK `plugins` option, and folders named in the [`CLAUDE_CODE_PLUGIN_DIRS`](https://code.claude.com/docs/en/env-vars#variables) variable at startup, an… see the edit
How sure we are
One source agreesOne thing we can check says the same as this entry.
Anthropic's documentation agrees--mcp-config on Choose a permission mode

See this entry in the whole of v2.1.312 →

Feedback