What if auto-configure IntelliJ MCP server for Claude Desktop fails

Problem

Auto-configure option for connecting JetBrains IDEs to Claude Desktop via MCP Server may fails to create or update the configuration file. Symptoms include:

• Auto-configure button appears to do nothing — no UI feedback or confirmation message
• Configuration file is not created at the expected location (~/.claude/claude_desktop_config.json on macOS/Linux, %APPDATA%\Claude\claude_desktop_config.json on Windows)
• IDE does not appear as an available MCP server in Claude Desktop after running auto-configure

Cause

• IDE lacks file system permissions to write to the user home directory or APPDATA folder
• File system or antivirus restrictions block configuration file creation
• IDE or Claude Desktop version incompatibility

Resolution

Attempt Auto-Configure

1. In IDE, navigate to "Settings | Tools | MCP Server"
2. Click "Auto-configure"
3. Wait for confirmation message in the IDE status bar or notification area

If the file does not exist after auto-configure completes, proceed to the next section.

If Auto-Configure Failed — Troubleshoot Permissions

1. On Windows: Run IDE as administrator

2. On macOS: Grant IDE full disk access

   • System Settings → Privacy & Security → Full Disk Access
   • Add the IDE to the list
   • Restart IDE and retry auto-configure

3. On Linux: Verify directory permissions

   • Confirm ~/.claude/ directory exists and is writable: ls -ld ~/.claude/
   • If it doesn't exist, create it: mkdir -p ~/.claude/
   • Retry auto-configure

Manual Configuration (Workaround)

If auto-configure continues to fail, manually create the configuration file:

1. Create or open the configuration file at the path above
2. Add the following content (replace /path/to/ide with your IDE installation directory):

{
  "mcpServers": {
    "jetbrains": {
      "command": "/path/to/ide/bin/mcp-server",
      "args": []
    }
  }
}

On Windows, use forward slashes or escape backslashes:

{
  "mcpServers": {
    "jetbrains": {
      "command": "C:/Program Files/JetBrains/IntelliJ IDEA/bin/mcp-server.exe",
      "args": []
    }
  }
}

3. Save the file
4. Restart Claude Desktop
5. Verify the IDE appears as an available MCP server in Claude

Verify the Connection

1. Open Claude Desktop
2. Confirm the IDE is listed as an available MCP server
3. Open the IDE and verify Claude context menus or features appear
4. Check IDE logs (Help → Show Log in Explorer/Finder) for any connection errors