本文
エレノア代表の豊島と申します。
毎回同じ長い指示を送るアプリケーションで、APIの費用を抑える方法をご存じでしょうか?
本記事は、Claude Codeの設定と権限の基本(No.08)に続く連載の記事で、連載の最後の記事です。今回は、試験の準備で身に付く知識として、Claude APIとMCPの主な仕様をご紹介いたします。内容は、2026年10月27日時点の公式文書に基づいております。
本記事の内容
- プロンプトのキャッシュとバッチ処理による費用の削減
- ツールの使用と構造化された出力
- MCPのサーバーの仕組みとスコープ
プロンプトのキャッシュとバッチ処理による費用の削減
APIの費用を抑える主な方法は、プロンプトのキャッシュと、Message Batches APIの2つです。
プロンプトのキャッシュ
プロンプトのキャッシュは、要求の先頭の部分を保存し、次の要求で同じ部分を再利用する機能です。キャッシュは、ツールの定義、システムの指示、メッセージの順に並んだ要求の先頭から作られます。そのため、変わらない部分を先頭に置きます。
キャッシュの有効期間は、既定で5分です。使うたびに追加の料金なしで延長され、1時間の設定も選べます。料金は、5分のキャッシュの書き込みが基本の料金の1.25倍、読み込みは1割以下です。読み込みの倍率は、モデルによって異なります。
キャッシュできる最小のトークン数も、モデルによって512から4,096まで異なります。最小に満たない場合は、エラーにはならず、キャッシュされずに処理されます。
Message Batches API
Message Batches APIは、すぐに結果が必要ない大量の要求を、まとめて非同期で処理する機能です。料金は、通常の50%です。
多くの処理は1時間以内に終わり、24時間以内に終わらない要求は期限切れになります。結果の順番は送った順と一致するとは限らないため、要求ごとに付けたcustom_idで照合します。
ツールの使用と構造化された出力
Claudeがツールを使いたい場合、応答の停止の理由(stop_reason)がtool_useになります。アプリケーションは、指定されたツールを実行し、結果をtool_resultとして返します。停止の理由がend_turnになるまで、この処理を繰り返します。
決まった形式のJSONで出力を受け取るには、構造化された出力の機能を使います。出力の形式は、output_config.formatでJSONのスキーマを指定します。ツールの入力の形式は、ツールの定義にstrict: trueを付けて保証します。
MCPのサーバーの仕組みとスコープ
MCP(Model Context Protocol)は、AIのアプリケーションと外部のシステムをつなぐための公開の規格です。MCPのサーバーは、次の3つを提供します。
- ツール:モデルが呼び出す、操作や取得の機能
- リソース:アプリケーションが読み込む、ファイルの内容などのデータ
- プロンプト:利用者が選んで使う、定型の指示
通信の方式は、サーバーを手元で起動して標準の入出力でやり取りする方式と、HTTPで接続する方式(Streamable HTTP)の2つです。
Claude Codeでは、claude mcp addのコマンドでサーバーを追加します。追加の範囲(スコープ)は3つです。
local(既定):今のプロジェクトで、自分だけが使うproject:プロジェクトの直下の.mcp.jsonに保存し、チームで共有するuser:自分のすべてのプロジェクトで使う
よくある質問
MCPのサーバーをチームで共有するとき、鍵はどう扱いますか?
.mcp.jsonには鍵の値を書かず、${VAR}の形で環境変数を参照します。鍵が必要な個人用のサーバーは、リポジトリに含まれないlocalのスコープに置きます。
外部のWebページやメールをClaudeに読ませるときの注意はございますか?
外部の内容に、AIへの指示が隠して書き込まれている場合がございます。公式文書は、外部の内容を信頼しない入力として扱い、指示とは分けて渡すよう求めています。送金や削除など影響の大きい操作には、人の確認を挟みます。
まとめ
- APIの費用は、変わらない部分を先頭に置くプロンプトのキャッシュと、料金が50%のMessage Batches APIで抑えられる
- ツールの使用は、停止の理由が
tool_useの間、ツールを実行して結果を返す処理を繰り返す - MCPのサーバーは、ツール、リソース、プロンプトの3つを提供し、Claude Codeでは3つのスコープで追加できる
連載「Claude認定試験の全冠」は、本記事で一区切りとなります。全9回をお読みいただき、ありがとうございました。
最後に、全冠を終えた代表の感想をお伝えいたします。Architect – Foundationsは難しく感じましたが、4種の全体としては、難易度は高くないと感じております。代表の勉強の時間は4種の合計で10〜20時間で、一定の準備をすれば「Claude認定試験の全冠」を達成できると考えております。社内での存在感を手軽に高められる資格ですので、受験の条件を満たす方は、ぜひ挑戦してみてください。受験の条件は、Pearson VUEのテストセンターでの受験の手順(No.03)でご紹介しております。
代表のClaude認定の有効期限は、2027年10月23日から25日です。エレノアが設計・運営しているサービスは、実績のページでご紹介しております。Webサイトやアプリの制作のご相談は、お問い合わせからお気軽にご連絡ください。
Claude、Claude Codeは、Anthropic, PBCの商標です。エレノアは、Anthropic社と提携している事業者ではございません。