Skip to content

feat(mcp): add alwaysLoad: true to plugin .mcp.json #139

@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-rag-mcp は research 経路で常用するため、deferred 状態から ToolSearch 経由でロードする 1 往復を毎ターン削減できる。

前提

  • Claude Code v2.1.121+ で alwaysLoad 認識される (release: 2026-04-28)
  • 旧 Claude Code は未知 field として無視 (後方互換)
  • 本 repo は plugin 形態で .mcp.json を同梱しているため直接編集対象になる

制約

  • 本 server の tool 数は search を含む小数で prompt 圧迫リスクは低い
  • HTTP/OAuth 型のため接続失敗時の振る舞いは alwaysLoad 設定に依存しない (MCP retry は v2.1.121 で 3 回まで auto-retry に改善済)

対象ファイル

  • .mcp.json (plugin root)

変更案

```json
{
"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."
}
}
}
```

参考

Metadata

Metadata

Labels

enhancement新機能・改善要望memoメモとして開始した状態。見出しは必要なものだけでよい

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions