{"name":"mcpServers","slug":"mcpservers","family":"setting","title":"Settings keys","noun":"settings key","description":"An MCP server literally named __proto__ now warns you instead of silently loading nothing.","description_source":"entry","described_by":{"version":"2.1.219","anchor":"proto-rejected-as-an-mcp-server-name"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.309","builds":0,"mined_builds":150,"first_cited":{"version":"2.1.271","released_at":"2026-09-14 19:45:19","spans":2}},"aliases":[],"entries":[{"version":"2.1.296","anchor":"warning-for-unrecognized-agent-frontmatter-keys-with-did-yo","heading":"Plugin agents now warn about misspelled and unsupported settings","line":"Plugin agent files now log a warning for settings Claude Code does not recognize, suggest the likely intended name, and flag more ignored ones","released_at":"2026-10-09 16:58:10","reason":"found in this entry's text"},{"version":"2.1.290","anchor":"disableclaudeaimcp-setting-explicit-claudeai-proxy-servers","heading":"disableClaudeAiMcp now also blocks claude.ai servers you add yourself","line":"With `disableClaudeAiMcp` set, a claude.ai proxy server passed by `--mcp-config` or the SDK `mcpServers` option no longer connects either","released_at":"2026-10-05 18:12:44","reason":"found in this entry's text"},{"version":"2.1.283","anchor":"claude-plugin-validate-checks-more-manifest-paths-flags-j","heading":"Plugin validation checks more manifest paths","line":"`claude plugin validate` now checks paths for more plugin parts and flags a .json path that is really a folder","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"plugin-validate-mcp-server-paths-inline-servers-and-unquot","heading":"plugin validate: MCP server paths, inline servers and unquoted hook placeholders","line":"`plugin validate` now checks MCP server entries and warns about unquoted placeholders in hook commands","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"plugin-validation-now-checks-a-plugins-mcp-server-files","heading":"Plugin validation now checks a plugin's MCP server files","line":"Plugin validation now checks a plugin's MCP server files for bad settings, insecure addresses and credentials left in plain text","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text, named in this entry"},{"version":"2.1.274","anchor":"mcp-server-add-now-rejects-host-only-transport-types-expli","heading":"MCP server 'add' now rejects host-only transport types explicitly","line":"Adding host-only MCP server types (sdk, sse-ide, ws-ide) via config now fails with a clear error","released_at":"2026-09-16 22:36:09","reason":"found in this entry's text"},{"version":"2.1.271","anchor":"renamed-servers-key-in-mcp-config-now-suggested-without-a","heading":"Renamed 'servers' key in MCP config now suggested without a trailing period","line":"The suggestion to rename a 'servers' key to 'mcpServers' in MCP config now ends without a trailing period","released_at":"2026-09-14 19:45:19","reason":"found in this entry's text"},{"version":"2.1.259","anchor":"managed-settings-can-now-supply-mcp-servers-directly-manag","heading":"Managed settings can now supply MCP servers directly (\"managed\" as a first-class MCP source)","line":"Organizations can push HTTPS MCP servers straight from managed settings; they can't be removed locally and their URLs are masked.","released_at":"2026-09-02 21:21:42","reason":"found in this entry's text"},{"version":"2.1.248","anchor":"bad-crosssessioninbound-values-are-now-named-where-they-surf","heading":"Bad crossSessionInbound values are now named where they surface","line":"A bad crossSessionInbound value is now named directly instead of a generic settings complaint.","released_at":"2026-08-27 20:35:36","reason":"found in this entry's text"},{"version":"2.1.248","anchor":"mcp-server-list-over-the-control-protocol-is-trimmed","heading":"MCP server list over the control protocol is trimmed","line":"SDK and IDE clients now only see MCP server names and status, not full config.","released_at":"2026-08-27 20:35:36","reason":"found in this entry's text"}],"entries_total":17,"docs":[{"source":"api","path":"agents-and-tools\/mcp-connector","title":"mcp-connector","documented":false},{"source":"api","path":"agents-and-tools\/mcp-tunnels\/deploy-helm","title":"deploy-helm","documented":false},{"source":"api","path":"agents-and-tools\/mcp-tunnels\/overview","title":"overview","documented":false},{"source":"api","path":"agents-and-tools\/remote-mcp-servers","title":"remote-mcp-servers","documented":false},{"source":"api","path":"build-with-claude\/mid-conversation-system-messages","title":"mid-conversation-system-messages","documented":false},{"source":"api","path":"managed-agents\/agent-setup","title":"agent-setup","documented":false},{"source":"api","path":"managed-agents\/environments","title":"environments","documented":false},{"source":"api","path":"managed-agents\/github","title":"github","documented":false},{"source":"api","path":"managed-agents\/mcp-connector","title":"mcp-connector","documented":false},{"source":"api","path":"managed-agents\/migration","title":"migration","documented":false}],"docs_total":12,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/mcpservers","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}