MCP Tool Search

問題: MCPサーバーが会話を始める前からコンテキストウィンドウを食い尽くしています。7つのサーバーがあると、200Kのうち使えるトークンは60〜90Kに減ります。難しいタスクは一文字も打つ前に死んでいます。

すぐに解決する方法: ツール定義がコンテキストウィンドウの10%を超えた瞬間、Claude CodeはMCP Tool Searchを自動的に有効にします。何も設定する必要はありません。/context を実行すると、新たに確保されたヘッドルームが確認できます。

MCP Tool Searchとは何か

ツール定義はかつてセッション開始時にすべて読み込まれていました。毎回、例外なく。新しいシステムはそれを小さな検索インデックスに置き換え、Claudeが実際に使おうとするときだけ完全なツール詳細を取得します。

MCP Tool Search導入前：

Starting session...
Loading 73 MCP tools... [39.8k tokens]
Loading 56 agents... [9.7k tokens]
Loading system tools... [22.6k tokens]
Ready with 92k tokens remaining.

MCP Tool Search導入後：

Starting session...
Loading tool registry... [5k tokens]
Ready with 195k tokens available.

User: "I need to query the database"
> Auto-loading: postgres-mcp [+1.2k tokens]
> 193.8k tokens remaining

複数のサーバーを使っている人にとって、起動時のコンテキスト消費は95%削減されます。

MCP Tool Searchの仕組み

トリガーは自動です。ツール説明トークンが10%のマークを超えると遅延読み込みが始まります。その後の流れ：

1. レジストリ作成: Claude Codeがツール名と説明の軽量インデックスを構築する
2. オンデマンド読み込み: ツールはClaudeがリクエストに必要だと判断したときのみ読み込まれる
3. インテリジェントキャッシュ: 読み込まれたツールはセッション中ずっと利用可能
4. 同じUX: MCPツールは以前とまったく同じように動作する。ワークフローの変更は不要

プロンプトはキーワードで読み取られます。適合しそうなツールだけが引き込まれます。それ以外はベンチに置かれたままです。

MCPサーバーを作る人へ

独自のサーバーを構築していますか？server instructions フィールドが今や重要な役割を担っています。MCP Tool Searchが有効な状態では、これがClaudeに「いつ呼び出すか」を伝えるものになります。

スキルの説明のように扱ってください。機能とトリガーワードを明記します：

{
  "mcpServers": {
    "my-custom-server": {
      "command": "node",
      "args": ["/path/to/server.js"],
      "serverInstructions": "Database operations for PostgreSQL including queries, schema management, and data migrations. Use for any database-related tasks."
    }
  }
}

良いサーバー指示に必要なこと：

• サーバーの機能を明確に説明する
• ユーザーがプロンプトで使いそうなキーワードを含める
• ツールをアクティブにすべきタイミングを指定する
• 短くても全体をカバーする

コンテキスト使用量の確認

2つのスラッシュコマンドで、何が読み込まれていて何が読み込まれていないかがわかります：

# Check current context usage
/context
 
# See which MCP tools are loaded
/mcp

遅延読み込みが有効になると、開始時のトークン数が大幅に下がることに気づくでしょう。Claudeが実際の作業のためにツールを引き込むにつれてカウントは上がりますが、実際に使ったものだけです。

設定オプション

デフォルト設定でほとんどの環境に対応します。動作を変えたい場合は、設定ファイルといくつかのスラッシュコマンドで調整できます。

Tool Searchの有効化・無効化

Claude Codeの設定からグローバルスイッチを切り替えます：

{
  "enable_tool_search": true
}

セッション開始時にすべてのMCPツールを読み込む従来の動作を希望する場合は、enable_tool_search を false に設定します。

サーバーごとの制御

特定のサーバーを無効化する（常に即座に必要なツールがある場合）：

/mcp disable tool-search my-always-needed-server

特定のツールを強制読み込みする（必要なことがわかっている場合）：

Load the github and postgres MCP tools for this session

実際の効果

この数値はGitHubイシュー#7336から直接引用しています。この機能のきっかけになったバグレポートです：

データベースサーバー、GitHub統合、ブラウザ自動化、カスタムAPIなどを含む重い構成を使っているビルダーが、ようやく上限にぶつからずフルのワークロードを実行できるようになりました。

互換性に関する注意

既存のMCPサーバーはすべて引き続き動作します。いくつか知っておくべき点があります：

• 古いサーバー: ツールの説明が不十分な場合、効率が下がる可能性がある
• カスタムサーバー: 最良の結果を得るために明確な serverInstructions を追加する
• 高頻度のツール: 常時使うサーバーは遅延読み込みを無効にすることを検討する

これが可能にすること

95%多くのコンテキストを使えるようになると、実際にこんなことができます：

• より長く、より複雑なコーディングセッションを実行する
• 複数のMCPサーバーを同時使用してもペナルティがない
• 長期にわたるワークフローで会話履歴を維持する
• 以前はコンテキスト制限で止まっていた複数ステップのタスクを実行する

次のステップ

MCP設定を最大限に活用するために：

1. サーバーを監査する: /context を実行して現在の使用状況を確認する
2. サーバー指示を更新する: カスタムサーバーに説明的な指示を追加する
3. さらなるサーバーを探索する: 人気MCPサーバーガイドを確認する。今ならペナルティなしで多くを実行できる
4. MCPの基礎を学ぶ: プロトコルが初めての場合はMCPの基本を確認する

コンテキスト税はMCPサーバーを積み重ねる最大のブレーキでした。遅延読み込みはそのブレーキを外します。使いたいサーバーを追加すれば、ランタイムがウィンドウを適正に保ちます。どのサーバーを組み合わせるか試行錯誤したくない場合は、ClaudeFastのCode Kitが18エージェントシステムとともに厳選されたMCP設定を提供しているので、最初のセッションからすでにチューニング済みです。