44 articles in "Troubleshooting" · page 2 of 3

TroubleshootingEasy

Find & Edit claude_desktop_config.json on macOS — Full Path Guide

Locate the Claude Desktop MCP configuration file on macOS. Exact file paths, hidden folder access, TextEdit/VS Code editing, and JSON validation.

TroubleshootingEasy

Fix MCP Server Connection Timeout in Claude Desktop on Mac

Diagnose and resolve MCP server timeout issues in Claude Desktop for macOS. Network settings, server startup delays, and timeout configuration.

TroubleshootingEasy

UVX Command Not Found for MCP Server on Mac — Homebrew Fix

Install uv/uvx on macOS via Homebrew for faster MCP server execution. Complete installation, PATH configuration, and verification guide.

TroubleshootingEasy

Mac Firewall Blocking MCP Server — Connection Refused Fix

Configure macOS firewall to allow MCP server connections. System Settings adjustments, application exceptions, and network service permissions.

TroubleshootingEasy

Fix MCP Server Invalid JSON Config — Mac Syntax Error Guide

Common JSON configuration errors for MCP servers on macOS and how to fix them. Validation tools, formatting best practices, and working examples.

TroubleshootingEasy

Claude Desktop MCP Server Tools Not Showing on Mac — Fix

Troubleshoot when MCP server tools fail to appear in Claude Desktop on macOS. Configuration validation, server health checks, and reloading procedures.

TroubleshootingEasy

Fix Zsh PATH Issue — NPX MCP Server Not Detected on Mac

Resolve Zsh shell PATH problems preventing MCP server detection on macOS. Profile file editing, Homebrew paths, and shell environment verification.

TroubleshootingEasy

Fix MCP Server Port Conflict on Mac — lsof & Kill Process

Identify and free occupied ports for MCP servers on macOS. Using lsof, kill, and launchd service management to resolve port conflicts.

TroubleshootingEasy

MCP Server Filesystem Tool — Allow Folder Access on Mac

Grant folder access permissions to MCP server filesystem tools on macOS. Privacy settings, Terminal access, and sandbox configuration guide.

TroubleshootingEasy

Fix MCP Server Crash When Opening Claude on macOS Ventura+

Resolve MCP server crashes that occur when launching Claude Desktop on macOS Ventura and newer. Compatibility checks, dependency updates, and workarounds.

TroubleshootingEasy

GitHub MCP Server Token Not Working on Mac — Config Fix

Fix GitHub Personal Access Token authentication issues for MCP servers on macOS. Token permissions, config formatting, and validation steps.

TroubleshootingEasy

Fix MCP Server Error -32000 on Mac — Claude Desktop

Resolve the JSON-RPC error code -32000 when connecting MCP servers to Claude Desktop on macOS. Protocol negotiation, version mismatch, and compatibility fixes.

TroubleshootingEasy

Fix MCP Server Stdio Transport Disconnect on Mac — Guide

Prevent and fix stdio transport disconnects for MCP servers on macOS. Process monitoring, watchdog scripts, and persistent connection strategies.

TroubleshootingEasy

Fix MCP Server "spawn ENOENT npx" Error on Ubuntu

Complete fix for spawn ENOENT errors when running MCP servers via npx on Ubuntu Linux. Node.js, npm, and shell path troubleshooting guide.

TroubleshootingEasy

Find claude_desktop_config.json File Path on Linux

Locate and edit the Claude Desktop MCP configuration file on Linux (Ubuntu, Fedora, Arch). Exact paths, hidden directories, and editor recommendations.