From 749f1c53eb57dd10fde80d7c7e94c85c2800ec43 Mon Sep 17 00:00:00 2001 From: Daniel Ishi Date: Tue, 28 Oct 2025 04:40:44 +0700 Subject: [PATCH] docs: Emphasize MCP_MODE=stdio requirement for Claude Desktop (#377) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fixes #376 Without this environment variable, Claude Desktop shows JSON parsing errors because debug logs contaminate the JSON-RPC stdout channel. Added prominent warning to Quick Start section explaining: - Why MCP_MODE=stdio is required - What happens without it (JSON parse errors) - How it prevents the issue (suppresses console output) Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en Co-authored-by: Claude Code Assistant --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index c7e31c4..eec471b 100644 --- a/README.md +++ b/README.md @@ -51,6 +51,8 @@ npx n8n-mcp Add to Claude Desktop config: +> ⚠️ **Important**: The `MCP_MODE: "stdio"` environment variable is **required** for Claude Desktop. Without it, you will see JSON parsing errors like `"Unexpected token..."` in the UI. This variable ensures that only JSON-RPC messages are sent to stdout, preventing debug logs from interfering with the protocol. + **Basic configuration (documentation tools only):** ```json {