Start with one WordPress website and one Agent. This walkthrough uses Codex and finishes with a read of an existing page. You do not need to publish content or enable high-impact Abilities to complete it.
Before you begin
- A MoraWP account and access to the Workspace you want to use.
- Administrator access to the WordPress website, with WordPress 6.2 or later and PHP 7.4 or later for MoraWP Plugin 0.2.33.
- Codex CLI installed on your computer. Follow OpenAI's Codex CLI guide if you need to install it.
- An existing page you can identify in WordPress. A test website is a good place to learn the setup before working with customer content.
1. Connect WordPress
In the Dashboard, select the intended Workspace and open Websites → Add a website. Download the MoraWP Plugin ZIP.
In WordPress, open Plugins → Add New Plugin → Upload Plugin. Upload the ZIP, install it, and activate it. Open MoraWP and press Connect.
The approval page opens in MoraWP. Sign in, choose the Workspace, review the request, and confirm. Return to Websites in that Workspace.
Check: your website appears in the list with its connection status. If it does not, follow Connect a website before adding an Agent.
2. Authorize Codex
Open Agents → Connect an Agent in the Dashboard and select Codex. Keep the setup dialog open while you run these commands on your computer:
codex mcp add morawp --url https://api.morawp.com/mcp
codex mcp login morawp
In the browser approval page, review the app, Workspace, website access, and Ability access. Choose Read only for this walkthrough. Read the data-access notice and acknowledge it before approving.
Return to the Dashboard setup dialog and follow its completion prompts.
Check: the authorized connection appears in Agents. For connection problems, use the Codex setup guide.
3. Read one page
Open Abilities in MoraWP and use Manage on the relevant Toolkit to check that the WordPress page listing and reading Abilities are enabled. Keep high-impact Abilities off. If you cannot change that configuration, ask the Workspace owner to review it. The Agent's Read only mode does not override Workspace or website restrictions.
Start Codex. Use /mcp to check that the MoraWP server is available, then send:
Use MoraWP to list the websites this Agent can access. Let me choose one.
On that website, discover the available WordPress read Abilities and inspect
their input schemas. List the existing pages, let me choose a page, then read
its title and content. Do not create, edit, delete, or publish anything.
Choose the connected website and a page from the returned list. Codex should discover the site's available Abilities and use the returned page identifier instead of guessing one.
Check: the returned title matches the page in WordPress. Content may contain HTML or builder data rather than the final visual layout. The page remains unchanged.
Open Activity in MoraWP to find the real Ability execution and its result. Website listing and discovery are not recorded as customer Ability actions.
If you get stuck
| What you see | What to check |
|---|---|
| Website missing from the Agent's list | Confirm the Workspace and the connection's website access. A website being connected does not give every Agent access to it. |
AGENT_ABILITY_MODE_DENIED | Review the Agent's Ability access. Keep this walkthrough read only and choose an available read Ability. |
| Ability not found | Discover the site's current Abilities. Installed Integrations and versions determine what is available. |
WORDPRESS_MORAWP_TOOL_FAILED | Follow WordPress tool failed and inspect the actual response. |
Next steps
Review Abilities before allowing changes, and Activity to understand results and AI Actions. For a different AI app, start with Connect an Agent.