Skip to content

Documentation inconsistency for config + MCP startup silently fails #4531

@varunursekar

Description

@varunursekar

What version of Codex is running?

codex-cli 0.42.0

Which model were you using?

gpt-5

What platform is your computer?

Darwin 24.6.0 arm64 arm

What steps can reproduce the bug?

Run codex --help and you will see that the documentation says that config overrides should be in JSON format.

Image

If you look at this section of the README on Github on the other hand, it says you should use TOML format.

I tried using JSON to configure and instantiate an MCP server at run time. Start up of the server failed silently, which is perhaps the more worrying bug.

What is the expected behavior?

No response

What do you see instead?

No response

Additional information

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions