MCP説明文の文字数上限を設定可能に
CHANGELOG 原文(英語)
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 公式の変更履歴を開く ↗ 日本語での補足
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTHを追加。セッション内の全MCPサーバーについて、MCPツールの説明文とサーバー指示文の文字数上限(2,048文字)を変更できるように。
ドキュメント
ドキュメントの抜粋(参考訳)
Tool search for MCP server authors
MCP サーバーを構築している場合、tool search を有効にすると、サーバーの instructions フィールドがより役立つようになります。サーバー instructions は、スキルの仕組みと同様に、Claude がいつあなたのツールを検索すべきかを理解する助けになります。
次の内容を説明する、明確で分かりやすいサーバー instructions を追加してください。
- あなたのツールが扱うタスクのカテゴリー
- Claude がツールを検索すべきタイミング
- あなたのサーバーが提供する主要な機能
Claude Code は、ツールの説明やサーバー instructions が次の既定の上限を超えると切り詰め、Claude には切り詰められる前のテキストだけが見えます。
- サーバー instructions と、事前に読み込まれるツールの説明:4,096 文字
- Claude が tool search を通じて読み込むツールの説明:16,384 文字
説明と instructions は簡潔にまとめ、重要な内容は冒頭近くに配置してください。tool search が Claude のクエリをツールの説明と照合する際は、短い方の上限内の部分だけを読み取るため、Claude が検索に使いそうな語句も冒頭近くに置いてください。ツールが遅延読み込みされない場合は常に、そのツールは事前に読み込まれ、短い方の上限が適用されます。たとえば、tool search がオフの場合、ツールが事前読み込みに指定されている場合、またはそのサーバーが遅延読み込みの対象から除外されている場合です。
v2.1.296 より前は、短い方の上限は 2,048 文字でした。また v2.1.295 より前は、tool search を通じて読み込まれるものも含め、すべてのツールの説明にその上限が適用されていました。
説明の長さの上限を変更する
セッション内の MCP サーバーについて、サーバー instructions とツールの説明の既定の上限(4,096 文字と 16,384 文字)を変更するには、CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH に文字数を設定します。Claude Code はその数値を両方の上限に使います。たとえば 8192 を設定すると、事前に読み込まれるサーバー instructions とツールの説明に対する 4,096 文字の上限は引き上げられ、tool search を通じて読み込まれるツールの説明に対する 16,384 文字の上限は引き下げられます。この変数には Claude Code v2.1.280 以降が必要です。
Anthropic が api.anthropic.com でホストする一部の MCP サーバーからの説明と instructions は、そのまま Claude に伝わり、この変数を設定しても切り詰められません。
ツールを事前読み込みにするか、遅延読み込みのままにするかを指定する
サーバーの個々のツールの読み込み方法を制御するには、そのツールの _meta オブジェクトに "anthropic/alwaysLoad" を設定します。あなたのサーバーを Claude Code に追加する人も、自分の設定でサーバー全体に対して alwaysLoad を設定できますが、その設定があなたの設定を上書きすることがあります。
| ツール側の値 | 動作 |
|---|---|
true |
ツールは事前に読み込まれます。この値が原因で、起動時にあなたのサーバーを待つことはありません。サーバーを設定する側は、それでもそのサーバーのすべてのツールを遅延読み込みにすることができます |
false |
設定側が "alwaysLoad": true を指定している場合でも、そのツールは遅延読み込みのままになります。これは、あなたのサーバーが --mcp-config で渡される場合、Agent SDK アプリケーションから提供される場合、またはプラグインから提供される場合に当てはまります。他のサーバーでは、そのツールは事前に読み込まれます。Claude Code v2.1.285 以降が必要です |
次の tools/list のエントリは、1 つのツールを事前に読み込むよう指定します。
{
"name": "search_tickets",
"description": "Searches the ticket tracker by keyword",
"_meta": {
"anthropic/alwaysLoad": true
}
}
取得日 · 2026-11-20