MCP server management messages now branch on a command-menu surface

Unclear Which surface presents the command menu, and when each wording is shown, is not stated in the finding.

Read from

Names in the bundle/mcp

What the documentation says

/mcp Configure cloud environments modified, high confidence | MCP servers you added with `claude mcp add` at the default local scope or the user scope | No | Those write to `~/.claude.json` on your machine, not the repo. Add the server with `claude mcp add --scope project`, which writes the repo's … see the edit

/mcp Error reference modified, high confidence | `MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)` | [Authentication](#mcp-server-needs-you-to-sign-in-again) | see the edit

/mcp Connect to external tools with MCP modified, high confidence * **With [tool search](/docs/en/agent-sdk/tool-search), the default**: the wait covers still-pending servers configured with [`alwaysLoad: true`](/docs/en/mcp#exempt-a-server-from-deferral) and not the rest. The rest keep connecting in the… see the edit

/mcp Agent SDK reference - TypeScript modified, high confidence * **`plugin`**: a server a [plugin](/docs/en/agent-sdk/plugins) provides. Its `name` is the scoped `plugin:<plugin-name>:<server-name>` form described under [plugin-provided MCP servers](/docs/en/mcp#plugin-provided-mcp-servers). see the edit

/mcp Environment variables modified, high confidence | `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | How long in milliseconds the first turn of a [non-interactive](/docs/en/headless) session waits for MCP servers that are still connecting, in place of the default [first-turn wait](/docs/en/agent-sdk/m… see the edit

/mcp Error reference modified, high confidence | `MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate` | [Authentication](#mcp-server-needs-you-to-sign-in-again) | see the edit

/mcp Run Claude Code programmatically modified, high confidence * `/model`, `/effort`, `/fast`, `/color`, and `/rename` accept the value as an argument, for example `/model sonnet`, and `/mcp` with no argument prints a text summary of server status. These forms require Claude Code v2.1.205 or later and… see the edit

/mcp Control MCP server access for your organization modified, high confidence * In `deniedMcpServers`, `serverName` accepts any non-empty string without leading or trailing whitespace, so you can block [claude.ai connectors](/docs/en/mcp#use-mcp-servers-from-claude-ai) by their display name. For example, `{ "serverN… see the edit

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.

Added since 23 Sep 2026 A small documentation edit on Environment variables touched a line naming /mcp after this was published. | `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Maximum length in characters of each MCP tool description and each MCP server's instructions that Claude Code sends to the model (default: 2048). Claude Code [truncates longer text](/docs/en/mcp… env-vars see the edit

Confirmed since 22 Sep 2026 Anthropic's documentation has since written up /mcp, on CLI reference. | `--mcp-config` | Load MCP servers from JSON files or strings (space-separated). When you pass this flag with `-p`, Claude Code waits for still-pending servers to connect before running the first turn, up to the [`MCP_TIMEOUT`](/docs/en/e… cli-reference see the edit

How sure we are

Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.

The writer flagged doubtWhich surface presents the command menu, and when each wording is shown, is not stated in the finding.

Anthropic's documentation agrees/mcp on Configure cloud environments

Anthropic's release notes agreeFixed a crash ("Type error") when opening /mcp or /plugin manage with a malformed claudeAiMcpEverConnected value in ~/.claude.json

See this entry in the whole of v2.1.277 →