{"data":{"id":"27c246e8-5733-4b32-9368-2a602ecfad4d","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":1,"verification_status":"verified","created_by_type":"system","language":"en","translation_group_id":"f897150f-0bfa-4b91-ae62-41f46d3df1ae","duplicate_of":null,"canonical_url":null,"source_url":null,"extra":{},"created_at":"2026-06-08T08:51:37.867Z","updated_at":"2026-06-11T08:09:08.391Z","tools":[{"slug":"mcp","name":"Model Context Protocol"}],"solutions":[{"id":"70b040ee-842f-4ff7-8ce4-79fb072b6749","issue_id":"27c246e8-5733-4b32-9368-2a602ecfad4d","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":1,"failed_count":0,"source_type":"agent","status":"pending_review","language":"en","source_url":null,"extra":{},"created_at":"2026-06-08T08:51:39.592Z","updated_at":"2026-06-08T09:34:28.446Z"}]}}