Atlas AI Connector

⌘K
  2. Home
  4. Docs
  6. Atlas AI Connector
  8. Usage & Setup
  10. WordPress MCP Server Not Connecting? Fixes for Claude, ChatGPT and Cursor

WordPress MCP Server Not Connecting? Fixes for Claude, ChatGPT and Cursor

Start with the problem that matches what you see. Most connection problems come from HTTPS, a firewall or a cache, not from the plugin.

The AI client cannot connect or never shows a login screen

  • Make sure Enable OAuth 2.1 connect for the MCP server is ticked on the MCP Auth page.
  • Use HTTPS. Remote clients such as Claude.ai and ChatGPT reject http:// addresses.
  • On a local http site, connect through a bridge:
npx -y mcp-remote https://your-site.com/wp-json/awfah_mcp/mcp

The connection is blocked by a firewall or host

  • Cloudflare: “Block AI Bots” and Bot Fight Mode block AI clients. Add a WAF skip rule for the /wp-json/awfah_mcp/ path.
  • SiteGround and similar hosts: anti-bot filters can answer with a challenge page. Ask support to exclude /wp-json/awfah_mcp/.
  • Security plugins: allow REST API requests to the same path.

It connected once, then stopped working

A cache is serving an old response. Exclude /wp-json/, or at least /wp-json/awfah_mcp/, from LiteSpeed Cache, Varnish and any page or server cache.

“Connection failed” during sign-in

  • Go to Settings → Permalinks and click Save Changes to refresh the rewrite rules.
  • Open https://your-site.com/wp-json/awfah_oauth/v1/protected-resource-metadata in a browser. It should show JSON.

Another plugin has its own MCP server (Rank Math, Imagify)

Update AtlasAI Connector to 1.8.0 or later. It uses its own private copy of the MCP library, so other MCP plugins no longer take over its tools or sign-in. Always paste the AtlasAI Connector server URL, https://your-site.com/wp-json/awfah_mcp/mcp, not another plugin’s URL.

The AI cannot see a tool

  • Switch on the tool’s module under Modules.
  • Grant it to the connecting user’s role in Access control.
  • WooCommerce tools only appear when WooCommerce is active.
  • Reconnect the client, or start a new chat, so it reloads the tool list.

The AI picks the wrong tool

Your site offers too many tools. Most clients struggle past about 100. Turn off unused modules and limit each role, as shown in Choose which tools your AI client can use.

Still stuck?

Turn on the Activity log to see which calls fail, then contact support with what you found.

How can we help?