From d6fd8db8b67dfe5665b0d6acfd7242f9d3ffb241 Mon Sep 17 00:00:00 2001
From: Claude Lin & Lay <eightborder@gmail.com>
Date: Tue, 28 Apr 2026 23:40:36 +0900
Subject: [PATCH] fix(mcp): drop root .mcp.json; recommend alwaysLoad in
 desktop config examples
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Remove the repo-root /.mcp.json added in PR #140 (issue #139). The Li+ MCP
suite is in preview phase, and the assumed install path is manual install
via Claude Desktop's claude_desktop_config.json — not Claude Code's
project-scoped .mcp.json. Shipping a root .mcp.json caused duplicate /
override friction for users who already register the server in their
Desktop config.

Surface the alwaysLoad: true recommendation on the actual install
surface instead: both claude_desktop_config.json examples in
mcp-server/README.md (basic + self-hosted Worker) now include the field,
with a single short note about the Claude Code v2.1.121+ requirement
(released 2026-04-28). Older clients silently ignore the field.

preview phase 中の install 経路は Desktop 設定への手動登録のみを前提とし、
将来の distribution 段階で root .mcp.json を再導入する余地を残す reversible
delete として扱う。

Closes #141

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .mcp.json            | 10 ----------
 mcp-server/README.md |  8 ++++++--
 2 files changed, 6 insertions(+), 12 deletions(-)
 delete mode 100644 .mcp.json

diff --git a/.mcp.json b/.mcp.json
deleted file mode 100644
index 2c06ada..0000000
--- a/.mcp.json
+++ /dev/null
@@ -1,10 +0,0 @@
-{
-  "mcpServers": {
-    "github-rag-mcp": {
-      "type": "http",
-      "url": "https://github-rag.smgjp.com/mcp",
-      "alwaysLoad": true,
-      "note": "GitHub RAG MCP. OAuth is required on first use."
-    }
-  }
-}
diff --git a/mcp-server/README.md b/mcp-server/README.md
index 8f4d69d..beb735a 100644
--- a/mcp-server/README.md
+++ b/mcp-server/README.md
@@ -47,7 +47,8 @@ Add the server to your MCP client configuration. Example for Claude Desktop (`cl
   "mcpServers": {
     "github-rag": {
       "command": "npx",
-      "args": ["-y", "github-rag-mcp"]
+      "args": ["-y", "github-rag-mcp"],
+      "alwaysLoad": true
     }
   }
 }
@@ -63,12 +64,15 @@ To target a self-hosted Worker, set the `RAG_WORKER_URL` environment variable:
       "args": ["-y", "github-rag-mcp"],
       "env": {
         "RAG_WORKER_URL": "https://your-worker.example.workers.dev"
-      }
+      },
+      "alwaysLoad": true
     }
   }
 }
 ```
 
+> **Note on `alwaysLoad`:** Recognized by Claude Code v2.1.121+ (released 2026-04-28). When set, the client loads this server's tools at session start instead of deferring them behind a `ToolSearch` round-trip — useful for retrieval servers used on every turn. Older clients silently ignore the field, so it is safe to leave in place. `alwaysLoad` を認識しないクライアント (Claude Desktop など) では無視されるだけで害はない。
+
 ## Configuration
 
 | Variable | Required | Default | Description |