0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

2026-10-05 の公式ドキュメント更新:MCP ツール出力の上限制御

0
Posted at

この日の追加は、MCP ツールのレスポンスに対して機能する文字数とトークン数という二種類の上限の詳細仕様と、それに関連する環境変数の補足記述を中心としています。

文字数とトークン数、二つの上限がどう機能するか

Claude Code は MCP ツールの出力に対して、文字数とトークン数という二つの独立した上限を持っています。

文字数の上限は 2026-10-05 時点で 50,000 文字に固定されており、画像コンテンツを含まない成功レスポンスがこれを超えると、内容はファイルに保存されて会話中の参照はファイルパスへの言及に置き換わります。

saves it to a file and replaces it in the conversation with a message that names the file path, so Claude reads the file when it needs the content.

(出典 [1])

(訳:その内容はファイルに保存され、会話中にはファイルパスを示すメッセージに置き換わります。Claude は内容が必要なときにそのファイルを読み込みます。)

この 50,000 文字という閾値は、環境変数 MAX_MCP_OUTPUT_TOKENS を変更しても変わりません。MAX_MCP_OUTPUT_TOKENS はトークン数の上限を制御するもので、デフォルトは 25,000 トークン(2026-10-05 時点)です。環境変数のドキュメントには画像コンテンツに関する注記が追記されており、ツールが anthropic/maxResultSizeChars アノテーションを持っていても、画像コンテンツのトークン上限は常に MAX_MCP_OUTPUT_TOKENS が適用されます。

MCP サーバー開発者向け:ツール単位の文字数上限設定

tools/list レスポンスの各ツールエントリの _meta フィールドに anthropic/maxResultSizeChars を設定することで、そのツール固有の文字数上限を宣言できます。

you can allow individual tools to return results larger than the default persist-to-disk threshold of 50,000 characters by setting _meta

(出典 [1])

(訳:_meta を設定することで、個々のツールがデフォルトの 50,000 文字のディスク保存閾値を超えた結果を返せるようにすることができます。)

このアノテーションがない場合、50,000 文字を超えた成功レスポンスは自動的にファイル保存され、会話中はファイル参照に置き換わります。

その他の更新

  • エラーレスポンスの扱い:isError: true のレスポンスのテキストが約 11,000 文字(2026-10-05 時点)を超えた場合、先頭 5,000 文字と末尾 5,000 文字のみが保持され、間に削除された文字数を示すマーカーが挿入されます。
  • CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS:-p フラグを使ったノンインタラクティブモードで、最終ターン後にサブエージェントやワークフローなどのバックグラウンド処理を待つアイドル時間の上限をミリ秒単位で設定できる環境変数です。
  • MAX_STRUCTURED_OUTPUT_RETRIES:--json-schema を使ったノンインタラクティブモードで、スキーマ検証失敗が続いた場合のリトライ上限回数です。この回数を超えると、有効な出力が得られないまま実行が失敗します。

まとめ

この日の更新により、MCP ツールの出力に対する文字数上限(50,000 文字、固定)とトークン上限(MAX_MCP_OUTPUT_TOKENS、デフォルト 25,000 トークン)が独立して機能することが明確になりました。MCP サーバーを構築している開発者は、ツール単位の文字数上限設定を活用することで、大きなレスポンスを返すツールの設計指針を得られます。また、ノンインタラクティブモードに関わる二つの環境変数も同日に追記されており、CI/CD パイプラインや自動化スクリプトで Claude Code を使っている場合は内容の確認が必要です。

出典

本稿の引用はすべて一次資料と逐語照合(verify_article 通過)のうえ掲載しています(2026-10-07 検証)。

[1] https://code.claude.com/docs/en/mcp
[2] https://code.claude.com/docs/en/env-vars

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?