Desktop app does not expose local stdio MCP server until cwd is set explicitly
What version of the Codex App are you using (From “About Codex” dialog)?
26.309.31024 (962)
What subscription do you have?
Pro
What platform is your computer?
Darwin 25.3.0 arm64 arm
What issue are you seeing?
A local stdio MCP server for Laravel Boost was not exposed inside the Codex app, even though the server itself was valid and startable.
The same setup worked after I added a project-local .codex/config.toml with:
- an explicit
cwd - an absolute PHP path
So this looks like a Codex app MCP config / workspace startup context issue rather than a Laravel Boost server failure.
What steps can reproduce the bug?
- Use a Laravel project with
laravel/boostinstalled. - Configure Boost MCP in Codex with:
command = phpargs = ["artisan", "boost:mcp"]
- Open the project in the Codex app.
- Observe that Boost tools are not exposed.
- Add a project-local
.codex/config.tomllike this:
[mcp_servers.laravel-boost]
command = "/absolute/path/to/php"
args = ["artisan", "boost:mcp"]
cwd = "/absolute/path/to/project"
enabled = true
- Restart the Codex app / reopen the project.
- Observe that the Boost MCP tools are now exposed correctly.
What is the expected behavior?
If a valid local MCP server is configured for the project, Codex should expose it as a tool without requiring a manual workaround for cwd.
Actual behavior
Laravel Boost MCP was not available in the Codex app until I added a project-local .codex/config.toml with explicit cwd and an absolute PHP path.
Additional information
In my case, the missing cwd seemed to be the key part.
The server itself was not broken:
- php artisan boost:mcp starts cleanly
- the workaround makes the same MCP server work in the Codex app
This suggests the problem is likely in MCP config discovery, config precedence, or workspace launch context in the app.
6 Comments
Potential duplicates detected. Please review them and close your issue if it is a duplicate.
Powered by Codex Action
Possibly related issues
cwdand absolute PHP path.cwd/startup-context case.The bug is still present. Please fix it.
In Codex desktop, MCP returns:
codex clidoes not have such issue.Version 26.324.21641 (1228) - latest for today
Facing same issue too!!
Where codex cli doesn't have such issue
Facing same issue on Codex app:
<img width="798" height="284" alt="Image" src="https://github.com/user-attachments/assets/28b6cb19-84a8-41dc-bdeb-09697d01da1f" />
Codex CLI has no issues:
<img width="1193" height="231" alt="Image" src="https://github.com/user-attachments/assets/8472e043-7351-4446-b5cc-26c67581be68" />
MCP entry on config.toml:
same here, please support mcp.json and relative paths, don't go wrong like claude with claude.md specifics
also remember to support "uniform" paths, so we can specify / separated paths also on windows
and also please add some kind of log file to debug mcp server errors, it's a pain to debug