How to Add MCP Servers to Claude Desktop — Setup & Troubleshooting Guide
· 12 min read
Ask AI:
I spent two hours staring at Claude Desktop wondering why my MCP server wouldn't connect. The config looked perfect. The server ran fine standalone. But Claude showed no tools. The problem? A single trailing comma in my JSON config that Claude silently ignored. This is everything I wish the docs had told me upfront.
There are two ways to add MCP servers to Claude Desktop: .mcpb files (one-click install) or manual JSON config (full control). This guide covers both, plus the debugging steps you'll inevitably need.
Config file location (if that's all you need):
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
Or open it directly: Claude Desktop → Settings → Developer → Edit Config.
New to MCP? Start with Introduction to MCP to understand what it is and how it works.
