docs: Emphasize MCP_MODE=stdio requirement for Claude Desktop (#377)

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 <noreply@anthropic.com>
This commit is contained in:
Daniel Ishi
2025-10-28 04:40:44 +07:00
committed by GitHub
parent 892c4ed70a
commit 749f1c53eb

View File

@@ -51,6 +51,8 @@ npx n8n-mcp
Add to Claude Desktop config: 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):** **Basic configuration (documentation tools only):**
```json ```json
{ {