Claude Code and MCP: where the configuration lives, how to add a server, and how to fix errors

27 August 202654 views

We figure out which file Claude Code uses to store MCP settings for desktop and CLI, how to configure the server manually or via a command, and what to do if tools are not visible after a restart.

Claude Code and MCP: where the configuration lives, how to add a server, and how to fix errors

What is MCP and why connect it to Claude Code

Claude Code can work not only with its built-in features, but also with external tools via the MCP protocol. This lets you run website parsing, design work, security checks, and much more directly from the chat.

To get a server running, you need to describe once how to launch it: which command is used, which arguments are passed, and which access keys are needed. The main challenge is that the configuration lives in different places depending on which version you're using.

Configuration in the desktop app

If you're using the desktop version, the settings file is located at C:\Users\Boss\AppData\Roaming\Claude\claude_desktop_config. The file has no extension, although it's actually plain JSON. The fastest way to open it is via the %APPDATA%\Claude variable — that's where claude_desktop_config.json lives.

The structure is simple: the mcpServers key, inside it — the server name, and under that — command, args, and env.

json { "mcpServers": { "server-name": { "command": "command", "args": ["arguments"], "env": { "API_KEY": "your-key" } } } }

For example, for firecrawl (website parsing) you need to run npx -y firecrawl-mcp and pass the FIRECRAWL_API_KEY key. For Pencil (design) — specify the full path to the exe file and the --app desktop argument. In the same file, you can also add, say, Burp Suite for security tasks.

After saving the configuration, be sure to fully close the app — not just minimize it, but actually quit via the tray. On the next launch, a hammer icon with the number of available tools will appear at the bottom of a new chat. If that doesn't happen — look for an error in the JSON.

Setting up servers for the CLI version

The terminal version of Claude Code ignores the desktop config. Putting anything there is useless — the file is silently ignored. Instead, the file C:\Users\USERNAME\.claude.json in the home directory is used. Note: this is a file, not a .claude folder. The difference is one dot, and it's easy to miss.

You can add a server in two ways. The first is via a terminal command: claude mcp add firecrawl --scope user -- npx -y firecrawl-mcp. The second is to manually edit .claude.json. If the file doesn't exist yet, just create it. If you need to pass a key via an environment variable, it's more convenient to edit the file by hand — the command line isn't well suited for that.

For a specific project, to avoid carrying settings across all projects at once, a .mcp.json is created in the root. This file can be committed to git if the whole team uses the same servers. Adding looks like this: claude mcp add firecrawl --scope project -- npx -y firecrawl-mcp

How to check and manage servers

Inside a session, the easiest way to check status is via the /mcp command — it lists all servers and shows which ones are running. For the terminal, there are separate commands:

  • claude mcp list — all servers and their statuses;
  • claude mcp get firecrawl — details of a specific server;
  • claude mcp remove firecrawl --scope user — remove a server.

Common errors and how to fix them

Most often, a server doesn't show up due to errors in the JSON. A trailing comma at the end of a block, a missing comma between servers, unmatched brackets — all of these cause the file to be silently ignored without any warnings. Check the syntax before restarting the app.

If you see npx: command not found when starting a server, Node.js isn't installed or isn't added to PATH. Install Node.js, restart the terminal, and make sure node --version and npx --version output versions.

On Windows, it's also important to properly write paths with spaces. For example, C:\Program Files\... in JSON needs to be escaped with double backslashes: "C:\\Program Files\\Pencil\\resources\\...". Otherwise, the app won't find the file.

Frequently asked questions

Related materials

All materials
Validating Candidates Costs More Than Generating Them: Honeypots Against LLM Vulnerability Hunting
News

Validating Candidates Costs More Than Generating Them: Honeypots Against LLM Vulnerability Hunting

The study examines the cost asymmetry in agentic vulnerability discovery: generating candidate versions is cheap, while confirming them through reachability analysis, execution, and PoC development consumes most of the budget, making verification a potential standalone target for defense. The proposed RedHerring—repository-adapted decoys with a hidden certificate—reduced the number of real vulnerabilities found by 38.7–60.4% at equal cost across 33 OSS-Fuzz projects; even after the agent was warned, the reduction remained at 37.2%.

9 November 2026
Numerical Constraints and Correction Techniques Determine the Preservation of Hyperbolic Hierarchy Features
Research

Numerical Constraints and Correction Techniques Determine the Preservation of Hyperbolic Hierarchy Features

The work examines how manifold-constraint feasibility, arithmetic precision, and normalization narrow the attainable states and thereby affect which evidence of learned structure remains in the model. It follows that a saved flat checkpoint cannot be considered proof of failed geometry without separately accounting for numerical constraints and corrections.

7 November 2026
World Models for Agents on Closed-Source LLMs: Correction at High-Risk Points
News

World Models for Agents on Closed-Source LLMs: Correction at High-Risk Points

PAWM is proposed as an external predictor that does not duplicate step-by-step observation, but activates when a failure is likely and steers the agent away from an erroneous action. After SFT on synthetic scenarios and GRPO co-training, the method achieved gains of 24.3% in ScienceWorld and 7.7% in WebArena-Lite for Claude Sonnet 4.5.

4 November 2026
Claude Code and MCP Where is the configuration and how to add the server