Add Mosyn to OpenAI Codex
Steps
- Install the Mosyn plugin. It adds Mosyn and a skill that teaches Codex how to build a good study set.
- Or add only the connector. Codex notices that Mosyn uses sign-in and starts it right away.
- If the sign-in didn't start, run the login command.
Commands
codex plugin marketplace add ponderingBGI/mosyn-plugincodex plugin add mosyn@mosyncodex mcp add mosyn --url https://mosyn.lycatra.com/mcpcodex mcp login mosyncodex mcp listOr add it to the config file
[mcp_servers.mosyn]
url = "https://mosyn.lycatra.com/mcp"Sign in and approve
- On your computerSign inCodex opens Mosyn's approval page in the browser and listens on a local port for the result.
- On your phoneApprove on your phoneMosyn's approval page shows a QR code. Scan it with your phone, or in Mosyn open Settings → Connect an assistant → Have a code? and type the code shown.
Check that it worked
`codex mcp list` (or `/mcp` in the TUI) shows mosyn with its tools.
If something goes wrong
| What you see | What to do |
|---|---|
| “The mosyn MCP server is not logged in. Run `codex mcp login mosyn`” | Run `codex mcp login mosyn`. |
| Sign-in on a remote or headless machine never completes. | Set `mcp_oauth_callback_port` (and, if needed, `mcp_oauth_callback_url`) at the top of config.toml, or sign in on a machine with a browser. |
| An older guide says to set `experimental_use_rmcp_client = true`. | Not needed any more. Update Codex instead. |