{"name":"mcp add","slug":"mcp-add","family":"cli","title":"CLI flags","noun":"CLI flag","description":"After adding or removing a user or local MCP server, Claude Code rereads its config file and fails with an error if the change did not stick","description_source":"entry","described_by":{"version":"2.1.283","anchor":"claude-mcp-addremove-now-re-reads-the-global-config-to-co"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.308","builds":0,"mined_builds":149,"first_cited":null},"aliases":[],"entries":[{"version":"2.1.284","anchor":"managed-policy-can-block-claude-mcp-add-when-strictplugino","heading":"claude mcp add is refused when managed settings allow only plugin MCP servers","line":"If managed settings restrict MCP servers to plugins, `claude mcp add` now stops with an error instead of adding a server that never loads","released_at":"2026-09-28 17:11:59","reason":"named in this entry"},{"version":"2.1.283","anchor":"claude-mcp-addremove-now-re-reads-the-global-config-to-co","heading":"claude mcp add and claude mcp remove now check that the change was saved","line":"After adding or removing a user or local MCP server, Claude Code rereads its config file and fails with an error if the change did not stick","released_at":"2026-09-25 18:46:11","reason":"named in this entry"}],"entries_total":2,"docs":[{"source":"claude-code","path":"best-practices","title":"Best practices for Claude Code","documented":false},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"claude-directory","title":"Explore the .claude directory","documented":false},{"source":"claude-code","path":"cloud-environments","title":"Configure cloud environments","documented":false},{"source":"claude-code","path":"debug-your-config","title":"Debug your configuration","documented":false},{"source":"claude-code","path":"desktop","title":"Desktop application","documented":false},{"source":"claude-code","path":"glossary","title":"Glossary","documented":false},{"source":"claude-code","path":"managed-mcp","title":"Control MCP server access for your organization","documented":false},{"source":"claude-code","path":"mcp","title":"Connect Claude Code to tools via MCP","documented":false},{"source":"claude-code","path":"mcp-quickstart","title":"Connect to MCP servers","documented":false}],"docs_total":12,"gates":[],"related":[{"name":"mcp","slug":"mcp","description":"Internal build versions get trimmed before metrics are sent, so daily builds report one value."},{"name":"mcp add-json","slug":"mcp-add-json","description":null},{"name":"mcp get","slug":"mcp-get","description":"Failed MCP connections now tell you why, with the error detail shown in list and get output."},{"name":"mcp list","slug":"mcp-list","description":"claude mcp list now tells you why a server failed, like a timeout or HTTP error, not just \"Failed to connect\"."},{"name":"mcp login","slug":"mcp-login","description":"When sign-in fails in claude mcp login, Claude Code can now offer a claude.ai link to connect the server there instead"},{"name":"mcp marketplace list","slug":"mcp-marketplace-list","description":"Marketplace listing now also shows claude.ai-hosted marketplaces you haven't added locally, plus browse-only ones."},{"name":"mcp remove","slug":"mcp-remove","description":"claude mcp remove now refuses org-managed servers with an explicit message instead of reporting them as not found."},{"name":"mcp serve","slug":"mcp-serve","description":"Programs connected through `claude mcp serve` can now see and use your subagent types through the Agent tool"},{"name":"mcp status","slug":"mcp-status","description":null}],"url":"https:\/\/changelogs.core-directive.com\/reference\/cli\/mcp-add","family_url":"https:\/\/changelogs.core-directive.com\/reference\/cli.json"}