本文へスキップ
エージェントシステムと標準に戻る

エージェントシステムと標準 · 第1章(全8章)

MCP:サーバーが提供するツール

エージェントがMCPサーバーのツールを見つけて呼び出す方法と、2026-07-28プロトコルが危険な呼び出しの前に人に確認する方法。

25分4個中0個の目標を達成

目標

  • 返金が実行されるまでシナリオを実行します。未完了
  • ヘルプデスクの確認に自分で答えます。未完了
  • メッセージを改ざんし、本物のSDKがそれを拒否するのを確かめます。未完了
  • 確認問題に合格します。未完了

ステップ1/4: 本文

ホスト、クライアント、サーバー

Model Context Protocol(MCP)は、AIアプリケーションをツールやデータにつなぐためのオープンな標準です。ホストと呼ばれるアプリケーションは、使うサーバーごとに1つのMCPクライアントを動かします。サーバーが提供するのは、ツール(モデルが呼び出せる操作)、リソース(アプリケーションが読めるデータ)、プロンプト(人が選べるテンプレート)です。メッセージはJSON-RPC 2.0で、HTTP経由か、ローカルプロセスの標準入出力(stdio)経由で送られます。

前の学習パスのエージェントでは、ツールはコード内の関数でした。MCPでは、ツールは別の誰かが書いて動かせるサーバーにあり、どのMCPホストからも使えます。

2026-07-28で変わったこと

この章では、公式TypeScript SDK v2とプロトコルバージョン2026-07-28を使います。ワイヤー上で3つの変更が見えます。

検出:クライアントはserver/discoverを呼び出して、サーバーのバージョンと機能を知ります。2025年のバージョンのサーバーは代わりにinitializeに応答し、SDKはそちらに切り替えます。

すべてのリクエストにバージョン:各リクエストは_metaにプロトコルバージョンを持つので、サーバーはセッションを保持せず、どのインスタンスでもどのリクエストにも応答できます。

入力が必要:ツールに人の答えが必要なとき、サーバーはinput_required、質問、署名付きのrequestStateを返してリクエストを終えます。クライアントは人に尋ね、その答えと同じrequestStateを付けてツールをもう一度呼び出します。サーバーは署名を確認するので、再試行は人が見た内容と一致していなければなりません。

ツールは契約

モデルに見えるのは、ツールの名前、説明、JSON Schemaだけです。readOnlyHintやdestructiveHintなどのアノテーションはサーバーからのヒントです。クライアントは、そのサーバーを信頼する範囲でしかそれを信頼しません。このラボの返金が安全なのは、サーバー自身が確認を求めて検証するからであり、モデルがきちんと振る舞うからではありません。

ここですること

SDKのクライアントを持つLangChainのエージェントであるHaldenのサポートエージェントと、SDKのサーバーであるHaldenのヘルプデスクが、どちらもこのページで動きます。シナリオを実行し、返金の質問に自分で答えてください。次に「傍受」をオンにし、メッセージを保留して改ざんします。本物のSDKのコードがそれを拒否します。

ステップ2/4: 試す:ワイヤー:エージェントとMCPヘルプデスク

ワイヤー:エージェントとMCPヘルプデスク

4つのステップがあり、それぞれ操作は1つで、任意の5つ目もあります。ステップの下の図は、参加者ごとに1列、メッセージごとに1行で、送られた順に上から下へ並びます。

ビジュアルを読み込んでいます…

モード:本物シミュレーション本物:公式のMCP TypeScript SDK(v2、プロトコル2026-07-28)のクライアントとサーバーが、このページで動きます。シミュレーション:モデルをつながない限り、エージェントの判断は台本どおりで、Haldenのデータは架空です。

ステップ3/4: 確認問題

確認問題

質問1/4MCPで、クライアントを動かすのは誰ですか。

次:質問2/4

質問2/4ヘルプデスクは返金の前にサポートリーダーのOKが必要です。2026-07-28のサーバーは何を送りますか。
質問3/4再試行で返金額を上げます。サーバーが拒否するのはなぜですか。
質問4/4サーバーがツールにreadOnlyHint: trueを付けています。クライアントはどうすべきですか。

ステップ4/4: これでできること

これでできること

  • MCPのホスト、クライアント、サーバーと、サーバーが提供する3つのものを説明できます。
  • 2026-07-28の流れ(server/discover、tools/list、tools/call、input_required、再試行)を追えます。
  • 署名付きのrequestStateが、確認を人が見た内容に結びつけておく理由を説明できます。
  • ツールのアノテーションを保証ではなくヒントとして扱えます。