Adding MCP servers to Claude Desktop
By Sophie Filer · Updated 26 Oct 2026
Claude Desktop reads local MCP servers from claude_desktop_config.json. Remote servers can also be added as connectors in Settings without touching the file.
Local servers: edit the config file
- In Claude Desktop open Settings, then Developer, then Edit Config.
- Add your server inside "mcpServers" and save the file.
- Quit Claude Desktop completely (from the menu bar or system tray, not just the window) and open it again.
- Open the tools menu in the message box to see the server and its tools.
| System | Config file |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["-y", "@playwright/mcp@latest"]
}
}
}Remote servers: add a connector
For servers with a URL, use Settings → Connectors → Add custom connector and paste the URL. Claude handles sign-in if the server needs it. Custom connectors depend on your plan.
If nothing appears
- Check the JSON is valid; a single stray comma breaks the whole file.
- Use full paths for commands and files. Claude Desktop does not start from your project folder.
- On macOS, if npx or uvx is "not found", give the full path (run which npx in a terminal to get it).
- Read the logs in Settings → Developer; each server has its own log file.
Questions
Is claude_desktop_config.json the same format as Cursor's mcp.json?
Yes, the "mcpServers" block is identical, so entries copy across unchanged.