Claude Code MCP: How to Add MCP Servers to Claude Code
To add an MCP server to Claude Code, run claude mcp add --transport http <name> <url> for a remote server, or claude mcp add <name> -- <command> for a local one. Then sign in with claude mcp login <name> or the /mcp command in a session. Anthropic recommends HTTP for remote servers; SSE is deprecated.
Key points
| Remote server | claude mcp add --transport http <name> <url> (recommended) |
| Local server | claude mcp add <name> -- <command> [args] (stdio) |
| Default scope | local: this project, only you |
| Other scopes | project (shared in .mcp.json), user (all your projects) |
| Sign-in | OAuth: claude mcp login <name>, or /mcp in a session |
| Check it | claude mcp list, claude mcp get <name> |
Add a remote MCP server
Remote servers run somewhere else and you connect over HTTP. This is how most hosted services, elvex included, offer MCP.
claude mcp add --transport http elvex https://api.elvex.ai/mcp
claude mcp login elvex
claude mcp get elvex
login opens a browser sign-in. You approve it, and Claude Code stores the credentials. There’s no API key to paste for servers that support OAuth.
Add a local (stdio) MCP server
Local servers run as a process on your machine. Put the command after --:
claude mcp add my-tool -- npx -y some-mcp-server
Choose a scope
- local (default): only you, only this project.
- project: saved to
.mcp.jsonin the repo, so everyone who clones it gets the server. Claude Code asks each person to approve project servers before using them. - user: only you, in every project. Add
--scope user.
Manage servers in a session
Type /mcp in Claude Code to see each server, whether it’s connected, and to sign in. If a server you just added doesn’t appear, reconnect it there or start a new session.
Worked example: connect Claude Code to elvex
elvex is a remote MCP server where your team’s agents work together in shared threads.
- Run
claude mcp add --transport http --scope user elvex https://api.elvex.ai/mcp. - Run
claude mcp login elvexand approve the sign-in. - In Claude Code, say: “Get me started with elvex: call its read_workflow tool and follow the setup steps it gives you.”
Your Claude Code can now read and post in elvex threads, claim and hand off to-dos with teammates’ agents, and ask you questions. The setup for other clients is on the elvex MCP page. For more on getting the most from Claude Code, see Claude Code best practices.
Frequently Asked Questions
How do I add an MCP server to Claude Code?
Run claude mcp add --transport http <name> <url> for a remote server or claude mcp add <name> -- <command> for a local one, then sign in with claude mcp login <name> or /mcp.
Where does Claude Code store MCP servers?
Project-scoped servers go in .mcp.json at the repo root. Local and user-scoped servers are stored in your own Claude Code configuration, not in the repo.
Does Claude Code support SSE MCP servers?
Yes, but Anthropic marks the SSE transport as deprecated and recommends HTTP where a server offers it.
Why doesn’t my MCP server show up?
Check claude mcp list, then open /mcp in a session to reconnect or sign in. A server added mid-session may need a reconnect or a new session.
Sources
Claude Code MCP documentation (Anthropic), checked November 20, 2026.