From 8a7b0ba5a1a7b0ffd033d8baf63a064bae75c498 Mon Sep 17 00:00:00 2001
From: Anton Dzyatkovsky <dzyatkovskiy.a@gmail.com>
Date: Mon, 31 Aug 2026 10:48:26 -0700
Subject: [PATCH] docs: point Claude Code MCP setup at the file Claude Code
 reads

Both the README and the mcp_server.py docstring told Claude Code users to put
the mcpServers block in ~/.claude/claude_desktop_config.json. Claude Code does
not read that file; claude_desktop_config.json belongs to Claude Desktop, which
keeps it in its own application-support directory. Verified on Claude Code
2.1.202: the same JSON at that path never appears in `claude mcp list`, while
`claude mcp add` (or the same block in .mcp.json) connects.

Assisted-by: Claude Code / claude-opus-5
---
 README.md     | 13 ++++++++++++-
 mcp_server.py |  9 ++++++++-
 2 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index f2dde51..7e4642d 100644
--- a/README.md
+++ b/README.md
@@ -94,7 +94,15 @@ Tools exposed:
 - `list_inbox()` — view previously fetched content
 - `detect_platform(url)` — identify platform from URL
 
-Claude Code config (`~/.claude/claude_desktop_config.json`):
+Register it with Claude Code:
+
+```bash
+claude mcp add x-reader -- python /path/to/x-reader/mcp_server.py
+```
+
+That writes `.mcp.json` in the current project; `--scope user` writes `~/.claude.json`
+instead, making the server available everywhere. The same entry by hand, in `.mcp.json`:
+
 ```json
 {
     "mcpServers": {
@@ -106,6 +114,9 @@ Claude Code config (`~/.claude/claude_desktop_config.json`):
 }
 ```
 
+Claude Desktop is a different product with its own `claude_desktop_config.json`, in its
+application-support directory — not under `~/.claude/`. It takes the same `mcpServers` block.
+
 ## Supported Platforms
 
 | Platform | Text Fetch | Video/Audio Transcript |
diff --git a/mcp_server.py b/mcp_server.py
index 25a578d..1861041 100644
--- a/mcp_server.py
+++ b/mcp_server.py
@@ -6,7 +6,11 @@
     python mcp_server.py                    # stdio transport (for Claude Code)
     python mcp_server.py --transport sse    # SSE transport (for web clients)
 
-Claude Code config (~/.claude/claude_desktop_config.json):
+Register with Claude Code (writes .mcp.json in the project; --scope user writes
+~/.claude.json instead):
+    claude mcp add x-reader -- python /path/to/x-reader/mcp_server.py
+
+The same entry by hand, in .mcp.json:
     {
         "mcpServers": {
             "x-reader": {
@@ -15,6 +19,9 @@
             }
         }
     }
+
+Claude Desktop is a separate product with its own claude_desktop_config.json, in its
+application-support directory -- not under ~/.claude/.
 """
 
 import asyncio