How To: Connect Claude to WordPress with Aiomatic + MCP

Tutorial Video:

What is MCP?

The Model Context Protocol (MCP) is the open standard Claude (and other AI assistants and models) uses to talk with external “tools”. An MCP server announces which tools it offers, and Claude can then call them over JSON-RPC.

With Aiomatic and the MCP Server Creator extension, your WordPress site itself becomes an MCP server. This means Claude can:

Draft or edit posts
Generate AI content in WordPress
Upload and manage media
Assign categories, tags, and taxonomies
Trigger Aiomatic automations and workflows
And much more…

Important: Aiomatic’s MCP relies on a small Python relay script, packaged as a Windows executable called mcp.exe. This relay connects Claude to your WordPress site’s MCP endpoints.

1. Requirements

Before setting up Aiomatic MCP, make sure you have:

WordPress 6.7+
Aiomatic plugin (latest version)
Aiomatic Extension – MCP Server Creator (must be installed and active)
Claude Desktop >= 0.9.2
Windows 10/11 (tested; mcp.exe is compiled for Windows)

Optional:

A local or staging WordPress site for testing before deploying to production.

2. Connect Claude to Aiomatic

Step 1: Enable MCP inside WordPress

In your WP Admin, go to Aiomatic -> Settings -> MCP.
Create a new API token (used to authenticate the MCP connection) – this is optional, but recommended.

Step 2: Configure the relay (`mcp.exe`)

Locate the mcp.exe file bundled in the MCP Server Creator extension (under /relay/).
Open Command Prompt or PowerShell in that folder.
Run the following commands:

The add command stores your site + token in Claude Desktop’s config.
The start command launches the relay and confirms communication.

Step 3: Launch Claude Desktop

Start Claude Desktop after registering your site.
Within a few seconds, you should see Aiomatic listed as an available MCP server.

3. Example Prompts to Try

Once connected, you can give Claude direct instructions that run in WordPress:

Simple: “List my 5 latest WordPress posts.”
Simple: “Create a draft post titled My AI Journey, with two paragraphs and a featured image.”
Intermediate: “Review my newest posts and generate a follow-up article. Use existing tags and categories.”
Advanced: “Set up an automation that fetches content from an RSS feed, summarizes it, and posts a digest every week.”

4. Troubleshooting

Nothing happens in Claude?
- Double-check your token under Aiomatic -> Settings -> MCP.
- If the token is wrong, Claude won’t display errors, check Claude logs:
  - Windows: %APPDATA%\Roaming\Claude\logs
Relay doesn’t connect?
- Ensure your host supports SSE (Server-Sent Events).
- Disable aggressive caching/CDN on these endpoints:
  
  /wp-json/aiomatic-mcp/v1/sse
  
  /wp-json/aiomatic-mcp/v1/messages
Site hangs or becomes unresponsive?
- Each Claude session ties up a PHP worker. If too many relays remain open, WordPress can stop responding.
- Closing Claude or stopping mcp.exe with Ctrl+C will usually free resources.
- Otherwise, restart PHP-FPM/Apache depending on your server.
Platform limitation
- mcp.exe is currently compiled for Windows. For Linux/Mac, the raw Python script will be needed (the same parameters will be able to be used for it).

5. Useful `mcp.exe` Commands

6. Cleanup When Claude Quits

When Claude closes:

mcp.exe detects the end of the session,
Sends an aiomatic/kill notification to your WordPress site,
Ends the SSE stream,
Shuts down cleanly, no orphan processes left behind.

That’s it! With Aiomatic + MCP Server Creator Extension, your WordPress site becomes AI-ready, letting Claude generate, edit, and manage your content directly.