モデルコンテキストプロトコルの実践
API を知っているエンジニアのための、エージェント向けのツールとデータの書である。HTTP API に対して MCP が何を加えるのか、どのような場合に MCP が不適切な選択となるのかを示す。そのうえで、仕様リビジョン 2026-07-28 と Python SDK の mcp 2.x を用いて、MCP サーバーとクライアントを設計、構築、保護、テスト、運用する方法を述べる。2025 年のリビジョンからの移行手順も扱う。
対象読者 HTTP API を構築または利用していて、エージェントにツールとデータを与える必要が生じたエンジニア、あるいはエージェントを他者のものに接続する必要が生じたエンジニアを対象とする。機械学習の知識は必要ない。
Kindleまたは任意の電子書籍リーダーで読む
EPUB は Apple Books、Kobo、そのほとんどの電子書籍リーダーでも利用できる。
Kindleに送る
この版のEPUBを送信します。 日本語.
-
当社のアドレスを承認する
Amazonは、承認済みのアドレスからのものに限ってKindleへ配信する。配信するサービスごとに一度ずつ承認が必要である。当社のアドレスを、承認済みのパーソナルドキュメント用メールアドレスの一覧に追加する。
books@rollingedition.comAmazonのパーソナルドキュメント設定を開く. Amazonでは、「コンテンツと端末の管理」、「環境設定」、「パーソナルドキュメント設定」の順に進む。
送信しました。数分後に Kindle のライブラリに表示されます。
届かない場合、ほとんどは手順1の承認が原因である。books@rollingedition.comが承認済みのパーソナルドキュメント用メールアドレスの一覧に入っているかを確認する。
保存した書籍の新しい版も、同じくKindleに届く。
Kindle のアドレスではない。アドレスは @kindle.com で終わる。Amazon の「パーソナル ドキュメント設定」で確認できる。
本日すでに {count} 冊を送信しており、これは1アカウントが1日に送信できる上限である。明日再度試すこと。
本日送信できる冊数の上限に達した。明日再度試すこと。
書籍を送信できなかった。数分後に再度試すこと。
この版は大きすぎて電子メールで送信できない。
Kindleへの送信はLabsに含まれる。
Kindle のアドレスではない。アドレスは @kindle.com で終わる。Amazon の「パーソナル ドキュメント設定」で確認できる。
書籍を送信できなかった。数分後に再度試すこと。
または、EPUBをダウンロードし、AmazonのSend to Kindleページにドロップする。
Kindle is a trademark of Amazon.com, Inc.
目次
12 章、読了までおよそ14 時間 45 分、70 例を収録。
-
1MCPをエンドツーエンドで理解する
この章を終えるまでに、既存のHTTP APIをstdio経由のModel Context Protocolサーバの背後に置き、クライアントからそのツールを呼び出し、両者がやり取りするすべてのメッセージを読み、小さなホストを通じてモデルにツールを選ばせることができるようになる。
-
2MCP が API に加えるもの
この章を読み終えると、ホスト、クライアント、サーバーがそれぞれ何を担うかを説明できるようになる。
-
3モデルが使えるツールを設計する
この章を終えると、ショップの API を、モデルが名前、説明、入力スキーマ、結果、エラーを手がかりに行動できる Model Context Protocol のツールへ変換できるようになる。
-
4データをリソースとプロンプトとして提供する
この章を終えると、店のポリシーとレコードを Model Context Protocol のリソースとして公開し、1つのリソーステンプレートで多数のレコードを指定し、ユーザーが入力している間に引数を補完し、リソースが変更されたときにクライアントへ通知し、返金審査をユーザーが選べるプロンプトとしてまとめられるようになる。
-
5呼び出しの途中でユーザーに尋ねる
この章を読み終えると、ショップの返金ツールを呼び出しの途中で止め、ホストにいる人に返金の確認を求め、その答えを受けて処理を続けられるようになる。
-
6Streamable HTTP で提供する
本章を読み終えると、次のことができるようになる。
-
7長時間の処理をタスクとして実行する
この章を終えると、Model Context Protocol の拡張をネゴシエートし、時間のかかる補充レポートをクライアントがポーリングするタスクとして実行し、タスクを期限切れにしたりキャンセルしたりし、MCP Apps がツールに何を加えるかを説明できるようになる。
-
8OAuthでクライアントを認可する
この章を終えると、ショップの Model Context Protocol サーバーを OAuth で保護できるようになる。
-
9ツールを悪用から守る
この章を終えると、Model Context Protocol サーバーとそのホストの周囲に信頼境界を引き、トークンのパススルーを拒否し、サーバーが confused deputy(混乱した代理人)として動くことを防ぎ、ツール定義を固定して変更を検知し、チケットの文面をデータとして扱い、副作用のあるツール呼び出しの前に必ずユーザーへ確認できるようになる。
-
10チケットを処理するホストを構築する
この章を終えると、ホストを複数の Model Context Protocol サーバーに接続し、それらのツールに衝突しない名前を与え、モデルがツールを呼び出してその結果を読む短いループを実行し、サーバーからの入力要求をユーザーに代わって処理し、リソースをモデルのコンテキストに取り込み、これらすべてを用いてチケットのキューを処理できるようになる。
-
11サーバーをテストし、動作を観察する
この章を終えると、次のことができるようになる。
-
122025年版サーバの移行
この章を読み終えると、2025年のリビジョンと Python SDK の 1.x 系向けに書かれた Model Context Protocol サーバを、リビジョン 2026-07-28 の仕様と
mcp2.3.0 に移せるようになる。