Skip to content
BENIBIX Learn

.mcp.json

AI⌨️ Claude CodeConfiguration

Also known as .mcp.json file, project MCP config

A file in a project that lists MCP servers the team shares.

Think of it like

It is like a shared phone list for a team. Everyone can call the same numbers.

Example

Emma adds the team's issue tracker server with --scope project. The .mcp.json goes into git, and each teammate approves it once.

Why it matters

It gives the whole team the same tools without each person adding them.

Definition

.mcp.json is a file in a project's root that lists MCP servers for the whole team. It is what claude mcp add writes when you use --scope project, and it is meant to be committed. Before using a server from it, Claude Code asks each person to approve it. Servers you add for yourself go in ~/.claude.json instead.

Example code

json
{
  "mcpServers": {
    "docs": { "type": "http", "url": "https://mcp.example.com/mcp" }
  }
}
One server the whole team can use.

Common mistake

Expecting a server in it to run with no question. Each person must say yes to it first.

Key takeaways

  1. 1
    Project root. Committed.
  2. 2
    Team servers. --scope project.
  3. 3
    Approve first. Per person.

Compare