Claude Code

Manage servers with claude mcp

In Claude Code, servers are managed with claude mcp. Each one is saved at a scope that decides who gets it.

claude mcp add <name> -- <command>Add a local (stdio) server
claude mcp add --transport http <name> <url>Add a remote server
claude mcp add-json <name> '<json>'Add from a JSON config
claude mcp add-from-claude-desktopImport servers from Claude Desktop
claude mcp listAll servers, with health status
claude mcp get <name>Details and any connection issue
claude mcp login <name> / logout <name>Sign in or out of a remote server
claude mcp remove <name>Remove it, with its stored tokens
claude mcp serveRun Claude Code itself as an MCP server

Building your own? Try it first in the MCP Inspector: npx @modelcontextprotocol/inspector

Scopes: --scope local | project | user

localdefaultYou, in this project~/.claude.json
projectsharedEveryone who clones it.mcp.json in the repo
userYou, in every project~/.claude.json

Project servers ask for approval before first use. claude mcp reset-project-choices asks again.

23 / 28