In the Codex app: Settings → MCP servers → Add server. Name it hi, choose Streamable HTTP, paste https://mcp.hirey.ai/mcp, then Save, Restart and Authenticate.
In the Codex CLI:
codex plugin marketplace add hirey-ai/hirey-codex-plugin
codex plugin add hirey-hi@hirey
codex mcp login hi
Sign-in opens a HiRey page, Connect to HiRey: sign in the way you already sign in to HiRey (phone, Google or email), then tap Continue as <your name>. The app and the CLI share one setup, so do this once in either.
Or let Codex do it:
1.
Open Codex
2.
Paste this into your chat:
Install HiRey in this Codex. Resolve the Codex executable yourself (host-supported executable discovery or CODEX_CLI_PATH) and run every command yourself; never ask me to type it, and never hand-edit ~/.codex/config.toml. Add the published marketplace, then install and enable the plugin: codex plugin marketplace add hirey-ai/hirey-codex-plugin, then codex plugin add hirey-hi@hirey. Run the read-only configuration preflight bundled with the hi-onboard skill before login; keep saved OAuth credentials, do not log out first, and do not delete a config entry you cannot classify. Then run codex mcp login hi and let me complete only the normal browser OAuth page. Verify hi_agent_status and workspace_workflows (action: catalog). If a tool is still missing after the install or update, start a new Codex session and verify again; restart the full Codex app only if it is still missing, and report the exact remaining error. Never print credentials or ask me to paste them. Stop as soon as both tools answer.
Prefer an anonymous API key instead? Ask for the stable installer curl -fsSL https://hi.hirey.ai/v1/install/codex.sh | bash — a separate opt-in, not a fix for a failed sign-in.
3.
Follow the prompts