Skip to content
CC Switch WikiUnofficial Community Wiki

url is not supported for stdio, Codex

Quick fix

Upgrade to v4.0.0 or later, then resync the servers on the MCP page to clear the old type field.

Symptom

Section titled “Symptom”
Error output
请修复 /Users/caoxincheng/.codex/config.toml:121:1: url is not supported for stdio.保存文件后,重新打开此对话串.
English translation

Please fix /Users/caoxincheng/.codex/config.toml:121:1: url is not supported for stdio. Save the file, then reopen this conversation.

Cause

Section titled “Cause”

When syncing Codex HTTP MCP servers to config.toml, cc-switch 3.20.4 incorrectly wrote `type = "stdio"` and an empty `command` while retaining `url`. As a result, Codex could not load the configuration. Another symptom was Codex reporting unrecognized settings such as `mcp_servers.*.type`; both were related to the legacy `type` field written during MCP sync.

Fix

Section titled “Fix”

  1. Upgrade to v4.0.0 or later. The maintainer said this version no longer writes the MCP `type` field when syncing to Codex.

  2. On the MCP page, resync the relevant servers to clear the old `type` field from the configuration. HTTP MCP writes only `url` and headers; stdio MCP writes only `command`/`args`.

Affected Versions

Section titled “Affected Versions”
ToolCodex
Version3.20.4（受影响版本）；v4.0.0 已修复
PlatformsmacOSWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 2 real issues

FAQ

Section titled “FAQ”
What else should I do after upgrading?
On the MCP page, resync the relevant servers to clear the old `type` field.
Section titled “Related problems”
Codex config.toml Overwritten by CC Switch, Plugins and Settings LostUpgrade to cc-switch v4.0.0; it removes full backup restoration and replaces only key fields when switching, preserving other Codex settings.7 issues merged[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 mergedAbsolutePathBuf deserialized without a basemacOS Codex Desktop users can set model_catalog_json in config.toml to the absolute path of the model catalog file.2 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.