diviops

DiviOps — Setup Guide

Get from zero to generating Divi 5 pages with Claude Code in ~15 minutes.

Beta software. DiviOps is under active development. Use on production sites at your own discretion. Always back up your WordPress site before running write operations.

Prerequisites

• WordPress 6.0+ with Divi 5 theme (5.1.0+)
• Node.js 18+ (for the MCP server)
• Claude Code CLI installed
• A local or remote WordPress site (Local by Flywheel recommended for local dev)

Step 1: Install the WordPress Plugin

1. In this repo, zip the plugin directory:

   cd wp-content/plugins
   zip -r diviops-agent.zip diviops-agent/
   

2. Go to WP Admin → Plugins → Add New → Upload Plugin
3. Upload diviops-agent.zip and activate it
4. Verify: visit http://your-site.local/wp-json/diviops/v1/settings — you should get a 401 (auth required)

If Divi is not active, authenticated requests return 503 divi_unavailable. Unauthenticated requests return 401 first.

Step 2: Create an Application Password

1. Go to WP Admin → Users → Your Profile
2. Scroll to Application Passwords
3. Enter a name (e.g., "Claude MCP") and click Add New Application Password
4. Copy the generated password (spaces are fine)

Save this — you won't see it again.

Step 3: Build the MCP Server

cd diviops-server
npm install
npm run build

Verify: ls dist/index.js should exist.

Step 4: Register with Claude Code

First, find the absolute path to the MCP server:

cd diviops-server && echo "$(pwd)/dist/index.js"

Copy that path — you'll need it below.

Important: Choose a unique MCP name that won't conflict with other MCP servers you have registered. Use your site name (e.g., diviops-mysite).

Minimal (REST API only — works with any WordPress host)

claude mcp add diviops-mysite -- env \
  WP_URL=http://your-site.local \
  WP_USER=your-username \
  WP_APP_PASSWORD=xxxxXXXXxxxxXXXXxxxxXXXX \
  node /Users/you/projects/diviops-server/dist/index.js

With WP-CLI (Local by Flywheel — enables the diviops_wp_cli tool)

claude mcp add diviops-mysite -- env \
  WP_URL=http://your-site.local \
  WP_USER=your-username \
  WP_APP_PASSWORD=xxxxXXXXxxxxXXXXxxxxXXXX \
  WP_PATH="/Users/you/Local Sites/your-site/app/public" \
  node /Users/you/projects/diviops-server/dist/index.js

LOCAL_SITE_ID is auto-detected from WP_PATH — no need to find it manually.

Common Pitfalls

• Strip spaces from the app password — WordPress generates passwords like 758r WQ1X URcg GW3s wCwQ QI0V with spaces. Remove the spaces when using claude mcp add: WP_APP_PASSWORD=758rWQ1XURcgGW3swCwQQI0V. WordPress accepts both formats, but claude mcp add can misparse the spaces as separate arguments.
• Use absolute paths for both WP_PATH and the node script — relative paths break when Claude Code runs from a different directory
• Unique MCP name — don't reuse a name from another project (e.g., if you have directus-mcp, don't name this one the same)
• Paths with spaces — directories like Local Sites/my site work as long as they're quoted
• MCP not appearing after registration — run claude mcp list to verify. If it's not there, claude mcp remove and re-add. Fully restart Claude Code (not just the window) after adding.

Step 5: Verify Registration

Before restarting Claude Code, confirm the registration:

claude mcp list

You should see your MCP server listed with the correct env vars. If anything looks wrong, remove and re-add:

claude mcp remove diviops-mysite
claude mcp add diviops-mysite -- env ...

Step 6: Test Connection

Restart Claude Code (or open a new window), then run:

Use diviops_test_connection to verify the MCP is working.

You should see your site URL, WordPress version, and Divi version.

Then try:

Use diviops_list_pages to show all pages.

If tools don't appear: Check claude mcp list output. The node path must be absolute and the dist/index.js file must exist (run npm run build first).

Step 7: Optional — Install the Design Library Plugin

For CSS entrance animations (ddl-fade-up, ddl-scale-in), gradient text effects, and Three.js WebGL shaders:

cd wp-content/plugins
zip -r diviops-design-library.zip diviops-design-library/

Upload and activate in WP Admin. This is optional — the MCP agent works without it.

Step 8: Load the Divi 5 Builder Skill

The skill teaches Claude the correct Divi 5 block format — module attribute paths, design patterns, and format rules. Without it, Claude will guess attribute formats and produce broken pages (e.g., empty buttons, wrong innerContent format).

Option A — Install as a Claude Code plugin (recommended):

claude plugin install oaris-dev/diviops