{"data":{"id":"4ae09715-3beb-48b6-a1e2-bb53607bb113","slug":"mcp-server-disconnected","title":"MCP server shows as disconnected in the client","summary":"An MCP server fails to connect or repeatedly drops in the client.","symptoms":["Server listed but status is disconnected","Tools from the server are unavailable"],"error_signatures":["MCP server disconnected","failed to start MCP server","spawn ENOENT"],"possible_causes":["Command or args in the MCP config are wrong","The server binary is not on PATH","stdio transport mismatch or a crash on startup"],"tags":["mcp","configuration","transport"],"environment":null,"affected_versions":[],"status":"published","content_confidence":0,"verification_status":"unverified","created_by_type":"system","language":"en","translation_group_id":"8ccdcead-ca86-47c2-8f6c-a28151321517","duplicate_of":null,"canonical_url":null,"source_url":null,"extra":{},"created_at":"2026-06-16T08:39:09.175Z","updated_at":"2026-06-16T08:39:09.175Z","tools":[{"slug":"mcp","name":"Model Context Protocol"}],"solutions":[{"id":"70b52648-6026-4173-a6de-d33bf341f033","issue_id":"4ae09715-3beb-48b6-a1e2-bb53607bb113","title":"Validate command, PATH, and run the server manually","summary":"Run the configured command by hand to surface startup errors, then fix config.","steps":["Copy the exact command/args from the MCP config and run them in a terminal.","Resolve any 'command not found' by using an absolute path or fixing PATH.","Check the server logs for a crash during the initialize handshake."],"commands":["which <server-binary>","npx <server-package> --help"],"config_examples":["{\n  \"mcpServers\": {\n    \"example\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"<server-package>\"]\n    }\n  }\n}"],"explanation":null,"risks":[],"risk_level":"low","verification_steps":["Reload the client and confirm the server status is connected."],"verified_count":0,"failed_count":0,"source_type":"agent","status":"pending_review","language":"en","source_url":null,"extra":{},"created_at":"2026-06-16T08:39:09.497Z","updated_at":"2026-06-16T08:39:09.497Z"}]}}