- Open the dashboard and choose OpenAI desktop / Codex.
Select the WordPress site you want to connect. Respira generates the exact remote MCP server name and URL for that site.
- Run the first command in Terminal.
The
codex mcp addcommand registers the selected site. It does not contain an API key and leaves your other Codex MCP servers in place.codex mcp add respira-my-site --url https://yoursite.com/wp-json/respira/v1/mcp - Run the second command and approve access.
The
codex mcp logincommand opens your browser. Sign in to Respira, review the requested read and write access, then choose Approve.codex mcp login respira-my-site - Confirm the connection.
Restart the OpenAI desktop app or reopen Codex if the tools do not appear immediately, then ask: list the MCP servers currently loaded.
- Ask Codex to edit a site.
Try: using Respira, list the last three WordPress pages I edited and tell me which builder they use.
Prefer manual TOML?
Codex reads from ~/.codex/config.toml. The first command writes the equivalent
remote-server entry below. After adding it manually, still run
codex mcp login respira-my-site to authenticate:
[mcp_servers.respira-my-site]
url = "https://yoursite.com/wp-json/respira/v1/mcp" The browser sign-in does not open or finish.
-
Run
codex mcp login respira-my-siteagain using the exact server name from the first command. -
Check that the WordPress site is online and its
/wp-json/address is not blocked by a firewall. - In WordPress, open Settings → Permalinks, choose Post name, and save once if the MCP address returns 404.
- Remove and re-add the server if the saved URL points to a different site.
Things to ask Codex, once it is connected
- using respira-wordpress, list my connected sites and which builder each one runs
- on site A, scan the homepage for accessibility issues and list WCAG violations
- duplicate the pricing page on site B and change every price ending in 99 to 95
- find every page that still mentions the old company name and list them with URLs
- translate the menu titles on site C into Spanish and save as a new menu
- show the last ten snapshots on site D and roll back the one at 11pm last night
- build me a shortlist of pages that load slower than 2 seconds on mobile
Every write lands as a duplicate or draft. Codex asks before each tool call, so you stay in control.
Why Codex plus Respira fits
- Codex is a fast CLI agent. Respira is a patient WordPress backend. Together you can edit production sites without slowing the agent down for confirmation pings.
- OAuth instead of copied secrets. Add each site with two standard Codex commands, then approve it in your browser. No WordPress API key is stored in Codex config.
- 320+ tools. Full read/write across posts, pages, menus, ACF, Woo catalog, media. Codex can plan a multi-page refactor and execute it.
- Snapshots on every write. Codex loops move fast. Respira keeps a safety net so rollback is one sentence away.