Troubleshooting Connection Issues

Quick checklist

Before digging deeper, run through this list:

✅ WP-MCP plugin is Active in WordPress → Plugins
✅ WordPress is version 6.3 or higher
✅ PHP is version 8.1 or higher
✅ Application Passwords are enabled on your host
✅ The REST API is accessible (test: https://yoursite.com/wp-json/wp-mcp/v1/status)
✅ The username is your WordPress login name (not email, not display name)
✅ The password was copied exactly as shown (with spaces between chunks)

The connector is not active in the current Claude conversation. Start a new chat and ensure the WP-MCP connector is enabled.

Wrong username — use your WordPress login name, found at Users → Your Profile → Username
Wrong password — Application Passwords must be copied exactly as shown: xxxx xxxx xxxx xxxx xxxx xxxx
The password was already used to test and then deleted — generate a new one from the dashboard

Permalinks need refreshing. Go to Settings → Permalinks → Save Changes.

A security plugin is blocking the WP-MCP endpoint. In your security plugin, whitelist:

/wp-json/wp-mcp/*

Common plugins that cause this: Wordfence, iThemes Security, All In One WP Security.

The plugin has been turned off. Go to WP-MCP → Settings and enable it.

Too many requests in a short period. The default limit is 60 requests per minute. Go to WP-MCP → Settings to increase it if needed.

The WP-MCP Dashboard has a built-in Connection diagnostics panel (click to expand). It checks:

It shows a green/red status for each check and tells you exactly what to fix.

Visit techinsol.io for support or open an issue on GitHub.