cd /news/ai-agents/claude-says-couldn-t-reach-the-mcp-s… · home › topics › ai-agents › article
[ARTICLE · art-144308] src=dev.to ↗ pub= topic=ai-agents verified=true sentiment=· neutral

Claude says "Couldn't reach the MCP server" on WordPress — usually it is not the plugin

A developer working on WPPilot, a self-hosted WordPress MCP plugin, outlined a layered troubleshooting approach for the common "Couldn't reach the MCP server" error in Claude, arguing the fault usually lies outside the plugin. The guidance separates diagnosis into four observable stages — HTTPS reachability, authentication, authorization, and tool execution — so that each layer can be checked independently rather than rotating credentials at random. The developer notes the free version supplies MCP endpoints, OAuth and Application Password options, safety profiles, and preview-before-write, while Pro adds plugin modules and an approval queue.

by read1 min views1 publishedOct 3, 2026

WPPilot is a self-hosted WordPress MCP plugin. The Free version provides the MCP endpoints, OAuth and Application Password options, safety profiles, preview-before-write, a change ledger, and the core abilities needed for WordPress administration. Your site remains the server; there is no WPPilot relay or hosted chatbot in the request path.

Pro adds plugin modules and an approval queue, including integrations for areas such as page builders, WooCommerce, and SEO tools. Those additions do not change the basic debugging rule: establish reliable HTTPS reachability first, then authorize only what the connected user and safety profile should allow.

If curl returns a CDN challenge or HTML, fix the proxy, firewall, or cache. If curl returns JSON but OAuth loops, verify the discovery URLs, redirect URI, clock, and callback handling. If OAuth completes but no tools appear, inspect the MCP route and server registration. If tools appear but writes fail, review the safety profile and WordPress capabilities. Treat each as a separate layer instead of rotating credentials at random. The useful question is not “Why is the plugin silent?” It is “Which layer stopped the request?” Reachability, authentication, authorization, and tool execution are observable in that order. Once you keep them separate, “Couldn’t reach the MCP server” becomes a short checklist rather than a mystery.

Disclosure: I work on WPPilot, a self-hosted WordPress MCP plugin. The examples above describe its capabilities and general troubleshooting patterns; always verify the routes and client requirements for your own deployment.

── more in #ai-agents 4 stories · sorted by recency
── more on @wppilot 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
→ Live at https://your-agent.zahid.host ✓
Get free account → Pricing
from €0/mo · no card required
LIVE [news/claude-says-couldn-t…] indexed:0 read:1min 2026-10-03 · —