MCP サーバーのトークン消費はどれくらい？減らすには？
Claude Code はデフォルトで、MCP のツール名とサーバーの説明だけをコンテキストに入れ、ツールの完全な定義は使うときに読み込みます。サーバーを少し増やしても、影響はわずかです。Codex では、MCP サーバーごとに、すべてのメッセージのコンテキストが増えます。対策はどちらも同じで、使わないものをオフにすることです。
Codex
MCP サーバーはどれも、メッセージごとのコンテキストを増やし、制限を多く消費します。OpenAI は、数を減らし、不要なときはオフにするようすすめています。
CLI で /mcp と入力すると、このセッションのサーバーを確認できます。設定したものをすべて見るには codex mcp list を実行します。消費を止めるのに、サーバーを削除する必要はありません。~/.codex/config.toml の [mcp_servers.<名前>] の下に enabled = false と書き、必要になったら戻します。サーバーのツールを 1 つか 2 つしか使わないなら、enabled_tools に列挙します。それ以外のツールはモデルに渡されません。Codex がツールの定義を必要なときだけ読み込むかどうかを、OpenAI は文書化していません。
公式ドキュメントの記載
Limit the number of MCP servers you use. Every MCP server adds more context to your messages and uses more of your limit. Disable MCP servers when you don't need them.enabled (optional): Set false to disable a server without deleting it.enabled_tools (optional): Tool allow list.Claude
デフォルトではごくわずかです。コンテキストに入るのはツール名とサーバーの説明だけです。/context で確認し、使わないサーバーは /mcp でオフにします。
Claude Code では tool search がデフォルトでオンです。ツールの完全な定義は、Claude がそのツールを使うまでコンテキストに入りません。サーバーを増やしても影響はわずかだと Anthropic が述べているのは、このためです。もう 1 つのコストは、ツールが返す内容です。Claude Code は、MCP の 1 回の出力が 10,000 トークンを超えると警告を出し、デフォルトで 25,000 トークンを上限とします。それより大きいものはファイルに保存され、会話にはパスだけが残ります。/mcp でオフにしたサーバーは現在のプロジェクトだけでオフになり、設定は残ります。
公式ドキュメントの記載
MCP tool definitions are deferred by default, so only tool names and server instructions enter context until Claude uses a specific tool. Run /context to see what's consuming space.Only tool names and server instructions load at session start, so adding more MCP servers has minimal impact on your context window.Output warning threshold: Claude Code displays a warning when any MCP tool output exceeds 10,000 tokensDefault limit: the default maximum is 25,000 tokensPrefer CLI tools when available: Tools like gh, aws, gcloud, and sentry-cli are still more context-efficient than MCP servers because they don't add any per-tool listing.On a Pro, Max, Team, or Enterprise plan, /usage also shows a breakdown of what counts against your plan limits: Attribution: recent usage attributed to skills, subagents, plugins, and individual MCP servers, each shown as a percentage of the total.If you've logged into Claude Code with a claude.ai account, MCP servers you've added in claude.ai, known as connectors, are automatically available in Claude CodeYou can also run /mcp to toggle any connector Claude Code fetches on or off for the current project only.サードパーティのプロキシ経由では、ツールの定義がすべて読み込まれる
このデフォルトには例外が 1 つあります。ANTHROPIC_BASE_URL が中継サービスやゲートウェイなど、Anthropic 以外のホストを指していると、Claude Code は tool search をオフにします。ほとんどのプロキシが、tool search に必要なブロックを転送しないためです。
その場合、MCP のツールの定義がすべて最初からコンテキストに入り、インストールしているサーバーの数が効いてきます。プロキシを使っているなら、まず /context と入力して MCP が占めている量を確認し、このプロジェクトに必要のないサーバーをオフにしましょう。
公式ドキュメントの記載
Tool search is enabled by default: MCP tools are deferred and discovered on demand. Claude Code disables it when ANTHROPIC_BASE_URL points to a non-first-party host, since most proxies don't forward tool_reference blocks.よくある誤解
- 呼び出さない MCP サーバーにはコストがかからない
そうではありません。Codex では、有効なサーバーはどれも、使っても使わなくても、すべてのメッセージのコンテキストを増やします。Claude Code がデフォルトで持ち運ぶのはツール名だけで、少量ですがゼロではありません。サードパーティのプロキシ経由のとき、または alwaysLoad を設定したときは、ツールの定義をすべて持ち運びます。使わないものはオフにしましょう。
- Claude Code では、MCP サーバーが多いほど必ずトークンが増える
デフォルトではそうなりません。Claude Code はツールの定義の読み込みを後回しにし、Anthropic は MCP サーバーを追加してもコンテキストへの影響はわずかだと述べています。コストになるのは 2 つの場合です。tool search がオフになっているとき（プロキシ経由でよく起こります）と、ツールが 1 回の呼び出しで大量の内容を返すときです。
- トークンを消費しているのはツールの一覧だ
それだけではありません。ツールの一覧は固定のコストで、たいていはツールが返す内容のほうが大きくなります。結果はすべて会話に残り、その後のメッセージのたびにもう一度送られます。MCP の 1 回の出力はデフォルトで 25,000 トークンに達することがあり、これはツールの定義をいくつも合わせた分を上回ります。
ヒント
- Claude Code：/context と入力して、MCP のツールがコンテキストをどれだけ占めているかを確認します。
- Claude Code：/mcp と入力し、このプロジェクトに必要のないサーバーをオフにします。必要になったらオンに戻します。
- Claude Code：/usage と入力して、最近の使用量に占める各 MCP サーバーの割合を確認します。割合が高く、めったに使わないものから手を付けましょう。
- コマンドラインのツール（gh、aws、gcloud、sentry-cli）があるなら、対応する MCP サーバーを追加する代わりに、エージェントにコマンドを実行させます。
- Claude Code：そのツールが毎ターン必要でない限り、サーバーに alwaysLoad: true を設定しないでください。設定すると、そのサーバーのツールがすべてセッションの最初に読み込まれます。
- Claude Code：claude.ai のアカウントでサインインすると、claude.ai で追加したコネクタが Claude Code に自動的に表示されます。このプロジェクトで使わないものは /mcp でオフにするか、設定に "disableClaudeAiConnectors": true と書いてすべてオフにします。
- Codex：~/.codex/config.toml で、使っていないサーバーには enabled = false を、少数のツールしか必要のないサーバーには enabled_tools を書きます。
- 返ってくる量を減らしましょう。クエリでは範囲と行数を絞り、テーブル全体やページ全体を取得しないようにします。