Skip to content
BENIBIX Learn

claude mcp add Command

Also known as claude mcp add, claude mcp, Add an MCP server

It adds an MCP server to Claude Code from the shell.

Think of it like

It is like you plug a new lamp in, so it can light up the room.

Example

Jack wants Claude to read his team's tickets. He runs claude mcp add with the tracker's address and --scope project, then commits .mcp.json so the team gets it too.

Why it matters

A server added once is there in every session after, with the tools it brings.

Definition

claude mcp add adds an MCP server to Claude Code from the shell. For a server on the web, give it --transport http, a name and the address. For one that runs on your computer, give it a name, then -- and the command that starts it. It goes in local scope by default, just for you in this project. Add --scope project to share it with your team through .mcp.json, or --scope user to have it in all your projects.

Example code

bash
claude mcp add --transport http notion https://mcp.notion.com/mcp
Add a server that lives on the web.
--scope picks which of these three boxes the server goes in.

Common mistake

Leaving out the -- before a local server's command. Without it, Claude Code reads the server's own flags as its own.

Key takeaways

  1. 1
    Web or local. Address or command.
  2. 2
    Local by default. Just you, this project.
  3. 3
    --scope. project or user.

Learn it properly