環境変数

ENABLE_TOOL_SEARCH

MCPツール検索の動作を制御し、必要なツールをオンデマンドで動的に読み込むかどうかを設定します。

使い方・用途

  • 大量のMCPツールがある場合に、すべての定義を最初からコンテキストに入れず、必要な時だけ検索して読み込むことでコンテキスト窓を節約します。
  • デフォルトで無効化されているVertex AIやカスタムプロキシ環境(ANTHROPIC_BASE_URL使用時)で、明示的にツール検索機能を有効化したい場合に設定します。
英語原文(公式ドキュメントより)

Controls MCP tool search. Unset: all MCP tools deferred by default, but loaded upfront on Vertex AI or when ANTHROPIC_BASE_URL points to a non-first-party host. Values: true (always defer including proxies and Vertex AI), auto (threshold mode: load upfront if tools fit within 10% of context), auto:N (custom threshold, e.g., auto:5 for 5%), false (load all upfront)

関連する変更履歴

v2.1.119 (1件)

Changed
Vertex AI でのサポートされていないベータヘッダーエラーを避けるため、ツール検索をデフォルトで無効にしました(ENABLE_TOOL_SEARCH で有効化可能)。
英語原文を表示
Tool search is now disabled by default on Vertex AI to avoid an unsupported beta header error (opt in with ENABLE_TOOL_SEARCH)

関連ドキュメント

v2.1.72 (1件)

Fixed
ANTHROPIC_BASE_URL 使用時でも ENABLE_TOOL_SEARCH が設定されていればツール検索が有効になるよう修正
英語原文を表示
Fixed tool search to activate even with ANTHROPIC_BASE_URL as long as ENABLE_TOOL_SEARCH is set.

変更前

LLM ゲートウェイ構成などで ANTHROPIC_BASE_URL を設定している場合、ENABLE_TOOL_SEARCH を明示的に設定していてもツール検索機能が正常に動作しないことがありました。

変更後

ANTHROPIC_BASE_URL の設定有無にかかわらず、ENABLE_TOOL_SEARCH 環境変数が設定されていればツール検索機能がアクティブになります。

ユーザーへの恩恵

カスタムプロキシやゲートウェイを経由するエンタープライズ環境でも、Claude Code の強力なツール検索機能を確実に利用できるようになります。