1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

MCPツールは呼ばなくても毎ターン課金される:スキーマのトークンを実測

1
Posted at

6月15日にMDNがMCPサーバーを公開した。https://mcp.mdn.mozilla.net/ を繋ぐだけで、VS CodeやClaude Codeから最新のブラウザ互換情報をエージェントが直接引ける。Stack Overflowもエージェント向けのベータを出したし、この手の「繋ぐだけ」MCPサーバーはこれから雪崩のように増える。

便利だ。ただ繋ぐ前に、一個だけ実測しておきたいことがあった。接続したMCPツールは、一度も呼ばなくても、毎回のリクエストの入力トークンに乗る。ツールを増やすほど、自分のコンテキスト予算が黙って削られていく。

ツール定義は「説明文」じゃなくて入力トークン

MCPクライアントは tools/list でツール一覧を受け取り、それを丸ごとモデルAPIの tools フィールドに積む。中身はツール名、description、JSON Schema。これがプロンプトの先頭付近に展開されて、モデルが「どのツールをいつ呼ぶか」を判断する材料になる。

つまりツール定義は人間向けの注釈じゃなくて、まるごと課金対象の入力トークンなんだよね。cl100k_base で、よくあるファイル系とfetch系の6ツールを数えてみた。

ツール 合計tok description inputSchema
read_text_file 180 86 77
edit_file 179 35 128
fetch 170 60 95
search_files 131 59 56
list_directory 94 53 25
write_file 92 39 37

6個で846トークン、平均141トークン/ツール。edit_file みたいにネストの深いスキーマを持つやつは、descriptionよりinputSchema側が重い。

効くのは1個の単価じゃなくて掛け算のほう

問題は1個141トークンという数字じゃない。ツール数 × ターン数で積み上がるところ。

接続ツール数 毎リクエストに固定で乗る
5 約 705 tok
10 約 1,410 tok
20 約 2,820 tok
50 約 7,050 tok

これが毎リクエストの先頭に固定で乗る。エージェントは1タスクで何往復もするから、

10ツール × 20ターン ≈ 28,200 tok
20ツール × 20ターン ≈ 56,400 tok

を「ツール定義の再送」だけで使う。ユーザーの質問も、読ませたいコードも、一文字も含めずに、だ。

ここで「プロンプトキャッシュがあるじゃん」と思う。半分正しい。静的なプレフィックス(system + tools)はキャッシュが効いて、再送ぶんの料金は大きく下がる。ただし落とし穴が二つある。

一つ、キャッシュは料金を薄めるだけで、コンテキスト窓は普通に食う。7,000トークンのツールカタログは、窓が200kあろうと、使える長さをその分そのまま削る。長い対話や大きめのコードを載せたい時に効いてくる。

二つ、ツールを動的に出し入れするとプレフィックスが変わって、キャッシュが丸ごと無効化する。「ターンごとに必要なツールだけ差し替える」という素朴な最適化は、キャッシュミスを連発して逆に高くつくことがある。これは実装してから気づくと痛いやつ。

削りどころは二つだけ

じゃあどうするか。手元で試した範囲で効いたのは二つ。

descriptionの要点化。各ツールのdescriptionを最初の1文だけに削ったら、6ツールで846→591トークン、ざっと30%減った。Only works within allowed directories みたいな定型句が全ツールにぶら下がっていると、そこそこ積もっている。ただしdescriptionはモデルがツールを選ぶ精度に直結するので、削りすぎると誤呼び出しが増える。安全な定型句から落とすのがコツ。

遅延ロード。全ツールを最初から渡さず、「ツール検索」役を1個だけ常設して、必要になった時にそのツールのスキーマを読み込ませる。最近のエージェント実行環境はこの方向に寄ってきていて、20個30個抱えても毎ターン乗るのはコアの数個だけ、という設計になりつつある。GitLabがProject Switchで「エージェントのトークンを半分に」と言っているのも、結局この「無駄な往復とデータを先に削る」話と地続きだと思う。

実測コードは短い。自分のサーバーの tools/list 出力をJSONで食わせれば、今のカタログのコストがそのまま出る。

import json, sys
import tiktoken  # pip install tiktoken

enc = tiktoken.get_encoding("cl100k_base")

def ntok(obj) -> int:
    return len(enc.encode(json.dumps(obj, ensure_ascii=False)))

tools = json.load(open(sys.argv[1], encoding="utf-8"))  # tools/list の配列

total = 0
for t in tools:
    tok = ntok(t)
    total += tok
    print(f"{t['name']:18s} {tok:4d} tok")

avg = total / len(tools)
print(f"\n{len(tools)}ツール = {total} tok / 平均 {avg:.0f} tok/ツール")
for n in (10, 20, 50):
    print(f"  {n}ツール換算: 約 {round(avg*n):,} tok が毎リクエストに固定で乗る")

実行するとこうなる。

read_text_file      180 tok
edit_file           179 tok
...
6ツール = 846 tok / 平均 141 tok/ツール
  10ツール換算: 約 1,410 tok が毎リクエストに固定で乗る
  50ツール換算: 約 7,050 tok が毎リクエストに固定で乗る

トークナイザはモデルで違う(ここは cl100k_base)。絶対値はモデルで前後するけど、ツール数に比例して固定費が増える構造自体は変わらない。

おわりに

MCPは「繋ぐだけ」で強い。でも繋ぐコストはゼロじゃなくて、ツール1個あたり百数十トークンが毎ターン乗る固定費だった。50個繋げば約7,000トークン、20ターン回せば数万トークンが、一度も呼ばないまま消えていく。料金はキャッシュで薄められるが、コンテキスト窓を食う分と、動的差し替えがキャッシュを壊す罠は残る。

だから「とりあえず使えそうなMCPサーバーを全部繋ぐ」は、便利に見えて予算を静かに削る。コアのツールだけ常設して、残りは検索経由で遅延ロード、descriptionは安全な定型句から引き締める。手元ではこれだけで固定費がはっきり下がった。MCPサーバーが増える今だからこそ、足す前に増えるトークンを一回数える癖をつけておくと、後でコンテキストが足りなくて詰む場面が減ると思う。

Sources

1
1
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
1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?