MCPとAPI
図書室で「『星の図鑑』は借りられる?」と調べる場面を考えます。検索ページが図書室のシステムに聞く方法と、AIアプリがMCPで検索の道具を使う方法を比べます。
Web APIを直接使う例
- 検索ページ本の名前を受け取る
- Web API決められた宛先に検索を頼む
- 図書室のシステム本の記録を調べる
- 検索ページに返事「貸し出し可」と表示
MCPサーバーを通して使う例
- AIアプリ本を探す道具を選ぶ
- MCPサーバー道具の説明を出し、検索を受け付ける
- 図書室のWeb API検索を受けて記録を調べる
- AIアプリに返事MCP経由の結果をもとに「借りられます」と答える
APIで検索を頼む
API(エーピーアイ)は、プログラムが別のプログラムの機能を使うときの取り決めです。図書室の検索なら、何を渡して何を受け取るのかを決めておきます。Web APIは、その依頼と返事をWebでやり取りするAPIです。
検索ページからの依頼
GET /books?title=星の図鑑GETは情報を受け取るときに使います。図書室が用意した検索先 /books に本の名前を渡します。
図書室のシステムからの返事
{ "title": "星の図鑑", "available": true }availableは貸し出しできるかどうか。trueを受け取ったページは「貸し出し可」と表示します。
図書室のAPIは教材用の例です。検索の例は読みやすさのため、日本語をURL用の表記に変える前の形で示しています。APIの定義(MDN) / HTTPとJSONの説明(Web開発入門)
MCPで道具を探して使う
MCP(エムシーピー)は Model Context Protocol の略です。AIアプリと、そのアプリに道具や資料を渡すプログラムが、共通の手順で話せるようにします。
使える道具を聞く
AIアプリの中にあるMCPクライアントが、接続先のMCPサーバーに道具の一覧を聞きます。サーバーは「本を探す道具があります。本の名前を渡してください」と返します。
本の名前を渡して探す
AIモデルが検索を選び、AIアプリがMCPで道具を呼びます。この例では、MCPサーバーが図書室のWeb APIに「星の図鑑」を問い合わせます。
結果を受け取って答える
図書室が「貸し出し可」と返します。MCPサーバーから結果を受け取ったAIアプリは、それをモデルへ渡し、利用者へ答えます。
道具のほかに何を渡せる?
MCPサーバーは、提供する機能に応じて、図書室の利用案内のような資料(リソース)や、読書カードを書くときの指示のひな形(プロンプト)も用意できます。使える種類はサーバーとAIアプリの対応によって変わります。
できること・できないこと
比較するのは「図書室のWeb APIを直接使う方法」と「AIアプリがMCPで道具を使う方法」です。図書室が用意した機能と、使う人に与えられた権限で、実際にできる操作が決まります。
| やりたいこと | Web APIを直接使う | MCPを使う |
|---|---|---|
| 本を探す | 検索用の宛先と本の名前の渡し方を知っていれば、検索できる。 | つないだサーバーが「本を探す」道具を提供していれば、検索できる。 |
| 使える機能を知る | 開発者が説明書などで、検索や予約の呼び方を調べる。APIによっては一覧を提供する。 | 道具に対応したサーバーへ、道具の名前・説明・必要な入力を共通の方法で聞ける。 |
| 本を予約する | 予約用APIと予約の権限があればできる。検索用APIだけでは予約できない。 | 予約の道具と予約の権限があればできる。検索の道具だけでは予約できない。 |
| 他人の貸し出し記録を見る | 自分の権限で閲覧できない記録は取得できない。 | 同じ権限でつないだ場合は閲覧できない。MCPを通しても権限は増えない。 |
| 検索するかを決める | 検索ページのコードや、AIアプリのモデルが決める。 | AIアプリやモデルが決める。MCPは選んだ道具を呼ぶために使う。 |
図書室の検索ページを作るなら、Web APIを直接呼ぶ方法で足ります。対応するAIアプリに図書室の検索を追加したいなら、MCPで道具を提供する方法があります。MCPサーバーは、この例のように既存APIを使うことも、手元のファイルを読む道具を提供することもできます。
たしかめ問題
AIが「星の図鑑は貸し出し可」と答えました。つないでいるMCPサーバーにあるのは検索の道具だけです。そのAIアプリに今の接続で予約も頼めるでしょうか。
答えを見る
今の接続でできるのは検索です。予約するには、予約を受け付ける機能と、予約できる権限が必要です。「借りられる」という検索結果と「予約できた」という処理結果を区別しましょう。
道具を選んだあとに、使ってよいか確かめて結果をモデルに渡すのはAIアプリ側の役割です。AIハーネスの説明に戻る