Getting Started

Getting started with RivoPress

1. Install

Upload the plugin zip in Plugins → Add New → Upload, then activate it. RivoPress adds a menu in wp-admin with four pages: Status, Connected Apps, Activity and Approvals.

2. Run the Connect Doctor

Open RivoPress → Status. The Doctor runs 11 checks automatically: HTTPS, permalinks, PHP and WordPress versions, database tables, the REST index, whether your host passes the Authorization header through (the most common MCP failure — the Doctor probes it for you), OAuth discovery, Application Passwords, security-plugin interference, and whether the endpoint has answered at least once. Every failing check names the fix.

3. Connect an AI client

OAuth 2.1 (recommended): point the client at https://yoursite.com/wp-json/rivopress/v1/mcp and approve the scope on your own site. Manual token (best for local tools): create a token under Connected Apps, choose its scope, copy it once, and paste it into your client as a Bearer token.

Scopes

read — read content, run audits and the Doctor. editor — plus create/edit/publish content, SEO and workflows. shop — plus WooCommerce. admin — everything: users, plugins, themes, approvals, backups, multi-site. Scopes always stack with WordPress capabilities — a token can never exceed its user.

4. Your first safe session

Start with a read token and ask your AI to run doctor_run and site_info. Then create an editor token, ask for a small change, and open RivoPress → Activity to see the journaled change — and undo it with one click if you want.