How to Set Up MCP in Claude Desktop (Complete 2026 Guide)

Claude Desktop supports the Model Context Protocol (MCP), allowing you to extend Claude's capabilities with external tools and data sources. This guide — updated for April 2026 — shows you exactly how to set up MCP servers in Claude Desktop, step by step.

Prerequisites

Step 1: Find the Config File Location

Claude Desktop stores MCP configuration in a JSON file. The location depends on your operating system:

Step 2: Understand the Config Structure

The config file uses this JSON structure:

{
 "mcpServers": {
 "server-name": {
 "command": "executable",
 "args": ["arg1", "arg2"],
 "env": {
 "API_KEY": "your-api-key"
 }
 }
 }
}

Step 3: Add Your First MCP Server

Let's start with a simple example - the filesystem MCP server that lets Claude read and write files:

{
 "mcpServers": {
 "filesystem": {
 "command": "npx",
 "args": [
 "-y",
 "@modelcontextprotocol/server-filesystem",
 "/Users/yourname/Documents"
 ]
 }
 }
}

Popular MCP Server Configurations

Copy and paste these ready-to-use configurations for popular MCP servers:

{
 "mcpServers": {
 "github": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
 "env": {
 "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
 }
 }
 }
}

{
 "mcpServers": {
 "supabase": {
 "command": "npx",
"args": [
"-y",
"@supabase/mcp-server-supabase@latest",
"--read-only",
"--project-ref=your-project-ref"
],
 "env": {
"SUPABASE_ACCESS_TOKEN": "sbp_your_personal_access_token"
 }
 }
 }
}

{
 "mcpServers": {
 "playwright": {
 "command": "npx",
"args": ["@playwright/mcp@latest"]
 }
 }
}

Step 4: Configure Multiple Servers

You can run multiple MCP servers simultaneously — Claude Desktop will load all of them on startup and merge their tools:

{
 "mcpServers": {
 "filesystem": {
 "command": "npx",
 "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/folder"]
 },
 "github": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"],
 "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx" }
 },
 "supabase": {
 "command": "npx",
"args": ["-y", "@supabase/mcp-server-supabase@latest", "--read-only", "--project-ref=xxx"],
"env": { "SUPABASE_ACCESS_TOKEN": "sbp_xxx" }
},
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
 }
 }
}

Step 5: Restart Claude Desktop

After saving your config changes:

1. Completely quit Claude Desktop (not just close the window)
2. On macOS: Right-click the dock icon → Quit
3. On Windows: Right-click the system tray icon → Exit
4. Reopen Claude Desktop

Step 6: Verify Your MCP Servers

To check if your MCP servers are connected:

1. Open Claude Desktop
2. Look for the hammer icon (🔨) in the input area
3. Click it to see available tools
4. Your MCP server tools should be listed

Remote MCP Servers (Custom Connectors)

The configs above all run MCP servers locally on your machine via STDIO. If you want to connect Claude Desktop to a remote MCP server (hosted on the web, with OAuth), you don't use claude_desktop_config.json — you use Custom Connectors.

Transport notes (April 2026): Claude's official transport is now Streamable HTTP (MCP protocol 2025-11-25). The older SSE transport is being deprecated — any SSE-only server should upgrade. Custom Connectors are available on Pro, Max, Team, and Enterprise plans.

Troubleshooting Common Issues

{
 "mcpServers": {
"filesystem": {
 "command": "/usr/local/bin/npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Documents"]
 }
 }
}

{
"mcpServers": {
"filesystem": {
"command": "C:\\Program Files\\nodejs\\npx.cmd",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "C:\\Users\\you\\Documents"]
}
}
}

Security Best Practices

• Limit file access: Only give filesystem servers access to specific directories
• Use minimal permissions: Create API tokens with only the scopes you need
• Review server code: Before running any MCP server, review its source code
• Don't share your config: Your config contains sensitive API keys

Test Your MCP Servers Online

Before adding an MCP server to Claude Desktop, test it using MCP Playground. This browser-based tool lets you connect to remote MCP servers and test tool calls.