MCP Server for WordPress – Connect Claude, ChatGPT & Gemini | Atlas AI Connector
Atlas AI Connector is an MCP server for WordPress — it turns your site into a Model Context Protocol (MCP) server so AI assistants like Claude, ChatGPT, Gemini, Cursor, and Claude Desktop can read, write, and manage your site through natural language. Connect any MCP client and let AI agents handle your posts, pages, media, users, settings, and WooCommerce store securely.
It is also the only WordPress MCP plugin that pairs a full MCP server with AI experiments inside the Gutenberg block editor — generate excerpts, feature images, summaries, titles, and alt text without leaving the post editor — plus role-based access control and one-click OAuth 2.1 connect.
Atlas AI Connector provides 80+ abilities across 10 modules, a built-in MCP server for AI agent connectivity, one-click OAuth 2.1 authentication, AI experiments in the block editor, role-based access control, a workflow builder, and full WooCommerce support.
How it works: activate the plugin and your WordPress MCP server endpoint goes live at /wp-json/awfah_mcp/mcp. Enable one-click OAuth 2.1 under MCP Auth, paste that URL into any MCP client (Claude, ChatGPT, Cursor), and your AI assistant connects securely — no manual tokens to copy.
Why Atlas AI Connector?
- Connect any AI client — Claude Desktop, Claude Code, ChatGPT, Cursor, Windsurf, or any MCP-compatible tool, over standard JSON-RPC 2.0.
- MCP server + AI content in one plugin — most WordPress MCP plugins do one or the other. Atlas AI Connector does both.
- 80+ ready-to-use abilities — exposed to AI as tools, resources, and prompts, including 24 WooCommerce store abilities.
- Secure by design — OAuth 2.1 with PKCE + dynamic client registration, plus JWT and Application Password support, and per-role access control so each AI connection only sees what its WordPress user is allowed to use.
- Works on WordPress 6.8+ — bundles the WordPress Abilities API and MCP Adapter so you do not need to wait for WordPress 6.9 where these ship in core.
Highlights
- 80+ registered abilities covering posts, pages, media, users, custom post types, REST API discovery, site diagnostics, WordPress settings, WooCommerce, and AI-powered content analysis.
- 11 independently toggleable modules – enable only what you need.
- Error Debugger – Monitor PHP errors in real time, receive email alerts with a one-click fix command, and fix errors directly from your AI assistant via MCP (Pro).
- AI Experiments in the Block Editor – Generate excerpts, feature images, and more directly from the post editor with multi-provider AI support.
- Built-in MCP server – expose abilities as tools, resources, and prompts to AI agents over JSON-RPC 2.0.
- External Abilities – automatically discovers and integrates abilities from WordPress core and third-party plugins via the Abilities API.
- OAuth 2.1 one-click connect – connect Claude, ChatGPT, or Cursor by pasting only your server URL; PKCE + dynamic client registration, no manual tokens.
- JWT authentication – secure MCP and REST API access with token-based auth.
- Workflow builder – combine abilities into reusable workflows from the admin dashboard or the post editor meta box.
- Multi-provider AI – connect OpenAI, Google Gemini, or Anthropic Claude via the WordPress AI Client.
- Role-based access control – assign abilities per WordPress role so each MCP connection only exposes what that user is allowed to use.
- Backward compatible – bundles the WordPress Abilities API and MCP Adapter as vendor dependencies, so it works on WordPress 6.8+ (not just 6.9+ where these APIs ship in core).
Atlas AI Connector Pro
Unlock the full power of Atlas AI Connector with Atlas AI Connector Pro:
- Unlimited Workflows – Create unlimited MCP workflows (free: 3 max).
- T/R/P Access Modes – Granular per-ability Tool/Resource/Prompt toggles for fine-grained MCP control.
- Advanced AI Experiments – Templates library, batch generation mode, explain AI reasoning, generation history, and keyboard shortcuts.
- Workflow Prompt Builders – 6 pre-built prompt builder workflows (SEO Audit, Content Brief, Site Overview, and more).
- External Abilities – Discover and expose third-party plugin abilities via the Abilities API.
- Per-Ability RBAC – Assign individual abilities (not just modules) to each WordPress role.
- MCP Fix Command – Error emails include a ready-to-paste MCP command that lets your AI assistant read, analyse, and fix the error with one paste — automatic backup included.
- Webhook Notifications – Send error alerts to Slack, Discord, or a custom webhook.
- Backups Manager – All AI-applied fixes are backed up automatically; restore any backup with one click.
- Priority Support – Direct support from the development team.
Modules
Each module can be independently enabled or disabled from the Atlas AI Connector dashboard.
1. AI Content Steward (8 abilities)
AI-powered content analysis, generation, and improvement for posts and pages.
2. Posts Manager (13 abilities)
Full CRUD for WordPress posts, categories, and tags.
3. Pages Manager (5 abilities)
CRUD operations for WordPress pages.
4. Media Manager (7 abilities)
Upload, update, and manage media files.
5. Users Manager (7 abilities)
Search, create, and manage WordPress users.
6. Custom Post Types Manager (6 abilities)
CRUD operations for any registered custom post type.
7. REST API Tools (3 abilities)
Discover and execute any WordPress REST API endpoint dynamically.
8. Site Info & Diagnostics (4 abilities)
View site info, plugins, themes, and users at a glance.
9. Settings Manager (3 abilities)
View and update WordPress site settings.
10. AI Store Manager – WooCommerce (24 abilities)
Full WooCommerce management through AI. Requires WooCommerce to be active.
- Products: search, get, add, update, delete.
- Product categories: list, add, update, delete.
- Product tags: list, add, update, delete.
- Product brands: list, add, update, delete.
- Orders: search.
- Reports: coupons totals, customers totals, orders totals, products totals, reviews totals, sales.
11. Error Debugger
Monitor PHP errors in real time and fix them faster. Works out of the box — no configuration required to start tracking errors.
Free features: * Real-time PHP error tracking grouped by file and message. * Email notifications for errors in plugins and themes — configurable recipient, severity levels, and rate limit. * Fix Command in every email — a pre-filled text snippet you can paste into any AI assistant to get fix instructions. * Admin dashboard widget showing the last 5 errors and a 24-hour error count. * Debug log scanner catches errors that occur before the plugin loads (e.g. fatal parse errors during activation).
Pro features (requires Atlas AI Connector Pro): * MCP Fix Command — paste directly into Claude Desktop, Cursor, or any connected MCP client. The AI reads the file, suggests a fix, creates a backup, and applies it. * Webhook notifications — send error alerts to Slack, Discord, or a custom URL. * Backups Manager — all AI-applied fixes are backed up; restore any backup with one click. * Extended error sources — monitor WordPress Core, MU-Plugins, and Drop-ins in addition to plugins and themes.
Coming Soon
- AI Support Desk – Summarize comment threads, suggest reply drafts, categorize support requests.
- AI Automation Recipes / Workflows – Rule-based AI automations triggered by WordPress events.
AI Experiments in the Block Editor
Unlike other WordPress MCP plugins, Atlas AI Connector pairs its MCP server with AI generation built right into the Gutenberg block editor — no separate tool, no leaving the post. Five experiment panels run on your configured AI provider (OpenAI, Google Gemini, or Anthropic Claude):
- Excerpt Generation – one-click, SEO-friendly excerpts in the post sidebar excerpt panel.
- Feature Image Generation – AI feature images from your post content, in the Featured Image panel.
- Summarization – generate a concise, neutral summary of the post.
- Title Suggestions – multiple SEO-friendly title ideas to pick from.
- Alt Text Generation – accessible, descriptive alt text for images.
Each panel includes an editable prompt and ready-made prompt templates — included free.
Pro extends every experiment with Atlas AI Connector Pro: a prompt templates library (save and reuse your own prompts), batch generation (create and compare multiple variations at once), «Explain This Generation» (see the AI’s reasoning), generation history (review and restore past results per post), and keyboard shortcuts.
Error Debugger
The Error Debugger module monitors PHP errors on your WordPress site and helps you fix them faster.
How it works:
- Enable the Error Debugger module from the Atlas AI Connector dashboard.
- Optionally enable Email Notifications and configure the recipient address, severity levels, and rate limit.
- When a PHP error occurs in a plugin or theme, an email is sent with full error details and a How to Fix block.
- Copy the fix command from the email and paste it into your AI assistant to get step-by-step fix instructions.
Free fix flow: Copy the pre-filled text from the email → paste into ChatGPT, Claude, Gemini, or any AI chat → the AI explains the error and how to fix it.
Pro fix flow (MCP): Copy the MCP command block from the email → paste into Claude Desktop, Cursor, or any MCP client connected to your site → the AI reads the file, suggests a fix, creates a backup, and applies it automatically.
Admin dashboard widget: When the Error Debugger module is active, a «Atlas AI Connector — Recent Errors» widget appears on the WordPress admin dashboard showing the last 5 errors and a 24-hour error count. You can disable the widget from the Error Debugger settings without disabling the module.
Connecting AI Agents to your WordPress MCP Server
Atlas AI Connector includes a built-in MCP (Model Context Protocol) server that lets external AI agents interact with your WordPress site. The MCP endpoint is:
https://your-site.com/wp-json/awfah_mcp/mcp
Any MCP-compatible AI client can connect and use all enabled abilities as tools, resources, and prompts.
Post Editor Meta Box
On every post and page edit screen, the AI Content Steward meta box provides:
- Provider selection (Auto, OpenAI, Gemini, Claude).
- Ability checkboxes to select which analyses to run.
- Editable prompt preview that updates as you select abilities.
- One-click workflow execution.
- Save workflows for reuse.
Connecting AI Agents
Connect with OAuth 2.1 (one-click, recommended)
The easiest way to connect. Enable it once, then your AI client handles the rest — no manual tokens.
Step 1: In WordPress admin go to Atlas AI Connector → MCP Auth and turn on «Enable OAuth 2.1 connect for the MCP server».
Step 2: Copy your server URL (shown on that page), e.g. https://your-site.com/wp-json/awfah_mcp/mcp.
Step 3: Add it to your client:
- Claude.ai / Claude Desktop (remote connector): add a custom connector and paste the server URL. Your site must be served over HTTPS. The client auto-discovers the auth server, registers itself, and shows a consent screen — click Allow.
-
Local / HTTP sites via the bridge: use the
mcp-remotehelper in your client config:{ «mcpServers»: { «atlasmcp»: { «command»: «npx», «args»: [«-y», «mcp-remote», «https://your-site.com/wp-json/awfah_mcp/mcp»] } } }
On Windows, set "command": "cmd" and prepend "/c", "npx" to the args. Add --allow-http to the args only if the site is plain http on localhost.
After you click Allow, the connection is authorized and your enabled abilities appear as tools. You can review and revoke connected clients anytime on the MCP Auth page.
Who can authorize: By default only users who can edit posts (Editors, Authors, Administrators) may authorize an MCP connection — Subscribers/Customers are blocked even if they have the URL. Developers can change the required capability with the awfah_oauth_authorize_min_capability filter (e.g. set it to manage_options for admins-only).
Note: OAuth requires a root-domain install over HTTPS for remote clients. A WordPress install in a subdirectory cannot complete the OAuth handshake with some clients; use JWT or Application Passwords there.
How the OAuth connection works (in brief)
Atlas AI Connector is its own OAuth 2.1 authorization server — your WordPress site is the identity provider. When a client connects:
- It calls the MCP endpoint, receives a
401challenge, and discovers the server from the.well-knownmetadata (RFC 9728 / RFC 8414). - It registers itself automatically via Dynamic Client Registration (RFC 7591) — no manual client IDs or secrets.
- You approve a consent screen in your browser; the client completes a PKCE authorization-code exchange (RFC 7636) and receives an access token.
- The token maps to your WordPress user, so your role and the per-role Access Control govern exactly what the connection can do.
Review or revoke connected clients anytime under MCP Auth -> Connected clients.
Other authentication methods & full client setup
For headless or CI use, the MCP server also accepts JWT tokens and WordPress Application Passwords via the Authorization: Bearer <token> header.
Step-by-step setup for every client — Claude Desktop, Claude Code, Cursor / Windsurf, Postman, and JWT / Application Password configuration — is built into the plugin and kept up to date there:
WordPress admin -> Atlas AI Connector -> MCP Auth -> Documentation tab -> «MCP Client Setup Guide».
Role-Based MCP Access
Atlas AI Connector provides role-based access control for MCP connections. This means different WordPress users see different abilities depending on their role.
How it works:
- An administrator configures which abilities each WordPress role can access via the Access Control tab in the Atlas AI Connector dashboard.
- When an AI client connects via MCP, it authenticates as a specific WordPress user (via OAuth, JWT, or Application Password).
- The plugin checks that user’s role and only exposes the abilities assigned to that role.
- The AI client can only see and execute the allowed abilities — everything else is hidden.
Example scenarios:
- Administrator — Full access to all 80+ abilities including post CRUD, site settings, user management, media, WooCommerce, and content analysis.
- Editor — Content-focused abilities only (e.g. analyze posts, generate excerpts, suggest titles, focus keywords). No access to site settings, user management, or destructive operations.
- Author / Contributor — Can be fully restricted or given a minimal subset of abilities as configured by the site admin.
Setting up role-based access:
- Go to the Atlas AI Connector dashboard in WordPress admin.
- Click the Access Control tab.
- Select a role from the dropdown.
- Check or uncheck abilities to grant or revoke access for that role.
- Click Save. Changes take effect immediately for all MCP connections using that role.
Multiple MCP connections:
You can create multiple MCP connections in your AI client config, each authenticating as a different WordPress user. For example:
- A «full-access» connection using an administrator account.
- A «content-only» connection using an editor account.
This lets you switch between permission levels depending on the task at hand.
