docs/errors/MCPX_CONFIG_DEPRECATED_FIELD.md
MCPX_CONFIG_DEPRECATED_FIELDSeverity: warn Domain: Config
mcpproxy parsed your config (~/.mcpproxy/mcp_config.json) successfully, but
detected a field that has been renamed or replaced. The current release still
honours the old field; a future release will not.
The error panel includes a Preview migration (dry-run) fix-step. CLI:
mcpproxy config migrate --dry-run
This prints the diff that would be applied. Review it, then apply:
mcpproxy config migrate
A .bak is written next to the original file.
If you prefer to edit the file by hand, the warning message names the exact field. The most common renames:
| Old | New |
|---|---|
mcpServers[].docker_isolation (bool) | mcpServers[].isolation.enabled |
top_k (deprecated) | tools_limit |
enable_quarantine | quarantine_enabled |
Deprecated fields keep working. If you can't migrate today, the warning is informational — there's no operational impact in this release.