Bearer token is presented as a concrete LemonX MCP capability for admins who want ai clients to inherit wordpress permissions instead of bypassing them.
Auth WordPress-native MCP gateway
Authentication for WordPress.
LemonX MCP uses bearer-token authentication. Each token is bound to a WordPress user, requests run as that user, and every tool remains subject to normal WordPress capability checks. Authenticate MCP clients with bearer tokens bound to WordPress users and normal capability checks.
Rendered for real WordPress use
Admins who want AI clients to inherit WordPress permissions instead of bypassing them.
Version OKAdmins who want AI clients to inherit WordPress permissions instead of bypassing them.
WordPress scenario
Built for real MCP sessions inside production WordPress.
LemonX MCP is intentionally a thin gateway. It owns protocol transport, bearer-token authentication, tool discovery, resources, staged writes and audit records. Page editing, SEO research and translation actions stay inside the plugins that know those domains.
For this page, the practical goal is simple: Authenticate MCP clients with bearer tokens bound to WordPress users and normal capability checks. The operator should be able to understand the value, the safety boundary and the exact WordPress workflow before connecting an AI client.
- Keep the gateway enabled only when a tokened client should connect.
- Bind each token to a WordPress user with the least useful permission set.
- Ask the agent to read site identity before doing site-specific work.
- Use staged previews for write actions and audit logs for accountability.
Scenario: an AI client talks to WordPress through LemonX MCP instead of unsupported raw REST calls.
How it works
POST /wp-json/lemonx-mcp/v1/mcpThe gateway keeps the AI surface predictable and reviewable.
Every MCP session starts with a client, a token, an endpoint and a clear operating manual. LemonX MCP then routes calls through the registry, permissions, feature gates and staging layer.
01
Admin enables the gatewayAdmin enables the gateway02
Admin creates a labeled token bound to a WordPreAdmin creates a labeled token bound to a WordPress user03
Client sends Authorization: Bearer <token>Client sends Authorization: Bearer <token>04
LemonX MCP validates the hash and sets the curreLemonX MCP validates the hash and sets the current user05
Each tool checks the acting user capabilityEach tool checks the acting user capability06
Usage is logged with token contextUsage is logged with token contextKey features
What this page covers in the MCP product system.
These capabilities map to the real LemonX MCP plugin architecture and admin experience, not a generic AI automation promise.
User binding is presented as a concrete LemonX MCP capability for admins who want ai clients to inherit wordpress permissions instead of bypassing them.
WordPress capability checks is presented as a concrete LemonX MCP capability for admins who want ai clients to inherit wordpress permissions instead of bypassing them.
Missing/invalid token errors is presented as a concrete LemonX MCP capability for admins who want ai clients to inherit wordpress permissions instead of bypassing them.
Plugin data model
lemonx_mcp_settingsImportant internal concepts surfaced as product value.
LemonX MCP stores settings, tokens, stats, audit entries and staged payloads in WordPress options and transients. The website page should explain these concepts because they define trust.
| Concept | What it controls | Why users care |
|---|---|---|
| Gateway settings | enabled, rate_limit, trust_proxy_headers, cors and disabled_tools | Admins can turn the surface on, limit clients and hide tools without editing code. |
| Tokens | label, hash, user_id, preview, created and last_used | Each MCP client can have its own revocable identity bound to a WordPress user. |
| Staged payloads | tool, payload, preview, user_id and created time | Write changes wait for confirmation and expire after 15 minutes. |
| Audit entries | tool, write flag, result, source plugin, feature key, site, token and target | Teams can trace what an agent did, where it came from and which site it touched. |
Security language is crawlable text, not hidden inside an image, so both users and AI answer engines can understand the permission model.
Security and AEO readiness
Explain trust clearly for Google, users and AI answer engines.
This page is built with a clear H1, descriptive sections, direct answers, canonical metadata, SoftwareApplication schema, FAQPage schema and BreadcrumbList schema. That helps Google understand the page and gives AI answer engines concise source material to cite.
For MCP, trust language is especially important. The copy should repeatedly clarify that the gateway does not bypass WordPress permissions, write tools are staged, and actions are auditable.
- Use direct definitions near the top of every page.
- Keep security claims specific: token binding, capabilities, rate limits, CORS and staging.
- Use FAQ structured data for answer-engine-friendly summaries.
- Link related MCP pages so crawlers understand the feature cluster.
Recommended workflow
How teams should use Authentication in practice.
Start from the admin screen, verify site identity, expose only the tools that are needed, and use the preview workflow for anything that could change content. This is the difference between an unsafe browser agent and a controlled WordPress MCP gateway.
- Generate a separate token for each client and site.
- Ask the agent to call initialize and read the returned operating manual.
- Use resources/list or discovery tools before making assumptions about content.
- Apply changes only after reviewing the staging preview and target site context.
Recommended workflow: discover, verify, preview, approve, apply and audit.
FAQ
Common questions about Authentication.
What is Authentication?
Authentication is part of LemonX MCP 0.2.12. It helps WordPress teams authenticate mcp clients with bearer tokens bound to wordpress users and normal capability checks.
Does LemonX MCP bypass WordPress permissions?
No. Tokens are bound to WordPress users, requests run as the bound user, and tools still rely on WordPress capabilities plus LemonX Pro feature gates for write-capable actions.
Can write tools change the site immediately?
Write-capable tools use the preview to apply workflow. The first call stages a preview and opaque payload; only apply_change commits the staged change after review.
Which MCP clients can use this?
The gateway is designed for Claude Code, Codex, Claude Desktop through the stdio bridge, and other HTTP or Streamable HTTP MCP clients that can send JSON-RPC requests with bearer authentication.
Is this page useful for SEO and AI search indexing?
Yes. The page uses a clear H1, descriptive sections, crawlable text, canonical metadata, SoftwareApplication schema, FAQPage schema, BreadcrumbList schema and direct answers for AI answer engines.
Connect AI clients to WordPress with a gateway you can audit.
LemonX MCP gives Claude, Codex and other MCP clients one controlled endpoint for WordPress work: token-bound users, tool discovery, resources, staged writes, Pro gates and activity records.