docs(mcp): recommend alwaysLoad: true for Claude Code v2.1.121+#218
Merged
Conversation
Add `alwaysLoad: true` to the recommended `.mcp.json` snippets in
docs/installation.{md,ja.md} and mcp-server/README.md, with a short
note describing the Claude Code v2.1.121+ requirement and the
deferral-skip benefit.
github-webhook-mcp は UserPromptSubmit hook 経由で毎ターン呼ばれる
ため、tool-search の deferral 対象から外して即時利用可能にしておく
のが望ましい。Claude Code v2.1.121 で追加された alwaysLoad オプション
を推奨設定に組み込む。
Closes #217
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Deploying with
|
| Status | Name | Latest Commit | Updated (UTC) |
|---|---|---|---|
| ✅ Deployment successful! View logs |
github-webhook-mcp | 91d82af | Apr 28 2026, 02:15 PM |
liplus-lin-lay
commented
Apr 28, 2026
Member
Author
liplus-lin-lay
left a comment
liplus-lin-lay
left a comment
There was a problem hiding this comment.
Self-review (auto mode)
変更スコープ
docs/installation.md/docs/installation.ja.md/mcp-server/README.mdの 3 ファイル、計 +11 / -1 行。.mcp.json推奨スニペット 4 例すべてに"alwaysLoad": trueを追加（位置:args直後・env直前で統一）。- 近接プロセに Claude Code v2.1.121+ 要件と deferral-skip の利点を補足。
リスク評価
- 低リスク: docs / 設定推奨値の追記のみ。実行コード・ビルド成果物・CI スクリプトに変更なし。
- 後方互換性:
alwaysLoadを認識しない旧バージョンは未知キーを無視するだけで、設定読み込みは継続する。 - ユーザー影響: 推奨値を採用すると新サーバーツールが tool-search deferral から外れ、毎ターン即時利用可能となる。UserPromptSubmit hook 経路の round trip 削減。
確認事項
- CI / test / Workers Builds すべて green
- commit title / PR title: ASCII English single line
- commit body: 日本語文 1 文以上含む /
Closes #217含む / co-author trailer 付与 - PR body: 日本語、
## Summary/## Test planセクション、Closes #217 - スコープ外の変更なし
auto mode により self-review 通過後そのまま gh pr merge --squash で merge する。
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
.mcp.jsonの推奨スニペット（docs/installation.md/docs/installation.ja.md/mcp-server/README.md）に"alwaysLoad": trueを追加。argsの直後・envの直前で統一。Background
Claude Code v2.1.121 (2026-04-28 release) で MCP server config に
alwaysLoadオプションが追加された。trueの場合、そのサーバーのツールは tool-search の deferral 対象から外れ、毎ターン即座に呼び出せる状態が保たれる。github-webhook-mcpは UserPromptSubmit hook 経由で毎ターン参照されるため、deferral がかかると無駄な round trip が増える。alwaysLoad: trueを推奨設定として明示しておく。Test plan
alwaysLoadキーが既存設定と衝突していないことを確認（既存ファイルにalwaysLoad言及なし）Closes #217