MCP config files edited by hand are overwritten by cc-switch - cc-switch

Quick fix

cc-switch writes wholesale. Sync plugins through general config, and upgrade to v3.13.0 for the MCP cross-app leak fix.

Symptom

Error outputCopy

每次重新打开 cc-switch 或执行任何 MCP 操作时，我的修改都会被覆盖，配置恢复到 cc-switch 数据库中的旧版本。

English translation

Every time I reopen cc-switch or perform any MCP operation, my changes are overwritten and the config reverts to the older version in the cc-switch database.

Cause

cc-switch writes local config files (`~/.claude/settings.json`, `~/.claude.json`) one way and wholesale (DB → live). Switching provider or triggering a sync overwrites the local file directly from the database snapshot, losing external hand edits, `enabledPlugins`, and `hooks`. Maintainers confirmed this is a design decision and recommend managing shared plugins through 通用配置 (general config). Separately, before v3.13.0 MCP sync was not strictly bound to app visibility, so config leaked across apps.

Fix

1. 1

   For lost plugins and hooks, use 通用配置 (general config) to carry shared config between providers rather than editing local files directly.

   cc-switch UI 操作路径

   编辑供应商 → 通用配置面板 → 「从当前供应商提取」
   新建供应商时勾选「写入通用配置」

2. 2

   For the MCP cross-app leak, upgrade cc-switch to v3.13.0 or newer, which improved the per-app sync mechanism.

3. 3

   Avoid editing managed config files such as `~/.claude.json` by hand outside cc-switch — do all MCP additions, changes, and deletions in the cc-switch UI.

Affected Versions

Toolcc-switch

Versionv3.13.0 修复了 MCP 泄漏，全量覆盖为当前设计

PlatformsWindowsmacOSLinux

Source Issues

This page is distilled from 4 real issues

• #685[Bug] 手动修改的 MCP 配置文件被 cc-switch 覆盖
• #1486[Bug] 只同步 Claude Code的MCP配置， 但是MCP 仍泄漏到 OpenCode
• #1594Bug Report: Plugin Configuration Not Synced Across Providers
• #4322bug: switching providers wipes enabledPlugins/hooks from ~/.claude/settings.json

FAQ

Why do plugins I configured in `~/.claude/settings.json` disappear after switching provider?

cc-switch writes settings.json wholesale and overwrites the local file from the database snapshot on a switch. Extract and sync your plugin config through 通用配置 (general config).

I turned OpenCode display off in cc-switch — why did its MCP still leak into Codex?

A bug before v3.13.0: disabling the UI display did not stop the background import at startup. From v3.13.0, each MCP server has its own per-app enable flag.

Related problems

The model cannot discover any tools - CodexUpgrade cc-switch past 3.16.1 and edit cc-switch-model-catalog.json to set supports_search_tool to false for the DeepSeek models.2 issues merged502 Bad Gateway Codex proxy takeover overwrites config.tomlDisable global proxy and switch to rule mode with direct connection to 127.0.0.1, or upgrade cc-switch to avoid fully overwriting config.toml.29 issues mergedFailed to parse Hermes configUpgrade cc-switch to v3.16.3+ to fix the CRLF-driven config append bug, or delete the duplicate keys in config.yaml by hand.6 issues merged