From 91d82af137057380c3f277686bc71917e454e98a Mon Sep 17 00:00:00 2001 From: Claude Lin & Lay Date: Tue, 28 Apr 2026 23:15:02 +0900 Subject: [PATCH] docs(mcp): recommend alwaysLoad: true for Claude Code v2.1.121+ MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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) --- docs/installation.ja.md | 3 +++ docs/installation.md | 3 +++ mcp-server/README.md | 6 +++++- 3 files changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/installation.ja.md b/docs/installation.ja.md index 334d94e..9ead2a1 100644 --- a/docs/installation.ja.md +++ b/docs/installation.ja.md @@ -66,6 +66,7 @@ A browser window should have opened automatically. Sign in on GitHub, then retry "github-webhook-mcp": { "command": "npx", "args": ["github-webhook-mcp"], + "alwaysLoad": true, "env": { "WEBHOOK_WORKER_URL": "https://github-webhook-mcp.example.workers.dev", "WEBHOOK_CHANNEL": "1" @@ -77,6 +78,8 @@ A browser window should have opened automatically. Sign in on GitHub, then retry `WEBHOOK_CHANNEL=1` でリアルタイムチャンネル通知を有効化（Claude Code CLI のみ）。 +`alwaysLoad: true` は Claude Code v2.1.121 以降で利用可能。本サーバーのツールを tool-search の deferral 対象から外し、毎ターン即座に利用可能にします（UserPromptSubmit hook 経由で毎ターン呼ばれるため推奨）。 + ### Codex — config.toml ```toml diff --git a/docs/installation.md b/docs/installation.md index ec33332..067f8ca 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -66,6 +66,7 @@ A browser window should have opened automatically. Sign in on GitHub, then retry "github-webhook-mcp": { "command": "npx", "args": ["github-webhook-mcp"], + "alwaysLoad": true, "env": { "WEBHOOK_WORKER_URL": "https://github-webhook-mcp.example.workers.dev", "WEBHOOK_CHANNEL": "1" @@ -75,6 +76,8 @@ A browser window should have opened automatically. Sign in on GitHub, then retry } ``` +`alwaysLoad: true` requires Claude Code v2.1.121 or later. It exempts this server's tools from tool-search deferral so they remain immediately callable every turn (recommended because the server is invoked every turn via the UserPromptSubmit hook). + `WEBHOOK_CHANNEL=1` でリアルタイムチャンネル通知を有効化（Claude Code CLI のみ）。 ### Codex — config.toml diff --git a/mcp-server/README.md b/mcp-server/README.md index d252ec0..c714ef5 100644 --- a/mcp-server/README.md +++ b/mcp-server/README.md @@ -62,7 +62,8 @@ Add the server to your MCP client configuration. Example for Claude Desktop (`cl "mcpServers": { "github-webhook": { "command": "npx", - "args": ["-y", "github-webhook-mcp"] + "args": ["-y", "github-webhook-mcp"], + "alwaysLoad": true } } } @@ -76,6 +77,7 @@ To target a self-hosted Worker, set the `WEBHOOK_WORKER_URL` environment variabl "github-webhook": { "command": "npx", "args": ["-y", "github-webhook-mcp"], + "alwaysLoad": true, "env": { "WEBHOOK_WORKER_URL": "https://your-worker.example.workers.dev" } @@ -84,6 +86,8 @@ To target a self-hosted Worker, set the `WEBHOOK_WORKER_URL` environment variabl } ``` +`alwaysLoad: true` requires Claude Code v2.1.121 or later. It exempts this server's tools from tool-search deferral so they remain immediately callable every turn (recommended because the server is invoked every turn via the UserPromptSubmit hook). + ### Codex (`config.toml`) ```toml