Connect AI to your WordPress site
Lenora turns your WordPress site into an MCP server, so AI apps such as Claude, Claude Desktop, Claude Code, Cursor and VS Code can read, build and manage it for you. This guide covers installing it, activating it, and every way to connect an AI app.
01Before you start
You need:
- WordPress 6.9 or later. Lenora uses WordPress's built-in Abilities API.
- PHP 8.0 or later.
- An administrator account on the site.
- HTTPS (an SSL certificate). WordPress only offers Application Passwords over HTTPS, and Lenora's password-free sign-in needs it too. On a local development site, add
define('WP_ENVIRONMENT_TYPE', 'local');towp-config.phpinstead. - Node.js on your computer, only if you connect Claude Desktop or another app that runs a local command. Claude.ai, Claude Code, Cursor and VS Code don't need it.
A connected AI app works as the administrator who connected it. Lenora starts in a safe mode (no code, file or plugin changes), but treat it like giving someone your admin login.
The screenshots in this guide show the example address yoursite.com. Your screens show your own site's address.
02Install Lenora
- Download
lenora.zipfrom kitpapa.com. Don't unzip it. - In WordPress, go to Plugins → Add Plugin and click Upload Plugin at the top.
- Click Choose file, select
lenora.zip, and click Install Now.
Unzip lenora.zip and upload the lenora folder to wp-content/plugins/. Then activate it from the Plugins page.
Upload the new zip the same way. When WordPress says the plugin is already installed, click Replace current with uploaded. Your settings and connections are kept.
03Activate Lenora
- When WordPress shows Plugin installed successfully, click Activate Plugin.
- Lenora now appears in the admin menu, right under Dashboard. Click it to open the Connect page.
Lenora is free, and there is no licence key to enter. The first time you open wp-admin after activating, it registers this site with Kitpapa automatically, so WordPress can show Update available when a new version is out. See Licence and updates.
04Switch on connections
For safety, Lenora starts switched off: no AI app can connect until you allow it. The panel at the top of Lenora → Connect is highlighted while it is off.
- Turn on the switch AI apps cannot connect. It changes to AI apps can connect.
- That's all. The change saves by itself, and Saved appears on the right. There is no Save button to press.
The panel has two switches:
| Switch | What it does |
|---|---|
| AI apps can connect | The master switch. While it is off, every connection stops at once, including apps you approved before. Turn it off any time you want to cut all access. |
| Sign in without a password | On by default. Lets Claude.ai and other apps connect with just your site's address: you approve each one on a WordPress page. Needs HTTPS. Turn it off if you only want Application Password connections. |
05Which way to connect
On Lenora → Connect, click your app under Pick your app. The page shows that app's steps, fills in your site's details, and gives every code block a Copy button. Pick the one you use:
mcp.json.Application Password
VS CodeFor GitHub Copilot's agent mode. Add an entry to mcp.json.Application Password
Any other MCP clientOver HTTP with a header, or as a local command.Application Password
A separate password WordPress makes for one app. It can't be used to log in to wp-admin, and you can revoke it any time without changing your real password. Lenora creates one for you with the Create Application Password button. WordPress shows it only once, so copy your settings straight away. Lenora fills it in for you and never sends or stores it.
Your site's MCP address (the server address) is always:
https://yoursite.com/wp-json/lenora/v1/mcp
It's shown on the right of the Connect page with a Copy address button.
Claude.ai and the Claude apps (no password)
Works in Claude on the web, in the Claude desktop app and in the mobile apps. It uses OAuth sign-in, so there is no password or config file. It needs Sign in without a password on, HTTPS, and a site that is reachable from the internet. Your Claude plan must support custom connectors.
- In Lenora, click Claude.ai and Claude apps and copy the address with Copy.
- In Claude, open Settings → Connectors and choose Add custom connector.
- Give it a name, such as Lenora, paste the address and add it. Then click Connect.
- A page from your WordPress site opens. Log in if asked, check the app name, and click Approve.
- You're sent back to Claude, and Lenora's tools are ready. The app is now listed under Apps you approved on the Connect page.
The page lists what the app may do. It matches your Settings: with Full access on, the list says the app has full control; in Read-only mode, it says the app can change nothing.
Claude Desktop: one click
The quickest way to connect the Claude Desktop app. It needs Node.js on your computer.
- Click Claude Desktop, then Add to Claude Desktop. A file named like
lenora-yoursite-com.mcpbdownloads. - Double-click the file, or drag it into Claude Desktop, and click Install.
- Start a new chat and ask: "What is my site info?"
Each click creates a new Application Password and puts it in the file. Delete the file once it's installed. You can revoke the password any time in Users → Profile.
Claude Desktop: by hand
Use this if the one-click file doesn't suit you, for example on a managed computer. It also needs Node.js.
- On the Claude Desktop tab, open Set it up by hand instead and click Create Application Password. The settings below fill themselves in.
- In Claude Desktop, open Settings → Developer → Edit Config. Or open the file directly:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
- Copy the settings from Lenora. If the file is empty, replace everything in it. If it already lists servers, add the
lenora-…entry inside"mcpServers"next to them, separated by a comma. Save the file. - Fully quit Claude Desktop, including from the system tray, and open it again.
The entry looks like this. Copy yours from the Connect page, where the username and password are already filled in:
{
"mcpServers": {
"lenora-yoursite-com": {
"command": "npx",
"args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
"env": {
"WP_API_URL": "https://yoursite.com/wp-json/lenora/v1/mcp",
"WP_API_USERNAME": "your-wordpress-username",
"WP_API_PASSWORD": "your-application-password",
"NODE_OPTIONS": "--max-http-header-size=131072"
}
}
}
}Keep the NODE_OPTIONS line: some servers send very large headers, and without it the connection fails with "Headers Overflow". Don't add this entry if you already installed the one-click file for the same site, or Claude shows the site twice.
Claude Code
Claude Code connects with one terminal command, using an Application Password or the password-free sign-in.
With an Application Password
- Click Claude Code, then Create Application Password.
- Copy the command under Run this in your terminal and run it. It adds Lenora for all your projects.
- Start a new Claude Code session and run
/mcpto check that Lenora is connected.
claude mcp add --transport http --scope user lenora-yoursite-com https://yoursite.com/wp-json/lenora/v1/mcp --header "Authorization: Basic <filled in for you>"
Without a password
- Run the command under Or sign in without a password. It adds the server without a header:
claude mcp add --transport http --scope user lenora-yoursite-com https://yoursite.com/wp-json/lenora/v1/mcp
- In a Claude Code session, run
/mcp, picklenora-yoursite-comand choose Authenticate. - Your site's approval page opens in the browser. Click Approve.
Claude Code saves the server in ~/.claude.json (Windows: %USERPROFILE%\.claude.json).
Cursor
- Click Cursor, then Create Application Password.
- Open Cursor's MCP file, or create it if it doesn't exist:
- All projects:
~/.cursor/mcp.json(Windows:%USERPROFILE%\.cursor\mcp.json) - One project:
.cursor/mcp.jsoninside that project
- All projects:
- Copy the settings from Lenora and put the entry inside
"mcpServers", next to any servers already there. Save. - Open Cursor's MCP settings and check that
lenora-yoursite-comshows as connected.
{
"mcpServers": {
"lenora-yoursite-com": {
"url": "https://yoursite.com/wp-json/lenora/v1/mcp",
"headers": {
"Authorization": "Basic <filled in for you>"
}
}
}
}VS Code
Use Lenora from GitHub Copilot Chat's agent mode.
- Click VS Code, then Create Application Password.
- In VS Code, run MCP: Open User Configuration from the Command Palette. Or use
.vscode/mcp.jsoninside one project. - Copy the settings from Lenora and put the entry inside
"servers", next to any servers already there. Save. - Start the server from the config file or the MCP Servers view, then use it in Copilot Chat's agent mode.
{
"servers": {
"lenora-yoursite-com": {
"type": "http",
"url": "https://yoursite.com/wp-json/lenora/v1/mcp",
"headers": {
"Authorization": "Basic <filled in for you>"
}
}
}
}Any other MCP client
Lenora is a standard MCP server, so any client that supports MCP can connect, such as Windsurf, Cline, Zed or your own agent.
Over HTTP (Streamable HTTP)
Point the client at the server address and send the Authorization header with every request. Copy both from the Connect page after Create Application Password.
URL: https://yoursite.com/wp-json/lenora/v1/mcp Authorization: Basic <filled in for you>
If the client supports OAuth sign-in, give it just the URL instead: it finds Lenora's sign-in page itself, and you click Approve as for Claude.ai.
As a local command (STDIO)
For clients that only run local commands, use the WordPress bridge. It needs Node.js.
WP_API_URL=https://yoursite.com/wp-json/lenora/v1/mcp WP_API_USERNAME=your-wordpress-username WP_API_PASSWORD=your-application-password NODE_OPTIONS=--max-http-header-size=131072 npx -y @automattic/mcp-wordpress-remote@latest
WP_API_URL must be the full server address above, ending in /lenora/v1/mcp. With only the site address, the bridge looks for a different endpoint and can't find Lenora.
06Test the connection
Start a new chat or session in your AI app and ask:
What is my site info?
The app calls Lenora's site-info tool and answers with your site's name, address, WordPress and PHP versions and active theme. If it does, you're connected. Some good first requests:
- "List my last 10 posts and tell me which have no featured image."
- "Draft a page called About us with three sections." New posts and pages are created as drafts.
- "Audit this site and tell me what needs attention."
If it can't connect, run the status check.
07Manage and disconnect
- Cut every connection at once: turn off AI apps can connect on the Connect page. Turn it on again later and the connections work again.
- Disconnect one password-free app (Claude.ai, or Claude Code with Authenticate): click Disconnect next to it under Apps you approved. It stops immediately.
- Disconnect an app that uses an Application Password (Claude Desktop, Cursor, VS Code, others): go to Users → Profile, scroll to Application Passwords, and click Revoke next to it. Lenora names each password after the app and date it was made for.
08Settings and safety
Lenora → Settings decides how much connected apps may do.
| Setting | Default | What it does |
|---|---|---|
| Full access | Off | Lets apps run PHP and WP-CLI, write and delete files, install and manage plugins and themes, change any setting, manage users and open wp-admin. This is full control of the site. Without it, apps can read the site and create and edit content, menus and categories. |
| Read-only mode | Off | Apps can look at everything and change nothing, even with Full access on. Good for audits, reports and live sites. |
| Tools from other plugins | Off | Also offers the AI tools other plugins provide. Some of them run code or delete files, and Lenora's switches don't control them. |
| Ghost mode | Off | Hides Lenora from every other user: it leaves the Plugins list and the admin menu, and only you can connect. To switch it off without your account, add define('LENORA_GHOST_OFF', true); to wp-config.php. |
Click Save changes after changing these. Apps pick up the new tools when they reconnect or start a new chat.
- PHP files must pass a syntax check before they're written, so a typo can't take the site down.
wp-config.php,.htaccess,.user.iniandphp.inican't be written or deleted.- WordPress core folders can't be deleted, and Lenora can't deactivate or delete itself.
- Upload and login links work once and expire.
Connected apps can't read wp-config.php or any copy of it, .env files, database dumps, backup files or the .git folder. Passwords, API keys, tokens and licence keys in settings and in the database come back as [hidden], and apps are told never to copy secrets anywhere. With Full access on, Run PHP can still read anything, so keep Full access off on live sites.
The bottom of the Settings page also shows your site's design system (colors, fonts and spacing), once you ask your AI app to create one.
09Tools and skills
Lenora → Tools lists every tool connected apps have right now, grouped by what they do. The list changes with your Settings.
| Group | Examples |
|---|---|
| Always available | Site info; list, read, create and edit posts and pages; custom fields (including Elementor layouts); settings; plugins list; read files; read-only database queries; media; users; categories and tags; menus; scheduled tasks; skills. |
| Page builders | Every Elementor widget on the site, from Elementor and all its add-ons, with exact settings; Elementor global colors and fonts; Bricks elements; the design system. |
| With Full access | Run PHP; run WP-CLI; write, edit and delete files; install, activate and delete plugins and themes; change settings; database changes; import media; create users; clear caches; one-time upload and admin login links. |
Skills are step-by-step instructions the app loads before a matching task. Lenora ships six: Elementor page building, Elementor add-on widgets, Bricks building, design system, plugin development and site audit. Add your own under Lenora → Skills, or ask the app to save a procedure as a skill.
10Status check and fixes
If an app won't connect, open Lenora → Status and click Run the status check. It tests your server the way AI apps reach it, and gives a plain-language fix for every problem it finds.
Common problems
| You see | Fix |
|---|---|
| 403 "Lenora is turned off" | Turn on AI apps can connect at the top of Lenora → Connect. |
| 401 Unauthorized | Check the username and Application Password. Some Apache hosts drop the login header; add this line to .htaccess:SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1 |
| No Application Passwords section, or the Create button is greyed out | The site needs HTTPS. On a local site, add define('WP_ENVIRONMENT_TYPE', 'local'); to wp-config.php. |
| Claude.ai can't add the connector | Check that Sign in without a password is on, the site uses HTTPS, and it's reachable from the internet (not only on your computer or behind a login wall). |
| "Headers Overflow" in Claude Desktop | Keep the NODE_OPTIONS line in the config, or reinstall with the one-click file, which includes it. |
| Claude Desktop shows no Lenora tools | Install Node.js, then fully quit and reopen Claude Desktop. Check that the config file is valid JSON (no missing commas). |
| Plugin installs ask for FTP details | Add define('FS_METHOD', 'direct'); to wp-config.php if your host allows it. |
11Licence and updates
Lenora is free and needs no licence key. The first time an administrator opens wp-admin after activating it, the site gets a free licence from Kitpapa's licence server automatically. That gives you a normal Update available row on the Plugins page whenever a new version is out. Reinstalling on the same site gets the same licence back.
- To get its free licence, Lenora sends the site's address and the Lenora version to Kitpapa's licence server.
- After you turn on AI apps can connect, Kitpapa also collects the site's admin email (and again if it changes).
- If the licence server can't be reached, Lenora works normally and tries again an hour later.
You can see the licence under About this install on Lenora → Status.
12Lenora Pro
Lenora Pro is a paid add-on that adds memory, undo, approvals, an activity log, and tools for WooCommerce, SEO, ACF, Contact Form 7 and Kirki. It runs on top of the free Lenora, so keep Lenora installed and active.
- Install and activate Lenora first (sections 2 and 3).
- Upload
lenora-pro.zipthe same way, under Plugins → Add Plugin → Upload Plugin, and activate it. If Lenora is missing, Lenora Pro shows a Lenora is required screen that installs it for you in one click. - Open Lenora → Pro licence, paste the licence key from your purchase email, and click Activate.
Each site you activate keeps its place on your licence permanently. There is no deactivating, so check you're on the right site before you click Activate. Re-activating the same site later never uses another place.
13Questions
Does Lenora have WP-CLI commands?
Lenora doesn't add its own wp commands. With Full access on, a connected AI app can run normal WP-CLI commands for you through the Run WP-CLI tool. This needs WP-CLI installed on the server and a host that lets PHP start processes. If WP-CLI isn't on the server's PATH, set its location with define('KITPAPA_MCP_WP_CLI', '/path/to/wp'); in wp-config.php.
Can I connect more than one app?
Yes. Connect as many as you like, each with its own Application Password or approval, and disconnect each one separately.
Will the AI publish things without asking?
New posts and pages are created as drafts unless you ask for another status. The app acts with your account's permissions, so start with Full access off, and use Read-only mode on live sites.
I connected before Lenora was renamed. Do I need to reconnect?
No. The old address /wp-json/kitpapa-mcp/v1/mcp still works, so existing connections keep running.
Where do I get help?
Run the status check first: it explains most problems. For anything else, contact Kitpapa through kitpapa.com.