Follow Discord
Sweep 10 Nov 2026 · 02:18Z Build v2.1.322 539 read Stable v2.1.311 Latest v2.1.322 Next v2.1.322 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.281 ·

Plugin validation now checks a plugin's MCP server files

Plugin validation now checks a plugin's MCP server files for bad settings, insecure addresses and credentials left in plain text

You'll notice Improvements
JSON All of v2.1.281
You'll noticeTier: how much it should matter to you
3Useful: my rating, 1 to 5
1Signal: worth watching, 1 to 5
PluginsArea: what it touches
ImprovementsKind: in v2.1.281,
ImprovementsSection of the release
What

A plugin is an add-on package for Claude Code. Some plugins bring MCP servers, which are external tools Claude can connect to. Plugin validation now also reads the plugin's MCP server files: .mcp.json, plus any ./*.json files that plugin.json lists under mcpServers. It does not follow symlinks (shortcut files that point somewhere else), and it refuses files above a size limit.

It reports these as errors:

It warns about these:

  • http:// or ws:// addresses to any host other than the local machine
  • header values that look like real credentials, matched against known token patterns or by how random the value looks on auth-style headers
  • lists used where settings objects are expected
  • a byte-order mark (BOM, an invisible marker at the start of a file)
  • too many server files
Why

The credential warning says why it matters: everything shipped in a plugin can be read by everyone who installs it. Plugin authors now hear about leaked secrets, unencrypted connections and broken server entries before they publish.

Read from
Names in the bundlemcpServers
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 mcpServers, on Agent SDK reference - TypeScript. * An in-process server you created with [`createSdkMcpServer()`](#createsdkmcpserver), whether you passed it in `mcpServers` or with `setMcpServers()`: disconnecting it and removing its tools requires Claude Code v2.1.286 or later. Disabli… agent-sdk/typescript see the edit
Added since A small documentation edit on Configure permissions touched a line naming mcpServers after this was published. | Inline [`mcpServers`](/docs/en/sub-agents#scope-mcp-servers-to-a-subagent) in the frontmatter of a subagent from the repository or an `--add-dir` directory | Not used, and no dialog is offered | Not used | permissions see the edit
How sure we are
Two sources agreeTwo things we can check say the same as this entry.
Anthropic's documentation agreesA small documentation edit on Configure permissions touched a line naming mcpServers after this was published.
Anthropic's release notes agreeAdded MCP server checks to claude plugin validate: it reports .mcp.json entries that would be silently dropped at load, undeclared…

See this entry in the whole of v2.1.281 →

Feedback