Cmd. /mcp
Manage MCP connections, OAuth, and enabled state.
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>|enable|disable [<server>|all]]Availability
| Field | Value |
|---|---|
| Input surface | Running CLI prompt |
| Kind | Built-in |
| Status | Current reference |
| Aliases | — |
| Documented minimum | Not specified |
| Reviewed against | 2026-09-22 · Claude Code 2.1.278 |
In addition to the interactive UI, a bare invocation in -p prints server status on v2.1.205+.
Examples
/mcpEffects 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 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.