Documentation mcp-sync Safety and recovery

Safety and evidence

Make configuration drift reversible.

Preview a retained adjacent backup before restoring one supported target, then verify the resulting plan again.

Preview and restore one target

Restore validates the retained backup with the target's native JSON or TOML parser before mutation. Select one supported target explicitly.

Restore Cursor
mcp-sync restore cursor --dry-run
mcp-sync restore cursor

Configuration only—until you explicitly test.

Client-owned data stays client-owned

init, list, sync, and restore do not start MCP servers. Only test executes one named local definition. Project-level files, remote entries, credential stores, and unowned client settings stay outside the managed boundary.

Read the complete product contract