How to Install MCP Servers in Claude Desktop App

Anthropic’s Claude Desktop app is currently the flagship “Host” for the Model Context Protocol. Here is the definitive guide to setting it up manually.

(Note: If you want to skip the manual editing, you can use Vibe Manager to do this automatically.)

Prerequisites

• Claude Desktop App installed (Mac or Windows).
• Node.js and npm installed (for running most servers).

Step 1: Locate the Config File

You need to create or edit a file named claude_desktop_config.json.

On macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

On Windows:

%APPDATA%\Claude\claude_desktop_config.json

Step 2: Basic Structure

The file expects a JSON object with an mcpServers key.

{
  "mcpServers": {
    
  }
}

Step 3: Adding a Server (Example: FileSystem)

Let’s add the official FileSystem server. We will tell it to use npx to run the server on demand.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Projects"
      ]
    }
  }
}

Breakdown:

• "filesystem": The name Claude will see.
• "command": The executable (npx, node, python, etc.).
• "args": The arguments. Here we allow access to Desktop and Projects folders.

Step 4: Restart Claude

Save the file. You must completely Quit Claude (Cmd+Q) and restart it for changes to take effect.

Step 5: Verification

1. Open Claude.
2. Look for the 🔌 (Plug) icon near the input box.
3. Click it. You should see “filesystem” listed.
4. Try asking: “List the files in my Projects folder.”

Troubleshooting

• Icon missing? Check your JSON syntax. A trailing comma will break it.
• “Connection refused”? Ensure npx is in your PATH. You might need to use the absolute path to the node executable.
• Silent failure? Check the Claude logs: ~/Library/Logs/Claude/mcp.log.

The Easier Way

Editing JSON manually is prone to syntax errors. Vibe Manager provides a GUI for this. You just fill in the fields, and we generate the valid JSON and put it in the right folder for you. Plus, we back up the file so you never break your setup.