はじめに — 便利すぎて見落としていたコスト

前回の記事で、freee-mcpを使って確定申告の経費登録を8時間→30分に短縮した話を書きました。

便利。最高。もう手入力には戻れない。

…と思っていたのですが、ふとトークン消費量を確認して目が覚めました。

270個のAPIツール定義が、毎ターン注入される

freee-mcpをClaude Codeに接続すると、270個のAPIツール定義がコンテキストに載ります。毎ターンです。

会計API（31エンドポイント）、人事労務API（27エンドポイント）、請求書API、工数管理API、販売API — 経費登録に必要なのはほんの一部なのに、全API分のスキーマがall-or-nothingで注入されます。

2026年3月時点で、API絞り込み設定は未対応です。

勘定科目一覧、1回のレスポンスで108,734文字

さらに衝撃だったのがレスポンスサイズです。

GET /api/1/account_items（勘定科目一覧）: 108,734文字

10万文字超え。 1回のAPI呼び出しで、文庫本1冊分のテキストがコンテキストに流れ込みます。

取引一覧も全2,902件。limit を指定しないと全件返ってきます。

経費1件あたりのトークンコスト

実測してみました。

方式	入力トークン（推定）	出力トークン（推定）	備考
MCP経由 1件	~15,000〜20,000	~300	270 APIツール定義がinputに毎回載る
CLI Skill 1件	~2,000〜3,000	~50	curlコマンド+jqフィルタのみ
CLI Skill 12件一括	~3,000〜4,000	~500	forループで1回のBash呼び出し

MCP経由だと、経費1件登録するだけで約17,500トークンを消費します。そのうち大半はAPIツール定義のオーバーヘッドです。

freee月額 vs トークン代

Claude Sonnet 4の入力トークン単価は $3/MTk（100万トークンあたり$3）です。

シナリオ	トークン数	コスト	備考
MCP経由で10件/月	175,000	$0.53（約79円）	個人事業主の現実的な件数
MCP経由で年間	2,100,000	$6.3（約945円）	12ヶ月分
freeeスターター	—	月額1,480円	年間17,760円

MCP経由のトークン代だけで、年間約945円。freeeの月額1ヶ月分に迫ります。

かなり安いですが、複雑な気持ちになりました。経費登録を自動化して時間を節約したのに、トークン代という新しい経費が生まれている。しかもこれ、経費登録するたびに増えていく経費です。経費を登録するために経費が発生する — なんとも皮肉な話ですが、確定申告で計上できるのがせめてもの救いです。

解決策: CLI Skill化でトークン90%以上削減

MCP経由の問題は明確です：

270 APIツール定義のオーバーヘッド — 毎ターン注入、絞り込み不可
レスポンスの冗長性 — 全フィールドが返却される

解決策として、必要なAPIだけをCLI Skill化しました。

Before: MCP経由

Claude → Skill呼び出し（APIリファレンス注入） → MCP Tool → freee API
         ↑ 270 API分のスキーマが毎回注入

After: CLI Skill

Claude → Bash(curl + jq) → freee API
         ↑ 必要なエンドポイントだけ、レスポンスもjqでフィルタ

実測比較

API	MCP経由	CLI Skill（jqフィルタ）	削減率
取引一覧（3件）	~3,000文字	~200文字	93%減
勘定科目一覧	108,734文字	~200文字	99.8%減
取引登録レスポンス	~800文字/件	~80文字/件	90%減

勘定科目一覧は500分の1になりました。 CLI Skillでは必要なフィールド（ID・名前・カテゴリ）だけをjqで抽出するので、10万文字が200文字になります。

コスト比較

方式	経費10件/月	年間コスト
MCP経由	$0.53（79円）	945円
CLI Skill	$0.08（12円）	138円
CLI 一括	$0.01（2円）	19円

CLI一括登録なら、年間のトークン代は19円。MCP経由の約50分の1です。

OAuthトークンの再利用

CLI Skill化で気になるのが認証ですが、freee-mcpのOAuthトークンをそのまま再利用できます。

# freee-mcpのトークンファイル
~/.config/freee-mcp/tokens.json

ここに保存されたアクセストークンをcurlで使えば、追加の認証フローは不要です。

実際に作ったCLI Skill

Claude Codeの .claude/skills/ に以下のSkillを作りました。freee APIをcurlで直接呼び出すシンプルなSkillです。

# 共通変数
ACCESS_TOKEN=$(jq -r .access_token ~/.config/freee-mcp/tokens.json)
COMPANY_ID=$(jq -r .currentCompanyId ~/.config/freee-mcp/config.json)

# GETの例（取引一覧を3件取得）
curl -s -H "Authorization: Bearer $ACCESS_TOKEN" \
  "https://api.freee.co.jp/api/1/deals?company_id=$COMPANY_ID&limit=3" \
  | jq '.deals[] | {id, issue_date, amount, status}'

# POSTの例（経費登録）
curl -s -X POST -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "company_id": "'$COMPANY_ID'",
    "issue_date": "2025-07-15",
    "type": "expense",
    "details": [{
      "account_item_id": YOUR_ACCOUNT_ITEM_ID,
      "tax_code": 136,
      "item_id": YOUR_ITEM_ID,
      "amount": 8432,
      "description": "電気代7月分"
    }],
    "payments": [{
      "date": "2025-07-15",
      "from_walletable_type": "wallet",
      "from_walletable_id": YOUR_WALLET_ID,
      "amount": 8432
    }]
  }' "https://api.freee.co.jp/api/1/deals" \
  | jq '{id: .deal.id, date: .deal.issue_date, amount: .deal.amount}'

ポイントは jqで必要なフィールドだけ返すこと。freee APIのレスポンスは全フィールド返却されるため、そのままだと勘定科目一覧で10万文字超えます。jqフィルタで {id, name, category} だけ抽出すれば200文字に収まります。

まとめ

freee-mcpは間違いなく便利です。確定申告の経費登録が8時間→30分になった体験は本物です。

ただし、MCP経由のトークン消費には注意が必要です：

270個のAPIツール定義が毎ターン注入される
勘定科目一覧は1回で10万文字超え
経費登録を月30件続けると年間2,835円のトークン代

確定申告のように使うAPIが限定的な場合は、CLI Skill化でトークン消費を90%以上削減できます。

そして次の記事では、freee-mcpを使っていて気づいたさらに致命的な問題について書きます。MCPには、そもそもファイルが送れないのです。

→ 次回：「個人事業主がfreee-mcpで確定申告しようとしたら、MCPには領収書すら送れなかった話」

📘 CLAUDE.mdのセキュリティ設計やClaude Codeの実践ノウハウは、『実践Claude Code（Kindle版）』で体系的にまとめています。

📘 MCPのセキュリティ・トークンコスト・ワークアラウンドについては、『MCP実践セキュリティ（Kindle版）』で体系的にまとめています。