Troubleshooting & FAQ

Troubleshooting #

Claude says it can’t reach / connect to my site #

Local site + claude.ai (cloud): the cloud can’t reach a .local/localhost address. Use a tunnel (e.g. cloudflared) or connect with Claude Code/Desktop on the same machine. See Connecting a local site.
Wrong/expired key: if you regenerated the key, the old MCP URL stopped working. Copy the current MCP URL from Settings → Divi Connect and update the connector.
Not HTTPS: claude.ai requires a reachable https:// URL.
Security plugin / firewall: a WAF or security plugin may block requests. Allow the /wp-json/divi-connect/v1/ routes.

The connector was added but Claude has no tools #

Start a new chat after adding the connector.
Make sure the connector is enabled in Claude’s connector settings.
In Claude Code, run /mcp to confirm divi-connect is listed and connected.

“Invalid Divi Connect key in connector URL” #

The key in your MCP URL doesn’t match the site. Recopy the MCP URL from the settings page (it may have been regenerated or copied incompletely).

Claude built a page but it looks blank or broken #

The plugin validates markup and rejects malformed pages, so a published page should render. If something looks off, ask Claude to rebuild it as a draft and review it in the Divi builder, or tell Claude exactly what’s wrong (“the hero section is empty”) so it can fix the markup.

A Pro feature returns an error / “402” #

That feature (editing colors/variables/presets, Theme Builder, global layouts, WooCommerce pages, or linked size variables) requires Divi Connect Professional. See Free vs Pro.

I changed a size token but my Free-plan page didn’t update #

On Free, size variables are baked into the page at build time. Upgrade to Professional to keep them linked, or ask Claude to rebuild the page. See the explanation here.

I deleted a page by mistake #

Pages are moved to Trash by default (not permanently deleted). Recover it from WordPress → Pages → Trash. Only a page deleted with explicit “permanent” confirmation is unrecoverable.

FAQ #

Does it work with a free Claude account?
Yes. Free claude.ai accounts can add the custom connector and build pages.

Does my site need to be publicly reachable?
For claude.ai (cloud), yes — the connector URL must be reachable over HTTPS. For Claude Code or Claude Desktop on your own machine, a local site works too.

Does it require Divi 5?
Yes. Divi Connect targets the Divi 5 builder (5.7+). It does not work with the Divi 4 / legacy builder.

Is it secure?
Each site has its own secret connector key, shown in Settings → Divi Connect, and you can regenerate it at any time to instantly invalidate the old one. See Security & API Keys.

Will it change or delete my existing design system?
No. Reading the design system never changes it. Editing it (a Pro feature) only happens when you explicitly ask Claude to. Uninstalling the plugin removes only the plugin’s own settings, never your Divi data.

Can I use it on multiple sites?
Yes — install it on each site. Each gets its own connector. Pro 2 / 5 / Unlimited plans cover how many sites can use the Pro features at once.

Can Claude edit a page it already built?
Yes — ask it to make changes and it will update the page. You can also keep editing in the Divi builder as normal.

What happens to my pages if I deactivate the plugin?
Your pages are normal Divi pages — they stay exactly as they are. The plugin only provides the connection; it isn’t required to display pages it built.

Still stuck? #

Re-check Settings → Divi Connect and recopy the current MCP URL.
Try the Quick test curl command on the settings page to confirm the API responds.
Contact support via divilove.com. Never include your full connector URL or API key in a public message — regenerate it first if you think it leaked.

← Security & API Keys · Home