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