環境変数

CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH

Claude Code がモデルへ送る各 MCP ツール説明および各 MCP サーバーの指示文の最大文字数(既定値: 2048)。これより長いテキストは Claude Code によって切り詰められます。通常の数字で表された正の整数を受け付け、それ以外の値は無視されて既定値が適用されます。Claude Code v2.1.280 以降が必要です。

使い方・用途

  • MCP ツールの説明文とサーバー指示文には 2,048 文字の上限が固定で適用されていたため、長い説明を持つツールは切り詰められ、Claude がツールの機能を十分に把握できない可能性があった
  • この環境変数を設定すると、セッション内のすべての MCP サーバーに対して 2,048 文字の上限を変更でき、環境変数を設定するだけで説明文の文字上限を調整できるようになる
  • 詳細なツール説明を活かした MCP サーバー運用が可能になる。MCP サーバー作者向けには、tool search 有効時、サーバー指示文は skills のように Claude がツールを検索すべきタイミングを把握するのに役立つと案内されている
  • Claude Code v2.1.280 以降が必要。正の整数を通常の数字で指定し、それ以外の値は無視されて既定値が適用される
英語原文(公式ドキュメントより)

Maximum length in characters of each MCP tool description and each MCP server's instructions that Claude Code sends to the model (default: 2048). Claude Code truncates longer text. Accepts a positive whole number in plain digits. Anything else is ignored and the default applies. Requires Claude Code v2.1.280 or later

関連ドキュメント

関連する変更履歴

v2.1.280(1件)

Added
セッション内のすべての MCP サーバーを対象に、MCP ツール説明とサーバー指示文に適用される 2,048 文字の上限を変更できる環境変数 CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH を追加した。
英語原文を表示
Added CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH to change the 2,048-character cap on MCP tool descriptions and server instructions for every MCP server in the session

変更前

MCP ツールの説明文とサーバー指示文には 2,048 文字の上限が固定で適用され、それを調整する方法がなかった。長い説明を持つツールは切り詰められ、Claude がツールの機能を十分に把握できない可能性があった。

変更後

CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH を設定すると、セッション内のすべての MCP サーバーに対して、MCP ツール説明とサーバー指示文に適用される 2,048 文字の上限を変更できる。従来はこの上限が固定値であり、ツール説明が長いサーバーでは説明が切り詰められていた。

ユーザーへの恩恵

環境変数を設定するだけで説明文の文字上限を調整できるようになり、詳細なツール説明を活かした MCP サーバー運用が可能になる。

関連ドキュメント