How to Easily Set Up the WordPress MCP plugin & Connect AI Tools (2026 Step-by-Step Guide)

Setting up the WordPress MCP plugin is the first step to seamlessly connect your website’s data with advanced AI tools.

Learn how to set up an MCP server and connect it to your AI tool in 9 clear steps. Covers plugin installation, JSON configuration, troubleshooting, and best practices for beginners and developers.

What Is MCP and Why Does It Matter for AI Integration?

The Model Context Protocol (MCP) is an open-source communication protocol that standardizes how AI models interact with external systems. Before MCP existed, every AI integration required custom code. Developers had to build one-off bridges between AI APIs and every tool they wanted to connect. MCP replaces that entire mess with a single, consistent standard.

Here is a concrete example. Suppose you are using Claude as your AI assistant and you want it to be able to draft and publish posts on your WordPress site. Without MCP, you would write a custom API integration from scratch. With MCP, you install a compatible plugin, paste a JSON config, and the connection is live in minutes.

Who Actually Needs MCP Server Setup?

WordPress MCP plugin server setup is relevant for four groups:

• Developers building AI-powered applications that read or write to a CMS or database.
  
• Business owners who want their AI assistant to manage content, respond to customer queries, or pull live site data.
  
• AI enthusiasts experimenting with autonomous agents and tool-calling workflows.
  
• Agencies setting up repeatable AI automation for client sites.

If you fall into any of these groups, this MCP tutorial is written for you.

MCP Server Setup: 9-Step Configuration Guide

Upload MCP Plugin from Mia Shahzad Git Repository

Purpose of This Step

WordPress MCP plugin is the foundation of the entire setup. It adds Model Context Protocol support to your WordPress site, exposing a structured endpoint that AI tools can communicate with.

Detailed Instructions

1. Navigate to the Mia Shahzad GitHub repository containing the MCP plugin
   
2. Click the green Code button, then select Download ZIP.
   
3. In your WordPress admin, go to Plugins > Add New > Upload Plugin.
   
4. Click Choose File, select the downloaded ZIP, and click Install Now.
   
5. After installation completes, click Activate Plugin.

Avoid: Do not install the plugin by manually unzipping it via FTP unless you are comfortable with file permissions. Uploading through WordPress admin is the safest path.

Tip: Always check the GitHub repository’s README for the minimum WordPress and PHP version requirements before installing. Running an outdated PHP version is the most common cause of plugin activation failures.

Upload MCP Adapt Plugin

Purpose of This Step

The MCP Adapt plugin acts as the bridge between the core MCP protocol and the specific AI tool you are connecting. It handles authentication formatting, request routing, and response normalization so your AI tool speaks the right dialect of MCP.

Detailed Instructions

1. Download the MCP Adapt plugin ZIP from its repository
   
2. Follow the same upload process: Plugins > Add New > Upload Plugin.
   
3. Install and activate. You should now see both the WordPress MCP plugin and MCP Adapt listed as active in your plugin list.

Avoid: Both plugins must be active at the same time. Activating only one will result in connection errors later. Check your active plugins list before moving forward.

Tip: If you manage multiple WordPress sites, consider using a staging site for the initial MCP connection setup before applying it to your live environment.

Generate a New Application

Purpose of This Step

WordPress Application Passwords allow external tools to authenticate with your site without using your main admin password. This is the secure credential your AI tool will use to communicate with the MCP server.

Detailed Instructions

1. In WordPress admin, go to Users > Profile (or Users > All Users and edit your admin user).
2. Scroll down to the Application Passwords section.
   
3. In the New Application Password Name field, enter a descriptive name such as MCP-AITool-Connection.
   
4. Click Add New Application Password.

Avoid: Application Passwords require WordPress 5.6 or higher and HTTPS. If your site still runs HTTP, Application Passwords will not appear. Fix SSL before proceeding.

Tip: Name your application password something descriptive. If you connect multiple AI tools later, clear names make it easy to identify and revoke individual credentials without disrupting others.

Copy the Application Password

Purpose of This Step

After generating the application password, WordPress displays it exactly once. You must copy it immediately. This password is the authentication key for your entire MCP connection setup.

Detailed Instructions

1. WordPress will display a long password string in a highlighted box immediately after you click Add New Application Password.
   
2. Click the copy icon or manually select and copy the full password string.
   
3. Paste it into a temporary secure location (a local text file or a password manager).
   
4. Do not close or refresh the page until the password is safely saved.

Avoid: If you navigate away before copying, the password is gone permanently. You would need to delete this application and generate a new one.

Tip: Store the password in a password manager like Bitwarden or 1Password alongside the username (your WordPress admin username). You will need both for the next step.

Configure MCP Tool Connection

Purpose of This Step

This step inputs your (WordPress MCP plugin) site credentials into the MCP tool or AI agent interface so it knows where to connect and how to authenticate.

Detailed Instructions

1. Open your AI tool (Claude Desktop, a custom MCP client, or Antigravity).
   
2. Navigate to the MCP connection settings panel.
   
3. Enter your WordPress site URL in the Server URL field. The MCP endpoint is typically: https://yoursite.com/wp-json/mcp/v1
   
4. Enter your WordPress admin username.
   
5. Paste the application password you copied in Step 4 into the Password field.
   
6. Save the connection settings.

Avoid: The MCP endpoint URL must use HTTPS. An HTTP URL will be rejected by most AI tools during connection validation.

Tip: Double-check the endpoint path by visiting it directly in your browser. You should see a JSON response. If you get a 404, confirm both plugins are active and permalinks are refreshed (Settings > Permalinks > Save).

Copy JSON Code from Antigravity or AI Tool

Purpose of This Step

Most modern AI tools that support MCP generate a JSON configuration block containing your server’s connection parameters. This block is what gets pasted into the raw config file to officially register your MCP server. (WordPress MCP plugin)

Detailed Instructions

1. Inside your AI tool or Antigravity interface, locate the MCP Server JSON or Export Config option after saving the connection in Step 5.
2. The tool will generate a JSON block similar to this:

{
  "mcpServers": {
    "wordpress-mcp": {
      "url": "https://yoursite.com/wp-json/mcp/v1",
      "auth": {
        "type": "basic",
        "username": "your-wp-username",
        "password": "your-application-password"
      }
    }
  }
}

3. Click the Copy button or select all and copy the entire JSON block.¹

Avoid: Do not edit the JSON at this stage. Modifying keys or adding trailing commas will cause a parse error in the next step.

Tip: If your AI tool does not auto-generate this JSON, you can write it manually using the template above. Replace placeholder values with your actual site URL, username, and application password.

Configure MCP Server Using View Raw Config

Purpose of This Step

The raw config file is where all MCP server definitions are stored. Pasting your JSON block here registers your WordPress site as an official MCP server endpoint inside your AI tool.(WordPress MCP plugin)

Detailed Instructions

1. In your AI tool settings, find the option labeled View Raw Config, Edit Config File, or similar. In Claude Desktop, this is under Settings > Developer > Edit Config.
   
2. The raw config file (usually claude_desktop_config.json) will open in a text editor or inline editor.
   
3. Locate the "mcpServers" object. If it does not exist, you will add it.
   
4. Paste your copied JSON block inside the main config object, merging it with any existing servers:

{
  "mcpServers": {
    "wordpress-mcp": {
      "url": "https://yoursite.com/wp-json/mcp/v1",
      "auth": {
        "type": "basic",
        "username": "your-wp-username",
        "password": "your-application-password"
      }
    }
  }
}

5. Save the config file.

Avoid: JSON is strict about syntax. A missing comma, a trailing comma after the last item, or mismatched braces will prevent the config from loading. Use a JSON validator (jsonlint.com) before saving if you are unsure.

Tip: Keep a backup of your original config file before making edits. If the AI tool fails to start after your changes, you can restore the backup in under 30 seconds.

Refresh MCP and Verify Connection

Purpose of This Step

After saving the raw config, you need to restart or refresh the MCP server so it picks up the new configuration. Verification confirms the AI tool can reach your WordPress endpoint.

Detailed Instructions

1. Completely close your AI tool application (do not just minimize it).
   
2. Reopen the AI tool. On startup, it reads the updated config file and attempts to connect to all registered MCP servers.
   
3. Navigate to the MCP server list or connection dashboard inside the tool.
   
4. Look for a green dot or Connected status next to your WordPress MCP server entry.
   
5. If you see a Failed or Error status, check the troubleshooting section of this guide.

Avoid: Simply saving the config without restarting the tool will not apply the changes. A full restart is required for MCP config changes to take effect.

Tip: Some AI tools have a dedicated Reload MCP Servers button that saves you from a full restart. Check your tool’s settings panel before closing and reopening.

Add HTML Code and Prompt to Start Using MCP

Purpose of This Step

The final step embeds the MCP-powered AI interface into your website and writes your first prompt to confirm end-to-end functionality.

Detailed Instructions

1. In your AI tool or Antigravity, locate the Embed Code or HTML Snippet option for your MCP connection.
   
2. Copy the generated HTML embed code.
   
3. In WordPress MCP plugin open the page or post where you want the AI interface to appear, switch to HTML/Code Editor, and paste the snippet.
   
4. Save and preview the page.
   
5. In the AI interface on your page, type a test prompt such as: “List the last 5 posts on this site.”
   
6. If the AI returns accurate data from your site, your (WordPress MCP plugin) MCP server setup is complete and working.

Avoid: Some caching plugins may serve a cached version of the page that does not include the new HTML snippet. Clear your site cache after adding the code.

Tip: Start with a read-only prompt (like listing posts) before testing write actions (like creating posts). Read-only tests are lower risk and confirm the connection is working before you grant broader permissions.

Benefits of Using MCP with AI Tools

Connecting your AI tool to an MCP server is not just a technical exercise. It changes what the AI can actually do for your business.

1. Real-Time Data Access

Your AI assistant can pull live content from your site rather than relying on static context you paste manually.

2. Automated Content Actions

Draft, schedule, and publish posts through natural language commands. No need to open the WordPress editor.

3.Secure Authentication

Application Passwords isolate AI access from your main admin credentials, reducing security risk significantly.

4. Scalable AI Automation

Once your(WordPress MCP plugin) MCP server is live, connecting additional AI tools takes minutes, not days of custom development.

5. Reduced Manual Work

Tasks that used to take 20 minutes of copy-pasting between tabs can run in seconds with a single natural language prompt.

Troubleshooting Common MCP Connection Issues

Best Practices for Managing MCP Servers

Conclusion: MCP Server Setup Is a One-Time Investment That Pays Off Fast

Setting up an MCP server is not as complicated as it sounds when you have a clear process to follow. Two WordPress MCP plugin, an application password, a JSON config, and a connection test are all that stand between your current workflow and a fully connected AI tool that can act on your site.

The 9 steps in this guide cover the complete path: from MCP plugin installation through JSON configuration, connection verification, and live prompt testing. Each step has a defined purpose, and the troubleshooting section handles the most common failure points so you are not stuck when something does not work the first time.

MCP is an open standard and its adoption is accelerating. The AI tools, platforms, and CMS plugins that support MCP will only grow. Getting your MCP connection setup right now puts you ahead of the curve and gives you a foundation for every AI automation workflow you build later.

Key Takeaways

• MCP (Model Context Protocol) is the open standard that lets AI tools read and write data on external systems like WordPress.
  
• You need both the WordPress MCP plugin and MCP Adapt plugin active for the connection to work.
  
• Application Passwords are the secure way to authenticate AI tools without exposing your admin credentials.
  
• JSON configuration syntax must be exact. Use a validator before saving.
  
• Always restart the AI tool fully after updating the raw config file.
  
• Start with a read-only test prompt to verify the connection before running write actions.
  
• Use one application password per AI tool and revoke unused ones regularly.
  
• HTTPS is mandatory. HTTP endpoints will not work with MCP authentication

Need Help Setting Up Your MCP Server?
NowDigiverse specializes in AI automation and WordPress integration. We set up MCP connections, build custom AI workflows, and handle the technical configuration so you can focus on your business.