Skip to content

fix(mcp): drop root .mcp.json; surface alwaysLoad in claude_desktop_config.json examples instead #141

Description

@liplus-lin-lay

目的

PR #140 で repo root に新規追加した .mcp.json を削除し、alwaysLoad: true の推奨先を実際の install 経路 (claude_desktop_config.json) の docs に置き換える。

背景

PR #140 (#139 の実装) で repo root に .mcp.json を新規作成して alwaysLoad: true を入れた。仕様確認の結果、これは現フェーズに合わない:

  • Li+ MCP 群 (github-webhook-mcp / github-rag-mcp) は preview 運用中、distribution level には至っていない
  • 現在の想定 install パスは Claude Desktop の claude_desktop_config.json への manual install のみ
  • Claude Code 仕様確認:
    • project .mcp.json は Claude Code 専用 scope (公式 docs: https://code.claude.com/docs/en/mcp)
    • Claude Desktop は .mcp.json を読まない / UI で surface しない
    • Master の手元で「動くけど見えない」状態は仕様通り、設定ミスではない
  • root .mcp.json は preview phase の現状では:
    • Desktop config 既登録ユーザーには重複 / override の混乱要因
    • 「manual install only」の前提と齟齬

前提

  • 本 MCP の canonical install path = Claude Desktop の claude_desktop_config.json の mcpServers セクション (stdio transport via npx -y github-rag-mcp@latest)
  • 既存 mcp-server/README.md には claude_desktop_config.json 例が掲載済 (PR feat(mcp): add alwaysLoad: true to plugin .mcp.json #140 では未編集)
  • alwaysLoad は Claude Code v2.1.121+ で認識される field、stdio / http 共通で使える

方針判断

Master 判断 (2026-04-28): preview phase 中は手動 install ユーザーだけを前提とする。長期的には Li+ は MCP なしでも動くように設計する方向 ── これは別 issue で温める。

制約

  • root .mcp.json は削除する (新規作成だったため revert ではなく delete)
  • 既存の claude_desktop_config.json 例 (mcp-server/README.md 等) に "alwaysLoad": true を追記
  • README / installation 系 docs にも alwaysLoad 推奨を一行ずつ
  • Claude Code v2.1.121 release 日付 (2026-04-28) と version 要件を docs に明記

対象ファイル

  • .mcp.json (削除)
  • mcp-server/README.md の claude_desktop_config.json 例
  • README / docs/installation 系で touch 可能な箇所

参考

Activity

  1. added this to the milestone on Apr 28, 2026
  2. added
    bug動いていない、壊れている
    memoメモとして開始した状態。見出しは必要なものだけでよい
    on Apr 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bug動いていない、壊れているmemoメモとして開始した状態。見出しは必要なものだけでよい

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions