Skip to main content
reopt Handbook
reopt Handbook
Claude Code Command MasterLabels and command selectionHow to read a detail guideComplete command listTerminal CLI Commands and Flags

Task guides

Core command basicsStarting and resuming workSkills and Custom CommandsAutomation and Web CommandsOperations and Safety CommandsCustom commands and skillsMCP connections and commands

Conversation and context

Cmd. /add-dirCmd. /backgroundCmd. /compactCmd. /contextCmd. /copyCmd. /exportCmd. /forkCmd. /importCmd. /initCmd. /memoryCmd. /recapCmd. /renameCmd. /resumeCmd. /rewindCmd. claude purge

Planning and execution

Cmd. /autofix-prCmd. /batchCmd. /desktopCmd. /goalCmd. /loopCmd. /planCmd. /remote-envCmd. /scheduleCmd. /tasksCmd. /teleportCmd. /workflows

Review and verification

Cmd. /code-reviewCmd. /runCmd. /run-skill-generatorCmd. /security-reviewCmd. /simplifyCmd. /verify

Models and settings

Cmd. /claude-apiCmd. /configCmd. /effortCmd. /fastCmd. /modelCmd. /output-styleCmd. /update-config

Permissions and integrations

Cmd. /agentsCmd. /hooksCmd. /ideCmd. /mcpCmd. /permissionsCmd. /pluginCmd. /reload-pluginsCmd. /reload-skillsCmd. /sandboxCmd. /skillsCmd. /web-setup

Status and diagnostics

Cmd. /debugCmd. /diffCmd. /doctorCmd. /fewer-permission-promptsCmd. /release-notesCmd. /team-onboarding

Display and input

Cmd. /colorCmd. /focusCmd. /keybindingsCmd. /powerupCmd. /statuslineCmd. /terminal-setupCmd. /themeCmd. /tui

Account and usage

Cmd. /upgradeCmd. /usageCmd. /usage-credits

Legacy

Cmd. /costCmd. /pr-commentsCmd. /reviewCmd. /statsCmd. /ultrareviewCmd. /vimCmd. /approved-toolsCmd. /commandsCmd. /extra-usageCmd. /settingsCmd. /tagCmd. /todos

Verification and history

Current verification scopeHandbook updatesRelease coverage historyEarlier verification recordsCommand change history
Handbook›Claude Code Command Master›Cmd. /mcp
한국어KOEnglishEN

Cmd. /mcp

Manage MCP connections, OAuth, and enabled state.

Written and reviewed by Eric Han · Co-founder & CTO, reopt

Key takeaways

  • Manage MCP connections, OAuth, and enabled state.
  • Check the input surface and availability before using the examples below.

Purpose

Manage MCP connections, OAuth, and enabled state.

/mcp [reconnect (<server>|all)|enable|disable [<server>|all]]

Availability

FieldValue
Input surfaceRunning CLI prompt
KindBuilt-in
StatusCurrent reference
Aliases—
Documented minimumNot specified
Reviewed against2026-10-23 · Claude Code 2.1.308

In addition to the interactive UI, a bare invocation in -p prints server status on v2.1.205+. reconnect all in the interactive terminal requires v2.1.284+.

Examples

/mcp
/mcp reconnect all

Effects and persistence

Manages server connections, OAuth, and enabled state. Toggling or reconnecting servers changes subsequent tool availability.

Direct operations

Use /mcp reconnect server-name for one disconnected server. /mcp reconnect all retries every server that failed or needs authentication (v2.1.284+ in the interactive terminal). /mcp enable server-name and /mcp disable all change enabled state directly. MCP prompts exposed as /mcp__server__prompt are separate dynamically discovered commands.

Cautions

Authentication, enabled state, and tool permissions are separate causes of failed calls; inspect each before reconnecting repeatedly.

From v2.1.287, servers on the 2025-11-25 protocol can send URL prompts, for example to sign in; if a server stops connecting after the update, add "bareElicitationCapability": true to its MCP config entry. The same version makes a server's alwaysLoad: false defer all of its tools behind tool search. Stdio servers negotiate protocol revision 2026-07-28 by default on every install from v2.1.292, after a staged rollout from v2.1.285; set MCP_PROTOCOL_NEGOTIATION=legacy to keep the earlier handshake. From v2.1.295, claude.ai connectors also negotiate protocol revision 2026-07-28 by default on installs that fetch no feature flags, such as sessions with telemetry or feature-flag fetching turned off; the same variable opts out. From v2.1.285 the server name widgets is reserved in cloud sessions and on self-hosted runners, and claude mcp get hides the command, arguments, and environment values of plugin-provided stdio servers.

Official sources

  • Commands
  • Mcp
  • Changelog

Complete command list · Verification scope

Related docs

MCP Integration

Claude Code Complete Guide · Connect Claude Code to tools and resources through Model Context Protocol servers.

MCP Integration

Advanced Codex Usage · Connect Codex to MCP servers with explicit tool, data, and trust boundaries.

Cmd. /mcp

Codex Command Master · List configured MCP tools and inspect server diagnostics.

MCP connections and commands

Choose the commands for mcp connections and commands and follow their availability rules and concrete examples.

Cmd. /reload-plugins

Reload active plugins, warning on MCP changes.

Cmd. /ide

Shows the current session's IDE connection and integration target. File edits occur through subsequent requests and tool calls.

Cmd. /permissions

Manage allow, ask, deny, and Auto rules (/allowed-tools).

On this page

PurposeAvailabilityExamplesEffects and persistenceDirect operationsCautionsOfficial sources