TroubleshootingLesson 3 of 7 · 6 steps

Fix disconnects and session errors

Reconnect cleanly and check the local bridge or proxy route.

Video coming soon

Your next step is ready.

Follow the complete written guide below.
The video will join it here when it’s ready.

Start the written lesson

Before you start

  • Access to the affected site and AI connection.
  • A redacted copy of the exact error.

Let’s do this, step by step.

Step 01

Reconnect once

Record the error, reconnect the client, and retry one read-only request.

A session can expire or be lost. Start with a clean connection instead of repeating a write that may already have completed.

Step 02

Check the local process

For WP-CLI, verify the real site path, WordPress username, EMCP activation, and that mcp-adapter list finds the server.

EMCP Tools bundles the adapter and uses the official plugin when it is active. Check that installation and how WP-CLI loads it before installing another plugin.

Step 03

Use the supported proxy route

If the app cannot maintain the HTTP session, use its documented Node proxy configuration on the client computer.

The proxy handles the session exchange. Its local file must exist beside the AI client, not only on the remote WordPress host.

Step 04

Inspect a server error

For a 500 error, inspect a private PHP log with public error display disabled. Reproduce the smallest failing read.

Keep credentials and private content out of the log excerpt. Check the actual failing operation before assuming the whole server is down.

Step 05

Verify safely

List pages after reconnecting. For a prior timed-out write, inspect the target before attempting it again.

A timeout does not guarantee nothing was saved. Read WordPress first to avoid duplicate pages or repeated actions.

Step 06

Inspect the failed request

Open Safety → MCP Log, filter Errors, and use Show more on the matching time. Inspect stage, session and failure reason. Copy request ID for support, with secrets and connection identifiers redacted.

The log can show whether initialization failed or a later call lost its session. Match the time to your app’s error, then share the request ID and a redacted explanation if you need support.

You’re done when…

A fresh session completes a read and any uncertain earlier write has been checked.

Keep the reference handy.

The docs cover tool details and requirements for this lesson.

Your EMCP guide

Answers from our docs

YOUR CHAT, YOUR CHOICE

Before we chat

MSR Builds processes your question and up to four recent messages on our server to answer from the EMCP docs. AI is optional and needs your separate permission.

The chat is kept in this page's memory, not saved as a conversation in our database or browser storage. Our hosting and security services process connection information, such as your IP address, to prevent abuse.

Cloudflare Turnstile checks your browser and connection to prevent automated abuse when you send a question. No login is required.

Please leave out personal, sensitive or confidential information, passwords and API keys.

You can withdraw consent and clear this page's chat at any time. This cannot undo a request already sent or erase provider/security records.

Chat privacy, retention & your rights ↗ · Privacy contact

Starting chat consents to this processing. You can browse our docs without using the chat.