Skip to content
CC Switch WikiUnofficial Community Wiki

No MCP servers configured. Claude Code

Quick fix

Enable MCP servers one at a time to find the unusable configuration, then disable or remove it and reload Claude Code.

Symptom

Section titled “Symptom”
Error output
No MCP servers configured. Use `claude mcp add` to add a server.

Cause

Section titled “Cause”

The reported issues cover various MCP configuration, import, sync, and conversion problems. Invalid or incompatible MCP JSON may make all MCP servers unavailable in Claude Code. Users also reported MCP entries being rewritten, lost, or converted into a format incompatible with the target client when switching providers, saving configurations, or importing configurations. Some issues have recorded fixes, while others remain open, so they cannot be confirmed as the same root cause.

Fix

Section titled “Fix”

  1. Enable configured MCP servers one at a time to identify the unusable entry.

  2. Disable or remove the unusable MCP configuration, then reload Claude Code.

  3. If the problem occurs after importing, saving, or switching providers, retain the relevant version, system environment, reproduction steps, and logs, and continue tracking it in the corresponding issue.

Affected Versions

Section titled “Affected Versions”
ToolClaude Code
VersionUnknown
PlatformsWindowsmacOSLinux

Source Issues

Section titled “Source Issues”

This page is distilled from 20 real issues

FAQ

Section titled “FAQ”
Was it resolved later?
One user reported that when an unusable MCP exists in the configuration, enable them one at a time to identify the entry, then disable or remove it.
It is present in claude.json, but not in /mcp. What should I do?
One user reported the same behavior and suggested enabling MCP servers one at a time, then disabling or removing the unusable configuration.
Section titled “Related problems”
[mcp_servers.node_repl] written back automatically by CC SwitchTurn off or delete node_repl in MCP management at the top right of CC Switch to stop it being written back into the Codex config file.2 issues mergedManually edited MCP configuration files are overwritten by cc-switchEdit MCP settings in cc-switch and upgrade to v3.13.0+; use “Common Configuration” to share settings.json plugins/hooks across providers.5 issues merged[DISCUSS] Support for pi coding agentThis is a feature request merged into tracking issue #1855; the original post provides no verifiable solution.1 issues merged

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.