1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

10/23 の公式ドキュメント更新:MCP v2 ランタイムの既定条件とセキュリティ監視イベントの詳細化

1
Posted at

2026-10-23 のドキュメント更新は、MCP クライアントランタイムの v2 が既定で使われる条件の明確化と、OpenTelemetry の safety_event 属性の大幅な拡充が中心だ。加えて、サブエージェントへのパーミッションモード継承、環境変数によるリソース監視、Windows 環境でのフック挙動など、複数のページにまたがる実装上の細部が同時に補足されている。

MCP v2 ランタイムが適用されるセッションと、ツール再試行のアノテーション

MCP クライアントランタイム v2 が既定で使われる条件が明文化された。Claude Code v2.1.274 以降では、フィーチャーフラグを取得できるセッションで v2 がデフォルトになる。Amazon Bedrock、AWS 上の Claude Platform、Google Cloud の Agent Platform、Microsoft Foundry での動作であっても、ホストプラットフォームが CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST を設定している場合は v2 への切り替えが起きない。テレメトリやフラグ取得を無効化している場合(DISABLE_TELEMETRY など)も同様だ。

In the sessions where it doesn't fetch feature flags, Claude Code uses the v2 runtime by default on Claude Code v2.1.274 or later

(出典 [1])

(訳:フラグフェッチを行わないセッションでは、Claude Code v2.1.274 以降において v2 ランタイムがデフォルトで使用されます。)

v2 ランタイム上では、接続先サーバーがプロトコルリビジョン 2026-07-28 に対応しているかをプローブし、対応しているサーバーとはそのリビジョンで通信する。MCP サーバー開発者向けには、ツールの安全な再試行を宣言するアノテーション(idempotentHint と readOnlyHint)が追加された。接続が切れた際に HTTP サーバーまたは claude.ai コネクターへの呼び出しを一度だけ自動再試行できる。readOnlyHint を付けたツールは他の読み取り専用呼び出しと並列で実行される点も新たに説明されている。

plan モードはサブエージェントにも継承される

サブエージェントへのパーミッションモード継承が明文化された。メインセッションが plan モードにあるとき、AgentDefinition で permissionMode に acceptEdits を指定していても、サブエージェントは plan モードで動作する。

Plan mode holds for the subagents you define too, so that handing work to one doesn't get around reviewing the plan first.

(出典 [8])

(訳:定義したサブエージェントにもプランモードが適用されるため、作業を委譲してもプランの確認をすり抜けることはありません。)

dontAsk を設定したサブエージェントが plan モードのメインセッション下で実行された場合、plan モードが本来ユーザーに確認を求めるアクションは承認されるのではなく拒否される。この挙動は sub-agents ページと agent-sdk/permissions ページの両方で同期して説明された。

OpenTelemetry safety_event の属性定義と監視クエリマッピング

monitoring-usage ページで最も大きな追加となったのが、safety_event の属性一覧とセキュリティ監視クエリのマッピングだ。Claude Code v2.1.307 以降で出力されるこのイベントには、ツール呼び出しを拒否したチェックの種類(category)、判定(decision)、判定主体(decision_source)、フックやルールの設定ソース(rule_source)など詳細な属性が定義されている。

To find which one refused a call, look for the Safety event with the same tool_use_id and read its category and rule_source attributes.

(出典 [12])

(訳:どのチェックが呼び出しを拒否したかを特定するには、同じ tool_use_id を持つ safety_event を探し、category と rule_source 属性を確認してください。)

サンドボックスのネットワークプロキシが接続を拒否した場合は sandbox_violation_count 属性で件数を把握できる。自動モードのブロック理由は OTEL_LOG_TOOL_DETAILS=1 を設定した場合に classifier_category で参照できる。safety_event が存在しない呼び出しのケースも明文化された。tool_decision イベントで decision が reject かつ source が config であるものが、カテゴリなしで拒否されたケースに相当する。

環境変数によるディスク・メモリ空き容量の監視

v2.1.304 以降で、ディスクとメモリの残量を Claude に通知する変数が追加された。CLAUDE_CODE_WARN_DISK_FREE_GIB に整数の GiB 値を設定すると、作業ディレクトリのファイルシステムの空き容量がその値を下回ったときにシステムリマインダーが発行される。CLAUDE_CODE_WARN_MEMORY_FREE_GIB は Linux と WSL 向けで、利用可能メモリが閾値を下回ると同様に通知する。いずれも変数が未設定または 0 の場合は通知しない。長時間自動実行するタスクでストレージ不足が懸念される場合に役立つ。

CLAUDE.md のサイズ制限の明文化

メモリドキュメントで CLAUDE.md ファイルのサイズ制限が整理された。ルートの CLAUDE.md は 4 MiB を超えると内容が一切読み込まれない。

Claude Code skips a file over 4 MiB and loads none of it.

(出典 [10])

(訳:4 MiB を超えるファイルは Claude Code がスキップし、内容は一切読み込まれません。)

サブディレクトリの CLAUDE.md やルールファイルにはコンテキストウィンドウ依存の文字数上限がある。200K コンテキストウィンドウでは 40,000 文字、1M コンテキストでは Claude Opus 4.6 と Claude Sonnet 4.6 が 200,000 文字、それ以降のモデルでは 150,000 文字が上限だ。上限を超えたファイルは先頭部分のみが渡され、末尾に「残りは Read ツールで読んでください」という注記が付加される。v2.1.309 より前のバージョンではオンデマンド読み込みのファイルにこの制限が適用されていなかった。

フックの Windows 環境での失敗挙動

Windows 環境で Git Bash が見つからない場合のフック挙動が整理された。シェル形式のフックは Git Bash 未インストール環境では PowerShell で実行されるが、Bash 向けに書かれたスクリプトが正常に動作しないことがある。onFailure が未設定のままだと Git for Windows のインストール後に動作が変わりうるため、フック失敗時に呼び出しをブロックしたい場合は onFailure に block を設定したうえで shell に powershell を指定することが推奨されている。

その他の更新

  • スケジュールタスクの実行中、auto モードでは分類モデルが承認アクションを判定し、繰り返しブロックが閾値に達した場合のみ承認プロンプトが表示される(routines ページ)
  • CLAUDE_CODE_ENABLE_SHARE_BUNDLE を 1 にすると、/share が Anthropic に送信する代わりにローカルアーカイブへ保存する(v2.1.299 以降)
  • CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK を 1 にすると、信頼されていないフォルダで claude ultrareview が CI などでエラー終了するのを防げる(v2.1.309 以降)
  • ワークツリー作成がパーシャルクローンで失敗した場合のエラーと対処手順が追記された
  • /rewind はバッシュコマンドのみが変更したファイルを追跡しない。バージョン管理で元に戻す必要がある
  • 外部ディレクトリのスキルがプロジェクトスキルと名前衝突する場合、プレフィックス付き名(/:)で実行される(v2.1.309 以降)

まとめ

2026-10-23 の更新は、MCP サーバー開発者とエンタープライズ管理者の両方に直接影響する。MCP サーバーを運用する開発者は v2 ランタイムの適用条件とツールアノテーションの追加を確認することで、接続障害時の自動再試行を設計に組み込める。組織のセキュリティ監視を担う管理者は safety_event の属性定義と監視クエリマッピングを活用して、拒否されたツール呼び出しの原因をより精密に特定できる。リソース監視用の環境変数は、長時間実行タスクの安定性向上に寄与する実用的な追加だ。

出典

本稿の引用はすべて一次資料と逐語照合(verify_article 通過)のうえ掲載しています(2026-10-31 検証)。

[1] https://code.claude.com/docs/en/mcp
[2] https://code.claude.com/docs/en/routines
[3] https://code.claude.com/docs/en/env-vars
[4] https://code.claude.com/docs/en/slash-commands
[5] https://code.claude.com/docs/en/skills
[6] https://code.claude.com/docs/en/checkpointing
[7] https://code.claude.com/docs/en/sub-agents
[8] https://code.claude.com/docs/en/agent-sdk/permissions
[9] https://code.claude.com/docs/en/hooks
[10] https://code.claude.com/docs/en/memory
[11] https://code.claude.com/docs/en/worktrees
[12] https://code.claude.com/docs/en/monitoring-usage

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?