Lenora Documentation
Lenora Documentation Version 0.9.2

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.

WordPress 6.9+ PHP 8.0+ Free, no licence key 7 ways to connect

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'); to wp-config.php instead.
  • 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.
Use a development or staging site, and keep backups

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

  1. Download lenora.zip from kitpapa.com. Don't unzip it.
  2. In WordPress, go to Plugins → Add Plugin and click Upload Plugin at the top.
  3. Click Choose file, select lenora.zip, and click Install Now.
Plugins → Add Plugin → Upload Plugin, with lenora.zip chosen.
Plugins → Add Plugin → Upload Plugin, with lenora.zip chosen.
Installing by FTP or File Manager instead

Unzip lenora.zip and upload the lenora folder to wp-content/plugins/. Then activate it from the Plugins page.

Updating an older copy

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

  1. When WordPress shows Plugin installed successfully, click Activate Plugin.
The upload finished. Click Activate Plugin.
The upload finished. Click Activate Plugin.
  1. Lenora now appears in the admin menu, right under Dashboard. Click it to open the Connect page.
Lenora is active and has its own menu.
Lenora is active and has its own menu.

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.

A new install: "AI apps cannot connect", with the switch on the left off.
A new install: "AI apps cannot connect", with the switch on the left off.
  1. Turn on the switch AI apps cannot connect. It changes to AI apps can connect.
  2. That's all. The change saves by itself, and Saved appears on the right. There is no Save button to press.
Both switches on. The change saves straight away.
Both switches on. The change saves straight away.

The panel has two switches:

SwitchWhat it does
AI apps can connectThe 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 passwordOn 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.
The Connect page with connections on. Pick your app, then follow its steps.
The Connect page with connections on. Pick your app, then follow its steps.

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:

What is an 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.

Lenora → Connect → Claude.ai and Claude apps.
Lenora → Connect → Claude.ai and Claude apps.
  1. In Lenora, click Claude.ai and Claude apps and copy the address with Copy.
  2. In Claude, open Settings → Connectors and choose Add custom connector.
  3. Give it a name, such as Lenora, paste the address and add it. Then click Connect.
  4. A page from your WordPress site opens. Log in if asked, check the app name, and click Approve.
The approval page on your own site. Approve lets the app act as you; Deny cancels.
The approval page on your own site. Approve lets the app act as you; Deny cancels.
  1. 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.
An approved app, with the user it acts as and a Disconnect link.
An approved app, with the user it acts as and a Disconnect link.

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.

Lenora → Connect → Claude Desktop.
Lenora → Connect → Claude Desktop.
  1. Click Claude Desktop, then Add to Claude Desktop. A file named like lenora-yoursite-com.mcpb downloads.
  2. Double-click the file, or drag it into Claude Desktop, and click Install.
  3. Start a new chat and ask: "What is my site info?"
Keep the file private

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.

  1. On the Claude Desktop tab, open Set it up by hand instead and click Create Application Password. The settings below fill themselves in.
  2. 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
  3. 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.
  4. Fully quit Claude Desktop, including from the system tray, and open it again.
The "by hand" steps with the settings filled in. The password shown here is a placeholder.
The "by hand" steps with the settings filled in. The password shown here is a placeholder.

The entry looks like this. Copy yours from the Connect page, where the username and password are already filled in:

claude_desktop_config.json
{
  "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.

Lenora → Connect → Claude Code, after Create Application Password.
Lenora → Connect → Claude Code, after Create Application Password.

With an Application Password

  1. Click Claude Code, then Create Application Password.
  2. Copy the command under Run this in your terminal and run it. It adds Lenora for all your projects.
  3. Start a new Claude Code session and run /mcp to check that Lenora is connected.
Terminal (the Connect page fills in the Authorization value)
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

  1. 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
  1. In a Claude Code session, run /mcp, pick lenora-yoursite-com and choose Authenticate.
  2. Your site's approval page opens in the browser. Click Approve.

Claude Code saves the server in ~/.claude.json (Windows: %USERPROFILE%\.claude.json).

Cursor

Lenora → Connect → Cursor.
Lenora → Connect → Cursor.
  1. Click Cursor, then Create Application Password.
  2. 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.json inside that project
  3. Copy the settings from Lenora and put the entry inside "mcpServers", next to any servers already there. Save.
  4. Open Cursor's MCP settings and check that lenora-yoursite-com shows as connected.
mcp.json
{
  "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.

Lenora → Connect → VS Code.
Lenora → Connect → VS Code.
  1. Click VS Code, then Create Application Password.
  2. In VS Code, run MCP: Open User Configuration from the Command Palette. Or use .vscode/mcp.json inside one project.
  3. Copy the settings from Lenora and put the entry inside "servers", next to any servers already there. Save.
  4. Start the server from the config file or the MCP Servers view, then use it in Copilot Chat's agent mode.
mcp.json
{
  "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.

Lenora → Connect → Another MCP client. The password shown here is a placeholder.
Lenora → Connect → Another MCP client. The password shown here is a placeholder.

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.

The right column of the Connect page: the server address, your approved apps, and the status check.
The right column of the Connect page: the server address, your approved apps, and 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.
Users → Profile → Application Passwords. Revoke ends that app's access.
Users → Profile → Application Passwords. Revoke ends that app's access.

08Settings and safety

Lenora → Settings decides how much connected apps may do.

Lenora → Settings, as a new install starts: everything off.
Lenora → Settings, as a new install starts: everything off.
SettingDefaultWhat it does
Full accessOffLets 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 modeOffApps can look at everything and change nothing, even with Full access on. Good for audits, reports and live sites.
Tools from other pluginsOffAlso offers the AI tools other plugins provide. Some of them run code or delete files, and Lenora's switches don't control them.
Ghost modeOffHides 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.

Safety rails that stay on, even with Full access
  • 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.ini and php.ini can'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.
Secrets stay hidden

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.

Lenora → Tools. The note at the top says which tools Full access would add.
Lenora → Tools. The note at the top says which tools Full access would add.
GroupExamples
Always availableSite 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 buildersEvery 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 accessRun 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.

Lenora → Status after a check, with About this install below.
Lenora → Status after a check, with About this install below.

Common problems

You seeFix
403 "Lenora is turned off"Turn on AI apps can connect at the top of Lenora → Connect.
401 UnauthorizedCheck 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 outThe site needs HTTPS. On a local site, add define('WP_ENVIRONMENT_TYPE', 'local'); to wp-config.php.
Claude.ai can't add the connectorCheck 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 DesktopKeep the NODE_OPTIONS line in the config, or reinstall with the one-click file, which includes it.
Claude Desktop shows no Lenora toolsInstall 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 detailsAdd 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.

  1. Install and activate Lenora first (sections 2 and 3).
  2. Upload lenora-pro.zip the 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.
  3. Open Lenora → Pro licence, paste the licence key from your purchase email, and click Activate.
Lenora → Pro licence, before a key is entered.
Lenora → Pro licence, before a key is entered.
One licence, up to 100 sites, each one for good

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.

Lenora 0.9.2 documentation · Made by Kitpapa. Claude, Cursor and VS Code are trademarks of their respective owners.

All unique and catchy templates just at $59