# claude mcp add Command

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

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** claude mcp add, claude mcp, Add an MCP server

## Think of it like

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

## 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

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.

## Example code

```bash
claude mcp add --transport http notion https://mcp.notion.com/mcp
```

Add a server that lives on the web.

## Why it matters

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

## Common mistake

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

## Three principles

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

## Related terms

- [MCP Server](https://learn.benibix.com/term/ai/mcp-server)
- [/mcp Command](https://learn.benibix.com/term/ai/mcp-command)
- [claude mcp add-json Command](https://learn.benibix.com/term/ai/claude-mcp-add-json-command)
- [MCP Transport](https://learn.benibix.com/term/ai/mcp-transport)

## Taught in

- [The claude mcp Commands](https://learn.benibix.com/learn/ai-claude-code-commands/claude-mcp-commands): Claude Code Commands, 12/17

![Three scopes for an MCP server: local and user stay yours, project is shared through git.](https://learn.benibix.com/diagrams/cli-mcp-scopes.svg)

---

Source: https://learn.benibix.com/term/ai/claude-mcp-add-command
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
