Connect Codex
Install the Piyaz plugin in Codex over a hosted MCP server with OAuth.
Piyaz is hosted at app.piyaz.ai. The plugin installs into Codex once, at the user level, and works in every project you open. No clone required. Run the one-time install, then sign in when prompted (OAuth, once per machine).
Add the marketplace and install
Add the Piyaz marketplace:
codex plugin marketplace add FrkAk/piyazOpen Codex, run /plugin, install Piyaz, restart, and authenticate when prompted. Invoke the main skill with $piyaz.
If your Codex build can't resolve the root marketplace, append --sparse plugins to the command above.
Authenticate
Codex connects to the hosted MCP server over HTTP and runs OAuth on first use. Sign in when Codex prompts you. Authentication is once per machine.
The plugin ships this MCP config:
{
"mcpServers": {
"piyaz": { "type": "http", "url": "https://app.piyaz.ai/api/mcp" }
}
}Verify
Ask Codex:
$piyaz List my projects.Codex returns your project list. An empty list is expected on a fresh account.
Self-host
The plugin ships one MCP server, piyaz, pointing at the hosted app. To use your own server, start it and register a second server alongside it, then sign in:
codex mcp add piyaz-self-hosted --url http://localhost:3000/api/mcp
codex mcp login piyaz-self-hostedBoth commands work the same on macOS, Windows, and Linux. Codex writes an [mcp_servers.piyaz-self-hosted] entry to ~/.codex/config.toml, or %USERPROFILE%\.codex\config.toml on Windows, or $CODEX_HOME/config.toml if you set that variable. Swap http://localhost:3000 for your own origin if you run Piyaz elsewhere, and serve it over HTTPS unless it is on localhost.
Do not edit the plugin's own .mcp.json; it lives in a version-scoped cache directory that the next plugin update overwrites. For running the server itself, see the self-host guide.
What gets installed
- The 9 MCP tools that give your agent direct access to the project graph. See the MCP overview.
- The
/piyazskill. - The workflow skills: brainstorm, decompose, decompose-feature, decompose-task, manage, onboarding, and review.
composer (end-to-end task orchestration) and the dispatchable agents are Claude Code only. Codex ships the skills above and runs each phase inline. For the composer loop, use Claude Code.
Last updated