How to Intermediate · 3 min read

How to configure MCP in claude_desktop_config.json

Q: How to configure MCP in claude_desktop_config.json

To configure MCP in claude_desktop_config.json, add an mcp section specifying the server type (e.g., stdio), and any relevant parameters like command or port. This enables the Claude desktop client to communicate with MCP servers for AI agent integrations.

Quick answer

To configure MCP in claude_desktop_config.json, add an mcp section specifying the server type (e.g., stdio), and any relevant parameters like command or port. This enables the Claude desktop client to communicate with MCP servers for AI agent integrations.

PREREQUISITES

Python 3.8+
Claude Desktop installed
Basic knowledge of JSON configuration files

Setup

Ensure you have the Claude Desktop app installed and access to the claude_desktop_config.json file, typically located in your user configuration directory. No additional packages are required for MCP configuration itself.

Step by step

Edit your claude_desktop_config.json to include an mcp section. Specify the server type and parameters. For example, to configure an MCP server using stdio transport with a command to launch your MCP agent:

json

{
  "mcp": {
    "server": "stdio",
    "command": "python",
    "args": ["-m", "mcp.server.stdio", "--port", "0"]
  }
}

Common variations

You can configure MCP with different transports such as stdio or sse. For example, to connect to an MCP server running on a local port via SSE:

json

{
  "mcp": {
    "server": "sse",
    "url": "http://localhost:8080/mcp"
  }
}

Troubleshooting

If the MCP server does not start, verify the command and args are correct and executable.
Check that the port specified is free and accessible if using network transports.
Review Claude Desktop logs for MCP connection errors to diagnose issues.

✅

Key Takeaways

Add an mcp section in claude_desktop_config.json to enable MCP integration.
Specify the server type and required parameters like command or url depending on transport.
Use stdio for local subprocess MCP servers or sse for networked MCP servers.
Verify commands and ports to avoid connection failures.
Check logs for troubleshooting MCP connection issues.

Verified 2026-04 · claude-3-5-sonnet-20241022

Verify ↗