環境変数

MCP_DISCOVERY_CACHE

MCP ディスカバリーキャッシュをオンまたはオフにする。キャッシュが有効な場合、以前使用したリモート HTTP または SSE サーバーはキャッシュ済みステータスを表示でき、Claude Code は起動時ではなく最初のツール呼び出し時に接続する。キャッシュは、段階的ロールアウトによってアカウントで有効化されていない限りデフォルトでオフ。1を設定すると有効になり、0を設定するとロールアウトで有効化されていてもオフのままになる。v2.1.238 より前では、キャッシュはデフォルトでオンだった。キャッシュ済みステータスには Claude Code v2.1.221 以降が必要。

使い方・用途

  • リモートの HTTP/SSE サーバーのツール一覧をキャッシュし、接続をツール初回呼び出し時まで遅らせることで起動を軽くしたい場合
  • 以前使ったリモートサーバーの状態をキャッシュから表示させ、接続の見通しをよくしたい場合
  • 段階的なロールアウトでキャッシュが有効化されたアカウントで、意図的にキャッシュを無効のまま運用したい場合
英語原文(公式ドキュメントより)

Turns the MCP discovery cache on or off. With the cache on, a remote HTTP or SSE server you've used before can show the cached status, and Claude Code connects it on its first tool call instead of at startup. The cache is off by default unless a gradual rollout has enabled it for your account. Set to 1 to turn it on, or 0 to keep it off even when the rollout has enabled it. Before v2.1.238, the cache was on by default. The cached status requires Claude Code v2.1.221 or later

関連する変更履歴

v2.1.285(1件)

Changed
[Cloud sessions] 設定ファイルではなくクラウド環境の変数に MCP_DISCOVERY_CACHE=1 を設定した場合、セッション再起動後にコネクタのツールリストを再利用するよう変更した。他の MCP サーバーはキャッシュされなくなり、起動時に接続する。
英語原文を表示
[Cloud sessions] Changed MCP_DISCOVERY_CACHE=1, when set in your cloud environment's variables rather than a settings file, to reuse your connectors' tool lists after a session restart; other MCP servers are no longer cached and connect at startup

変更後

クラウドセッションを再起動しても、コネクタのツール一覧を再取得せずに再利用できるため、セッション開始までの時間を短縮できる。

関連ドキュメント