OpenAI
Connect Codex
OpenAI's coding agent, with your pod as context.
Directly to your pod
RecommendedExpected to workchecked 1 Sept 2026The client supports what Synap needs; we have not run this path end to end recently.
- Install the Synap CLI and sign in.
npm install -g @synap-core/cli && synap login - Print your pod's MCP URL and an agent key.
synap mcp url --client codex - Add them to Codex as a remote MCP server (URL + Authorization header) in its config file, ~/.codex/config.toml.
Other ways to connect
With the Synap CLIExpected to workchecked 24 Sept 2026
- Install the Synap CLI and sign in.
npm install -g @synap-core/cli && synap login - Write the client's MCP config and mint a dedicated agent key for your pod.
synap mcp connect codex - Check the connection any time.
synap mcp verify
`synap mcp connect codex` wrote ~/.codex/config.yaml, but Codex reads ~/.codex/config.toml. Fixed in the Synap CLI; available in the next release.
If something goes wrong
`synap mcp connect codex` finishes but Codex shows no Synap tools.
Released CLI versions write ~/.codex/config.yaml, which Codex does not read. Until the next release, add the server to ~/.codex/config.toml by hand.
Menus in other apps move; each way to connect shows the day its steps were last checked.