Claude APIと​MCPで​押さえる​仕様:Claude認定試験の​全冠(No.09)

本文

エレノア代表の​豊島と​申します。

毎回同じ長い指示を​送る​アプリケーションで、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社と​提携している​事業者ではございません。

ブログの​記事一覧