サブエージェントでMCPのトークン消費は増える?エージェントごとのツール一覧の重複課金、並列起動のキャッシュミス、MCPツールの絞り方【Claude Code・Agent SDK、2026年版】
サブエージェントはそれぞれMCPのツール定義を読み込み、同時に起動するとキャッシュ書き込みも重なります。起動時に読み込むもの、Sonnet 5.5での試算(1,000回あたり348.58ドル→76.58ドル)、任せるべきかの損益分岐、tools・disallowedTools・mcpServersでサブエージェントごとにMCPツールを絞る方法を解説します。
最終更新:2026年11月21日 / 対象:Claude Codeのサブエージェント(
tools・disallowedTools・mcpServers・model)、Claude Agent SDKのAgentDefinition、エージェントチーム、Claude APIのプロンプトキャッシュ(プレフィックスの順序、同時リクエスト)、Claude Sonnet 5.5・Haiku 5.5の料金
サブエージェントは「トークンの節約になる」と紹介されることが多い仕組みです。長い作業を別のコンテキストで行い、要約だけを戻すので、ツールの結果については確かにそうです。ところが、MCPのツール一覧については自動的には節約になりません。サブエージェントは1つずつが独立したモデルのインスタンスで、自分のコンテキストを持ちます。そのため、MCPサーバーを引き継いだサブエージェントは、ツール定義の分のトークン(MCP Token)をそれぞれ払い直します。さらに、同時に起動したサブエージェントは、同じ内容に対してそれぞれキャッシュ書き込みの料金を払うことがあります。この記事では、マルチエージェント構成でMCPのトークン消費が増える仕組みを整理し、計算方法つきで費用を試算し、サブエージェントを使うべきかの損益分岐の目安と、Claude Code・Agent SDK・自作のオーケストレーターでサブエージェントごとにMCPツールを絞る方法をまとめます。
この記事の「トークン」はLLMのトークン(コンテキストと課金)のことで、APIキーやOAuthのアクセストークンのことではありません。
結論(30秒で読める要約)
- サブエージェントは、固定部分(ツール定義とシステムプロンプト)をそれぞれ持ちます。 Claude Codeのドキュメントには、各サブエージェントは独自のシステムプロンプト、ツールへのアクセス、権限を持ち、自分のコンテキストウィンドウで動くと書かれています。
toolsを省略すると、MCPツールを含め、サブエージェントが使えるツールをすべて引き継ぎます。 - 同時に起動すると、キャッシュがそろって外れます。 Anthropicのキャッシュのドキュメントでは、キャッシュは最初のレスポンスが始まってから使えるようになります。同じ2万トークンのツール一覧を持つ5つのサブエージェントを同時に起動すると、5つともキャッシュ書き込みの料金を払います。
- 私の試算(Sonnet 5.5、サブエージェント5つ×各8リクエスト、固定部分のみ)では、1,000回あたりの費用は次のとおりでした。 ツール一覧をすべて引き継いで同時に起動すると348.58ドル、ツールの後ろにキャッシュの区切りを置いて1つ目を先に起動すると156.58ドル、各サブエージェントのツールを3,000トークンに絞ると76.58ドルです。同じ40リクエストを1つのエージェントで行うと139.43ドルでした。
- サブエージェントが得になるのは、メインの会話から外せるツール結果が大きく、メインの会話がその後も長く続くときです。 目安は R × m ≥ P × (w/r + k − 1) で、6章で説明します。
- サブエージェントごとにMCPツールを絞りましょう。 Claude Codeでは
tools/disallowedToolsにmcp__server__*の形で書き、1つのサブエージェントだけが使うサーバーはmcpServersにその場で定義します。こうすると、そのツールはメインの会話に入りません。自作のオーケストレーターでは、各ワーカーに必要なツールだけを渡し、共通のツールの後ろにキャッシュの区切りを置きます。
目次
- 「サブエージェントのMCPトークン消費」とは
- サブエージェントが起動時に読み込むもの
- マルチエージェントでMCPのトークン消費が増える3つの理由
- 試算の前提と計算式
- 結果:5つの構成でのツール一覧の費用
- 損益分岐:サブエージェントでMCPトークンが減るのはどんなときか
- サブエージェントごとにMCPツールを絞る方法(Claude Code・Agent SDK・API)
- チェックリスト
- よくあるハマりどころ
- NodeFlareならこう解決できる
- FAQ
- まとめ
1. 「サブエージェントのMCPトークン消費」とは
サブエージェントのMCPトークン消費とは、作業を任されたエージェントがMCPに使う入力・キャッシュ・出力のトークンのことです。中身は、各サブエージェントのコンテキストに読み込まれるMCPのツール定義と、その中で行われるツール呼び出しと結果です。前者は「タスク1回につき1回」ではなく「サブエージェント1つにつき1回」かかる固定部分なので、エージェントの数に比例して増えます。
Anthropicは自社のリサーチ機能でこの影響を測っています。同社の記事によると、エージェントは通常のチャットの約4倍、マルチエージェントは約15倍のトークンを使います。同じ記事では、ブラウジングの評価で性能の差の80%はトークン使用量だけで説明できたとしており、トークンが増えること自体にも意味はあります。MCPを使う側にとっての問題は、そのうちどれだけが役に立つ作業で、どれだけが全ワーカーに配り直される同じツール一覧なのか、という点です。
エージェントチームについては、Claude Codeの費用のドキュメントに具体的な倍率があります。チームメイトがプランモードで動く場合、各チームメイトが自分のコンテキストを持つ別のインスタンスとして動くため、通常のセッションの約7倍のトークンを使うとされています。チームメイトは CLAUDE.md、MCPサーバー、スキルを自動で読み込むとも書かれています。
2. サブエージェントが起動時に読み込むもの
サブエージェントは新しいコンテキストから始まります。親の会話履歴は見えませんが、自分用の固定部分は読み込み、その中にツール定義が含まれます。
| 項目 | Claude Code / Agent SDKのサブエージェント | 出典 |
|---|---|---|
| 親の会話履歴・ツール結果 | 読み込まない | Agent SDKのサブエージェントのドキュメント |
| 親のシステムプロンプト | 読み込まない。自分のプロンプトと作業ディレクトリなどの基本情報だけ | Claude Codeのサブエージェントのドキュメント |
| タスクの指示 | Agentツールに渡したプロンプト文字列だけ | Agent SDKのドキュメント |
| ツール定義 | 親から引き継ぐか、tools で指定した一部 |
Agent SDKのドキュメント |
| MCPツール | tools を省略すると引き継ぐ |
Claude Codeのドキュメント |
CLAUDE.md・git status |
読み込む。ただしExploreとPlanは速く安くするため両方を省く | Claude Codeのドキュメント |
| コンテキストの大きさ | サブエージェント自身のモデルで決まる | Claude Codeのドキュメント |
MCPに関しては、ドキュメントの2つの点が重要です。1つ目に、組み込みの general-purpose サブエージェントは、サブエージェントが使えるツールをすべて持ちます。これに作業を任せると、MCPツールもすべてついてきます。2つ目に、サブエージェントは入れ子にできます。Agent SDKでは既定でメインの下に3階層まで作れ(CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH)、1つのプロンプトからエージェントのツリーが育つことがあります。その1つずつが固定部分を持ちます。
Claude Codeのサブエージェントが、MCPのツール一覧を実際にどこまで読み込むかは、遅延読み込みによって変わります。費用のドキュメントには、MCPのツール定義は既定で遅延読み込みされ、Claudeが特定のツールを使うまではツール名とサーバーの説明(instructions)だけがコンテキストに入る、とあります。サブエージェントの中での動きは別に書かれていないので、実際に計測してください(7章)。この記事で扱う「スキーマ全体の重複課金」が最もそのまま当てはまるのは、Messages APIで自作したオーケストレーターと、最初に全スキーマを送るクライアントやフレームワークです。
3. マルチエージェントでMCPのトークン消費が増える3つの理由
1. エージェントごとのツール一覧の課金。 サブエージェントがN個あれば、MCPのツール定義はコンテキストごとにN回送られ、各サブエージェントの中でもリクエストのたびに読み直されます。1つのエージェントならキャッシュ書き込みは1回ですが、N個のエージェントでは、キャッシュを共有できない限りN回になります。
2. 同時起動によるキャッシュミス。 プロンプトキャッシュは、すでにキャッシュされた内容にしか効きません。ドキュメントには「同時リクエストでは、キャッシュは最初のレスポンスが始まってから使えるようになる。並列リクエストでキャッシュを当てたいなら、最初のレスポンスを待ってから次を送る」とあります。Anthropicのリサーチ機能は3〜5個のサブエージェントを並列に起動しており、これはまさに最初のリクエストがすべて書き込みになる形です。
3. 内容が違うとキャッシュを共有できない。 キャッシュが当たるには、該当部分が100%同じである必要があります。また、キャッシュのプレフィックスは tools、system、messages の順に作られます。サブエージェントはふつうシステムプロンプトがそれぞれ違うので、システムプロンプトの最後にだけ区切りを置くと、サブエージェントごとに別のキャッシュになります。ツールが先頭にあるので、最後のツール定義にも区切りを置けば、プロンプトが違っても、同じツール一覧を持つサブエージェントどうしでツール部分を共有できます。逆に、エージェントごとにツールを絞ると1つずつのサイズは小さくなりますが、内容がばらばらになるので共有はできなくなります。この兼ね合いは5章で見ます。
4. 試算の前提と計算式
以下の数値はすべて私の計算で、実測ではありません。エージェントの数に比例して増える固定部分(ツール定義とシステムプロンプト)だけを計算しています。ツール結果、履歴の増加、出力は含めていません。それらは長いセッションの記事で扱っています。
| 前提 | 値 |
|---|---|
| モデル | Claude Sonnet 5.5:入力2ドル、5分キャッシュの書き込み2.50ドル、読み込み0.10ドル(100万トークンあたり、Claude APIの料金ページ) |
| 1回あたりのサブエージェント数(N) | 5 |
| サブエージェントあたりのリクエスト数(k) | 8 |
| MCPのツール定義(T) | 20,000トークン(すべて引き継ぐ場合)または3,000トークン(サブエージェントごとに絞った場合) |
| サブエージェントのシステムプロンプトとタスク | 1,500トークン |
| ツール利用のシステムプロンプト | 286トークン(tool_choice が auto、Sonnet 5.5) |
| サブエージェントあたりの固定部分(P) | T + 1,786トークン |
| キャッシュ | 5分キャッシュ。システムプロンプトの後ろに区切り(表で示す場合はツールの後ろにも) |
各サブエージェントが自分でキャッシュを書き込む場合の、1回あたりの費用:
費用 = N × [P × w + (k − 1) × P × r]
wは1トークンあたりのキャッシュ書き込み単価、rは読み込み単価です。ツールの後ろに共通の区切りを置き、1つ目を先に起動した場合は、ツール部分(T)を書き込むのは最初のサブエージェントだけです。残りはそれを読み込み、自分の1,786トークン分だけを書き込みます。
5. 結果:5つの構成でのツール一覧の費用
| 構成(注記がなければSonnet 5.5) | キャッシュ書き込み(トークン) | キャッシュ読み込み(トークン) | 1回あたり | 1,000回あたり |
|---|---|---|---|---|
| A. 2万トークンの一覧をすべて引き継ぎ、5つを同時に起動 | 108,930 | 762,510 | 0.3486ドル | 348.58ドル |
| B. 2万トークンの一覧、ツールの後ろに区切り、1つ目を先に起動 | 28,930 | 842,510 | 0.1566ドル | 156.58ドル |
| C. サブエージェントごとに3千トークンへ絞る、同時起動(共有なし) | 23,930 | 167,510 | 0.0766ドル | 76.58ドル |
| D. Cと同じ構成をClaude Haiku 5.5で(書き込み0.125ドル、読み込み0.01ドル) | 23,930 | 167,510 | 0.0047ドル | 4.67ドル |
| E. 参考:1つのエージェントで40リクエスト、2万トークンの一覧 | 21,786 | 849,654 | 0.1394ドル | 139.43ドル |
キャッシュを使わない場合、A・B・Eはどれも1,000回あたり1,742.88ドル(40リクエスト × 21,786トークン × 100万トークンあたり2ドル)、Cは382.88ドルです。
表から分かること:
- Aで費用が増える原因は、リクエスト数ではなく同時起動です。 AとEは同じ大きさの固定部分で同じ40リクエストを送りますが、Aは書き込みが1回ではなく5回になるので2.5倍になります。
- ツール部分を共有すれば、大部分を取り戻せます。 Bはツールの後ろの区切りと起動のずらしだけで、1つのエージェントとの差が1,000回あたり約17ドルまで縮まります。
- ツール一覧が大きいなら、共有より絞るほうが効きます。 Cはキャッシュを共有しないのにBより安くなります。固定部分が21,786トークンではなく4,786トークンだからです。ツール一覧が6万トークンなら、Aは1,000回あたり988.58ドルになります。
- モデルの選択は絞り込みと掛け算で効きます。 この条件ではHaiku 5.5は10万トークンの料金の境目より下なので、絞ったワーカーは1,000回あたり4.67ドルです。Claude Codeの費用のドキュメントも、簡単なサブエージェントの作業には
model: haikuを指定するよう勧めています。
6. 損益分岐:サブエージェントでMCPトークンが減るのはどんなときか
トークンの面でサブエージェントが得になるのは、メインの会話から外せるツール結果のコストが、サブエージェント自身の固定部分のコストより大きいときです。Rをメインのコンテキストから外せる結果のトークン数、mをその後にメインの会話で送るリクエスト数とすると、メインのエージェントはRを約m回読み直すはずでした。一方、サブエージェントの追加コストは、固定部分の書き込み1回とその読み込みです。
損益分岐:R × m ≥ P × (w/r + k − 1)
Sonnet 5.5ではw/r = 2.50 ÷ 0.10 = 25です。k = 8の場合:
| サブエージェントの固定部分(P) | 必要なR × m | 例:結果3万トークンを外せる場合 |
|---|---|---|
| 21,786(2万トークンの一覧をすべて) | 697,152 | メインの会話がその後24リクエスト以上続けば得 |
| 4,786(3千トークンに絞った一覧) | 153,152 | 6リクエスト以上で得 |
サブエージェントが返す要約と出力トークンは入れていないので、実際の損益分岐はこれより少し厳しくなります。実務での読み方としては、ログの分析、テストの実行、広い調査のような長い作業を、ツールを絞ったサブエージェントに任せるのが基本です。短い作業を、MCPツールをすべて引き継ぐ general-purpose に任せると、メインの会話でやるより高くつくことがあります。
7. サブエージェントごとにMCPツールを絞る方法(Claude Code・Agent SDK・API)
Claude Code:tools・disallowedTools と mcpServers のその場定義
各サブエージェントには、必要なMCPツールだけを渡します。MCPツールの名前は mcp__<server>__<tool> で、mcp__<server>__* と書くと1つのサーバーのツールすべてに一致します。ドキュメントでは、末尾の __* がないと mcp__reports__v2 はそのサーバーのどのツールにも一致しないと注意しています。
---
name: issue-triager
description: Read and label issues in the tracker. Use for triage only.
tools: Read, Grep, mcp__tracker__search_issues, mcp__tracker__get_issue, mcp__tracker__add_label
model: haiku
---
You triage new issues. Read each issue, pick one label, and report a one-line summary per issue.
重いサーバーをメインの会話から完全に外したいときは、サブエージェントの中でその場で定義します。ドキュメントによると、その場で定義したサーバーはサブエージェントの開始時に接続され、終了時に切断されます。また、.mcp.json ではなくサブエージェントに定義すれば、そのツールの説明がメインの会話のコンテキストを使わず、ツールはサブエージェントだけが持ちます。
---
name: browser-checker
description: Verify UI changes in a real browser. Use after frontend edits.
tools: Read, mcp__playwright__*
mcpServers:
- playwright:
type: stdio
command: npx
args: ["-y", "@playwright/mcp@latest"]
model: sonnet
---
Open the page, check the change described in the task, and report pass or fail with one sentence of evidence.
- github のような文字列での指定は、設定済みのサーバーを参照して親と接続を共有するだけなので、親からそのサーバーは消えません。サブエージェントからMCPツールをすべて外すには disallowedTools: mcp__* を使います。
効果を測るには、費用のドキュメントにある /usage を使います。最近の使用量をスキル・サブエージェント・プラグイン・MCPサーバーごとに分けて表示できます。/context では今のコンテキストを何が使っているかを確認できます。
Claude Agent SDK:AgentDefinition
同じ項目はコードでも指定できます。tools を省略すると、サブエージェントが使えるツールをすべて引き継ぎます。以下は例です(オプション名はお使いのSDKのバージョンのリファレンスで確認してください)。
import { query } from "@anthropic-ai/claude-agent-sdk";
for await (const message of query({
prompt: "Triage the open issues labeled bug",
options: {
maxBudgetUsd: 2, // stops a runaway tree of agents
agents: {
"issue-triager": {
description: "Read and label tracker issues. Use for triage only.",
prompt: "You triage new issues. Pick one label per issue.",
tools: ["mcp__tracker__search_issues", "mcp__tracker__get_issue", "mcp__tracker__add_label"],
model: "haiku",
},
},
},
})) {
if (message.type === "result") console.log(message.total_cost_usd);
}
各サブエージェントのリクエストは、クエリ全体の total_cost_usd に含まれます。絞る前と後で、1回あたりのこの値を記録して比べてください。
Messages APIで自作したオーケストレーター
オーケストレーターとワーカーの処理を自分で書いている場合は、固定部分を直接管理できます。5章の結果から、2つの変更が効きます。最後のツールにキャッシュの区切りを置いて、同じツールを持つワーカーで共有すること。そして、1つ目のワーカーのレスポンスが始まってから残りを起動することです。
import asyncio
import anthropic
client = anthropic.AsyncAnthropic()
MODEL = "claude-sonnet-5-5" # use the model ID from the models overview page
def worker_request(tools, task):
tools = [dict(t) for t in tools]
tools[-1]["cache_control"] = {"type": "ephemeral"} # shared breakpoint after tools
return dict(
model=MODEL,
max_tokens=2048,
tools=tools,
system=[{"type": "text", "text": f"You are a worker. Task: {task}",
"cache_control": {"type": "ephemeral"}}],
messages=[{"role": "user", "content": task}],
)
async def run_workers(tools, tasks):
# 1) First worker writes the tool-prefix cache.
first = await client.messages.create(**worker_request(tools, tasks[0]))
# 2) The rest start after that response, so they read the cached tools.
rest = await asyncio.gather(*[
client.messages.create(**worker_request(tools, t)) for t in tasks[1:]
])
for r in [first, *rest]:
u = r.usage
print(u.cache_creation_input_tokens, u.cache_read_input_tokens, u.input_tokens)
return [first, *rest]
この例は1つ目のレスポンスが終わるまで待つので、ストリームの開始だけを待つより単純ですが、少し遅くなります。ワーカーごとに必要なツールが違う場合は、それぞれに必要な分だけを渡してください。5章のとおり、小さくて共有しない固定部分のほうが、大きくて共有する固定部分より安くなることが多いです。OpenAI Agents SDK・Google ADK・Pydantic AI・Vercel AI SDK・LangChainでエージェントごとに絞るコードはフレームワーク別のツール絞り込みの記事に、ツール一覧をリクエスト間で完全に同じに保つべき理由はプロンプトキャッシュの記事にまとめています。
8. チェックリスト
- [ ] 自作のサブエージェントすべてに、既定の引き継ぎではなく
tools(またはdisallowedTools)を明示している - [ ] MCPのワイルドカードは、サーバー名だけでなく
__*で終わっている(mcp__server__*) - [ ] 1つのサブエージェントしか使わないサーバーは、
.mcp.jsonではなくmcpServersにその場で定義している - [ ] 簡単なワーカーは小さい
model(例:haiku)を使っている - [ ] サブエージェントの階層と費用に上限がある(
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH、maxBudgetUsd) - [ ] 自作のオーケストレーターでは、同じツールを持つワーカーがツールの後ろの区切りを共有し、最初のリクエストを先に送っている
- [ ] ワーカーごとの
cache_creation_input_tokensを確認した(1回の実行で大きな書き込みが複数あれば、同時起動のミス) - [ ] 短い作業はメインの会話で行い、長い作業だけを任せている(6章の目安)
- [ ] 絞る前と後で、1回あたりの費用を比べた(
/usage、total_cost_usd、APIのusage)
9. よくあるハマりどころ
| 症状 | 原因 | 対処 |
|---|---|---|
| サブエージェントに作業を移したら費用が増えた | 各サブエージェントがMCPのツール一覧をすべて引き継ぎ、それぞれキャッシュを書き込んでいる | サブエージェントごとに tools を絞り、長い作業だけを任せる |
どのワーカーも cache_creation_input_tokens が大きい |
同時に起動しており、キャッシュは最初のレスポンスが始まるまで使えない | 1つを先に起動するか、事前にキャッシュを温める |
| 同じツールを持つワーカーでキャッシュを共有できない | 区切りが、内容の違うシステムプロンプトの後ろに1つだけ | 最後のツール定義にも区切りを置く |
tools: mcp__reports__v2 でツールが1つも使えない |
末尾の __* がない |
mcp__reports__v2__* かツールの正式名を書く |
mcpServers のその場定義が効かない |
プラグインのサブエージェントで、mcpServers に対応していない |
プロジェクトかユーザーのエージェントフォルダに定義する |
| サブエージェントからサーバーを外しても、親が軽くならない | .mcp.json にも設定がある、または名前で参照して接続を共有している |
サブエージェントのその場定義だけに移す |
| 1つのプロンプトで請求が大きくなった | サブエージェントの入れ子(既定で3階層、同時に最大20) | 階層の上限を下げ、ワーカーの tools から Agent を外し、maxBudgetUsd を設定する |
| エージェントチームが通常のセッションの何倍もかかる | チームメイトはそれぞれ別インスタンスで、MCPサーバーを自動で読み込む | 費用のドキュメントのとおり、チームを小さくし、起動時の指示を絞る |
10. NodeFlareならこう解決できる
NodeFlareはMCP専用のホスティングです。GitHubリポジトリのMCPサーバーを、認証つきのHTTPSエンドポイントとして動かします。プロキシにはサーバーごとの設定があり、各エージェントのモデルが読む内容を変えられます。設定はプロキシ側で適用されるので、サーバーのコードを変える必要はありません。この記事で挙げた課題ごとに対応を整理します。
課題1:どのサブエージェントもツール一覧をすべて引き継ぐ(3章・5章)。 tool_list_filter_by_scope を有効にし、サブエージェントごとに別のNodeFlare APIキーを発行して、tools:call:<name> のようなスコープを付けます。すると tools/list はそのキーで呼べるツールだけを返し、スキーマはそのままです。分類だけを行うワーカーは、書き込み系のツールを読み込みません。ツール一覧のキャッシュは呼び出し元ごとに分かれているので、絞った一覧がエージェント間で混ざることもありません。5章の構成Cを、各クライアントではなくサーバー側で強制する形です。
課題2:ツール一覧そのものが大きく、増え続ける。 tool_search_mode を有効にします。NodeFlareは tools/list の一覧を、search_tools(query) と call_tool(name, args) の2つのメタツールに置き換えます。サーバーのツールがいくつあっても、各サブエージェントが最初に読み込む定義の量はほぼ一定です。検索は既定では文字列の一致で、GEMINI_API_KEY を設定すると意味検索になり、失敗したときは文字列の一致に戻ります。
課題3:ワーカーがツールを何度も続けて呼び、途中の結果を受け渡す。 Code Execution(tool_code_mode)を有効にします。サーバーは run_code と search_tools を公開し、ワーカーは tools.NAME(args) を呼ぶJavaScriptを書きます。NodeFlareはそれをサンドボックスで実行します。複数のツール呼び出しが1回のコード実行にまとまり、ワーカーのコンテキストに入るのはスクリプトの戻り値だけです。実行は分離されたDenoのサブプロセスで行われ、ファイルシステム・環境変数・プロセスの起動は使えず、ネットワークはプロキシのコールバック先だけに制限されます。既定ではタイムアウト600秒、1回の実行でツール呼び出し最大50回、V8のヒープ128MBで、ツール呼び出しはサーバー側で1回ずつスコープを確認します。
課題4:他人が作ったサーバーのツール説明が長い。 tool_schema_slim は500文字を超えるツールの説明を切り詰めます(UTF-8で安全に処理)。ツール名と入力スキーマは変えません。
NodeFlareは、これらの設定によるトークン削減率を公表していません。5章の前提だけを使った計算例として、Sonnet 5.5のサブエージェント5つのツール一覧を2万トークンから3千トークンに絞ると、固定部分の費用は1,000回あたり348.58ドルから76.58ドルになります。検索やコード実行の呼び出し自体にもトークンがかかるので、お使いのサーバーで前後を計測してください。
最小の始め方:
- NodeFlareのダッシュボードでMCPサーバーのGitHubリポジトリを指定します。ランタイム、トランスポート、起動コマンドは自動で検出・入力されます。
- デプロイしたら、
tool_list_filter_by_scope(サブエージェントごとにスコープ付きのキーを1つ)と、tool_code_modeまたはtool_search_modeを有効にします。 - 各サブエージェントのMCP設定で、接続先を
https://<your-server>.nodeflare.tech/mcp、ヘッダーをAuthorization: Bearer <そのエージェントのAPIキー>にします。
1サーバーまで無料で試せます(Freeプラン:サーバー1つ、計算資源は月30GB時間まで)。→ nodeflare.techで始める
11. FAQ
サブエージェントは1つのエージェントよりトークンを多く使う?
多くの場合、使います。サブエージェントはそれぞれ自分のコンテキストを持ち、自分でリクエストを送ります。Anthropicは、マルチエージェントは通常のチャットの約15倍のトークンを使うと報告しています。節約になるのはメインの会話のほうで、長いツール結果をそこから外せるからです。
Claude CodeのサブエージェントはMCPツールを引き継ぐ?
既定では引き継ぎます。tools を省略すると、MCPツールを含め、サブエージェントが使えるツールをすべて持ちます。tools か disallowedTools で絞ってください。
Claude Codeのサブエージェントに1つのMCPサーバーだけを使わせるには?
tools: mcp__<server>__* と書きます(末尾の __* が必要です)。mcp__tracker__get_issue のようにツールを1つずつ書くこともできます。親の会話からもそのサーバーを外したいなら、.mcp.json ではなくサブエージェントの mcpServers にその場で定義します。
mcpServersにその場で定義すると、メインの会話のトークンは減る?
Claude Codeのドキュメントによると、減ります。サブエージェントにその場で定義したサーバーのツールは、サブエージェントだけが持ち、親の会話には入りません。設定済みのサーバーを名前で参照した場合は、親と接続を共有するだけなので、親からは消えません。
並列に起動したサブエージェントが全部キャッシュ書き込みの料金になるのはなぜ?
キャッシュは、最初のレスポンスが始まってから使えるようになるからです。すべてのサブエージェントが同時に最初のリクエストを送ると、どれも他のキャッシュを読めません。1つを先に起動し、そのあとで残りを起動してください。
システムプロンプトが違うサブエージェントどうしで、MCPツールのキャッシュを共有できる?
同じツール一覧を使い、最後のツール定義にキャッシュの区切りを置けば共有できます。キャッシュはツール、システム、メッセージの順に作られるので、システムプロンプトが違ってもツール部分は一致します。
サブエージェントに任せるほうが安くなるのはどんなとき?
メインのコンテキストから外せるツール結果が大きく、メインの会話がその後も長く続くときです。Sonnet 5.5での目安は R × m ≥ P × (25 + k − 1) です。Pはサブエージェントの固定部分、kはそのリクエスト数、mはその後のメインのリクエスト数です。
Claude Codeのエージェントチームはトークンを何倍使う?
Claude Codeの費用のドキュメントによると、チームメイトがプランモードで動く場合、通常のセッションの約7倍です。各チームメイトが自分のコンテキストを持つためで、トークン使用量はチームの人数にほぼ比例します。
MCPを使うサブエージェントにはどのモデルを使うべき?
範囲の狭い簡単なワーカーには、小さいモデルを使いましょう。Claude Codeの費用のドキュメントは、簡単なサブエージェントには model: haiku を勧めています。この記事の試算では、絞ったワーカーはHaiku 5.5で1,000回あたり4.67ドル、Sonnet 5.5では76.58ドルでした。
サブエージェントごとの費用はどう確認する?
Claude Codeでは /usage で、最近の使用量をサブエージェントやMCPサーバーごとに確認できます。Agent SDKでは、各サブエージェントのリクエストが total_cost_usd に含まれます。Messages APIでは、ワーカーのリクエストごとに cache_creation_input_tokens、cache_read_input_tokens、input_tokens を記録します。
ここでいう「MCP Token」はMCPのアクセストークンのこと?
違います。この記事はLLMのトークン(コンテキストと課金)の話です。MCPサーバーのアクセストークンやAPIキーはセキュリティの話題で、エージェントごとのキーについてはMCPのAPIキー管理の記事をご覧ください。
まとめ
サブエージェントはツール結果をメインの会話から外してくれますが、固定部分は増やします。各サブエージェントが自分用のMCPツール定義を読み込み、同時に起動するとそれぞれがキャッシュ書き込みの料金を払うことがあるからです。この記事のSonnet 5.5の試算では、2万トークンのツール一覧を引き継いだ5つのサブエージェントを同時に起動すると、同じ40リクエストを1つのエージェントで行う場合の2.5倍の固定費がかかりました。サブエージェントごとにMCPツールを絞る、ツール部分のキャッシュを共有して起動をずらす、簡単なワーカーには小さいモデルを使う、といった対策で、1,000回あたり348.58ドルが4.67〜156.58ドルまで下がりました。長い作業だけを任せ、短い作業はメインの会話で行い、変更のたびにサブエージェントごとの費用を前後で測りましょう。
