Claude Code におけるMCPのcontext消費に関するメモ

Last updated at 2026-04-29Posted at 2026-04-29

Claude Code で MCP を使う際、context に何が載り、どこを確認すべきかを整理したメモ。

MCP は外部ツールを扱える範囲を広げる一方で、tool 定義、探索用情報、tool 出力などが context に入る。
context 消費が増えると、長いファイル読込や追加指示に使える余地が減り、auto compact の発生も早くなる。
MCP の影響を見る時は、/context、/mcp、claude mcp list/get で実ロード状況と接続元を分けて確認する。
確認日: 2026-04-29
実測環境: macOS / zsh / Claude Code CLI 2.1.x 系

要旨

Claude Code の MCP context 消費は、主に

起動時に載る探索用情報
利用時に載る schema / 実行結果

に分けて考える。Tool Search が有効な環境では、起動時の主な負荷は tool 名や探索用情報で、詳細 schema は tool を使う段階で context に載る。
したがって、MCP のコンテキスト消費を確認する際には server 数だけでなく、Tool Search の状態、tool 数、実際に使う tool、tool 出力の大きさを確認する。

前提: MCP と Tool Search

MCP は、LLM アプリケーションと外部ツールをつなぐプロトコル。
Claude Code は MCP client として MCP server に接続し、server が公開する MCP tools を使う。
tool schema は tool の名前、説明、引数、JSON Schema などの呼び出し定義を指す。
MCP Tool Search は、MCP tool の詳細 schema を最初からすべて context に載せず、必要になった tool を検索して読み込む Claude Code の仕組み。

起動時ロード: セッション開始時点で tool schema を context に載せること。
必要時ロード: Claude Code が tool を必要とした段階で schema を読み込むこと。
auto: tool 定義の合計が context window の10%以内なら起動時ロード、超える場合は必要時ロード。
auto:N: tool 定義の合計が context window のN%以内なら起動時ロード、超える場合は必要時ロード。

未設定時は通常、必要時ロードになる。

確認手順

/context
/mcp
claude mcp list
claude mcp get <server-name>

Claude Code では、local / user scope の MCP server 定義は~/.claude.json、project scope は project root の .mcp.json に入る。

MCP 設定の重複

同名 server は Local > Project > User > Plugin > claude.ai connector の順で解決される。
重複として見る対象は、同じ用途の server が別名・別 endpoint・plugin / connector 経由で併存しているケース。

補足: MCP 以外の常駐分

SessionStart / UserPromptSubmit の hook output は Claude が見える context に追加される。
現行仕様では、context に注入される hook output（additionalContext / systemMessage / plain stdout）は 10,000 characters で cap され、超過分はファイルに保存されたうえで preview と file path に置き換えられる。
CLAUDE.md、rules、memory、Skill description も context に入るため、MCP の影響を見る時は切り分ける。

運用上の対応

MCP による context 消費量は MCP server 数だけでは決まらず、Tool Search の状態、tool 数、実際に使った tool、tool 出力で変わる。

project で頻繁に使う MCP だけを enabled にする
低頻度の MCP は、必要な時だけ追加する
同じ用途の MCP が複数ある場合は、使う経路を一本化する
Tool Search が無効になる設定を見直す
大量の tool 出力が返る MCP は、取得範囲を絞る

参考

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up