Skip to content

feat(mcp): add alwaysLoad: true to recommended .mcp.json template #217

@liplus-lin-lay

Description

@liplus-lin-lay

目的

Claude Code v2.1.121 で MCP server config に alwaysLoad オプションが追加された。true を指定すると、その server の全 tool が tool-search deferral を skip して常時 prompt に常駐する。

github-webhook-mcp は webhook intake 経路で常用するため、deferred 状態から ToolSearch 経由でロードする 1 往復を毎ターン削減できる。

前提

  • Claude Code v2.1.121+ で alwaysLoad 認識される (release: 2026-04-28)
  • 旧 Claude Code は未知 field として無視 (後方互換)
  • 本 repo の README / docs に推奨 .mcp.json 例があれば、そこに alwaysLoad: true を追記

制約

  • alwaysLoad は MCP 1 server あたり全 tool を常駐化する。tool 数が多い server (本 server は ≥10 tool) は prompt 圧迫の trade-off があるため、ユーザーが webhook intake を実用しているケース推奨に留める

対象ファイル

  • README.md (.mcp.json 設定例があるセクション)
  • docs/ 配下の setup ガイド (該当箇所)

参考

Metadata

Metadata

Labels

enhancementNew feature or requestmemoissue started as note

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions