Easy MCP AI
Download Plugin

Documentation

Technical reference, installation guide, and FAQ for Easy MCP AI.

1. Installation Guide

Automatic Installation (WordPress Plugin Directory)

  1. In WordPress admin, go to Plugins → Add New Plugin
  2. Search for "Easy MCP AI"
  3. Click Install Now and then Activate

Manual Installation (ZIP Upload)

  1. Download the plugin ZIP from WordPress.org
  2. In WordPress admin: Plugins → Add New Plugin → Upload Plugin
  3. Upload the ZIP, click Install Now, then Activate

2. First-Time Setup Tutorial

Step 1 — Create Your First Token

  1. Go to Easy MCP AI → API Tokens in your WP admin.
  2. Click Create New Token.
  3. Fill in the specific details (Name, Associated User, Allowed Tools, Expiry). Choose "Administrator" for full write access or "Editor" for content-only access.
  4. Click Create Token.
  5. ⚠ Copy the token NOW — it looks like wpmcp_a1b2c3... (78 chars). It is shown only once and cannot be recovered because it is SHA-256 hashed in the database.

Step 2 — Find Your Endpoint URL

Your MCP endpoint is always:

https://yoursite.com/wp-json/easy-mcp-ai/v1/mcp

Note: HTTPS is strictly required for secure token transmission.

Step 3 — Connect Your AI Client

Browse the Integrations Directory to find the specific JSON configuration file or URL format needed for your AI assistant (e.g., Claude Desktop, Cursor, ChatGPT).

3. Frequently Asked Questions (FAQ)

What is the Model Context Protocol (MCP)?

MCP is an open standard created by Anthropic that lets AI assistants securely connect to external tools and data sources. It is widely supported by Anthropic, OpenAI, Google, and dozens of IDEs.

Does this require Node.js or a special server?

No. The plugin is pure PHP and runs entirely inside WordPress on any standard hosting. No long-running processes, no Node.js scripts, and no external proxy services are needed.

Is it safe to run on a live site?

Yes, when used over HTTPS. Every single API request is authenticated via Bearer token, rate-limited, strictly capability-checked against standard WP roles, and fully logged in an internal audit log.

Why does the endpoint return 404?

Go to Settings → Permalinks in your WordPress admin and click Save Changes to flush rewrite rules. Pretty permalinks must be enabled for the REST API endpoint to register properly.

Can I prevent my AI from deleting content?

Yes. You can either (1) only grant read-only tools when creating the specific token, or (2) use the global "Disabled Delete Tools" setting in the admin panel to block all 7 destructive delete tools for all tokens system-wide.

For the full list of tool parameters and methods, check the Tool Directory.