Skip to content

MCP stdio connection failure: cmd /c wrapper prevents Claude Code from connecting

Quick fix

On Windows, if editing MCP configuration introduces a cmd /c wrapper and causes connection failure, check the generated command and args, then upgrade to a…

Error output
claude mcp list 显示 ✘ Failed to connect
English translation

claude mcp list shows ✘ Failed to connect

This cluster includes several types of MCP issues that cannot be explained by one symptom or fix. #5132 describes the MCP stdio command being wrapped as `cmd /c` on Windows, disrupting stdin/stdout communication. #673 describes Linux commands being incorrectly wrapped in Windows format when editing configuration for WSL on Windows; the maintainer replied that the issue had been fixed. Other issues involve MCP import, saving, syncing external changes, and configuration being re-injected after deletion. The available issues do not establish a shared cause or a unified fix for these cases.

  1. If the issue is a Windows MCP stdio command wrapped as `cmd /c` that fails to connect, compare the command and args before and after generation. #5132 was closed as a duplicate, and a comment points to #1286, but this cluster does not provide that issue’s fixed version or specific resolution steps.

  2. If the issue occurs while managing MCP configuration for WSL on Windows, the maintainer replied that the issue in #673 had been fixed and would be included in a later release; the issue does not specify a version.

  3. If the issue involves importing, saving, syncing external changes, or configuration reappearing after deletion, these are distinct failures. This cluster provides no confirmed general fix.

ToolClaude Code
VersionUnknown
PlatformsWindowsLinux

(No FAQ yet)

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.