MCPのElicitationとは?途中で入力を求める仕組み

MCPのElicitationとは?途中で入力を求める仕組み

MCP のサーバーが、ツールを動かしている途中で「足りない値を教えてください」とユーザーに聞き返せる仕組みがあります。

それが MCP の Elicitation(エリシテーション)で、サーバーがクライアントを通してユーザーに入力や確認を求め、その答えを受け取って処理を続ける仕組みです。

2025-06-18 版の仕様で加わり、2025-11-25 版で URL を開いてもらう形が足され、現行の 2026-07-28 版ではやり取りの形そのものが変わりました。

仕様が決めているメッセージと、聞いてよいこと・聞いてはいけないこと、Claude Code での見え方が分かると、自分で MCP サーバーを作るときにも迷いにくくなります。

MCP 自体は、AI アプリと外部のツールやデータをつなぐための共通の約束事です。

MCPとは?AIエージェントと外部ツールをつなぐ標準規格

Elicitation は何をする仕組みか

仕様は Elicitation を、サーバーがやり取りの途中で、クライアントを通してユーザーから追加の情報を受け取る標準の方法として定めています。

入力の画面をどう見せるかはクライアントに任されていて、プロトコルは特定の見た目を決めていません。

画面をクライアントが受け持つので、どのサーバーに何を渡すかをユーザーが最後まで自分で選べます。

求め方には、次の 2 つのモードがあります。

  • フォームモード(form): サーバーが JSON Schema で入力欄の形を示し、ユーザーが答えた値をクライアント経由で受け取る
  • URL モード(url): サーバーが URL を示し、ユーザーにブラウザでそのページを開いてもらう(入力した中身はクライアントを通らない)

URL モードは 2025-11-25 版で加わった機能で、今後の版で設計が変わりうるという注記が付いたままです。

仕様の原文は MCP 仕様 2026-07-28 版の Elicitation のページで読めます。

Elicitation - Model Context Protocol

やり取りの流れとメッセージ

サーバーが入力を求めるときに使うメソッドは elicitation/create です。

どのモードでも、パラメーターには求める理由を人が読める文で書いた message が要ります。

フォームモードでは入力の形を示す requestedSchema を、URL モードでは開いてもらう url を足します。

mode を省いたリクエストは、古い版との互換のためにフォームモードとして扱われます。

版によって大きく変わったのは、このリクエストの届け方でした。

2025-11-25 版までは、サーバーがクライアントへ elicitation/create のリクエストを直接送り、クライアントがその応答として答えを返していました。

現行の 2026-07-28 版では Multi Round-Trip Requests(MRTR)という形に置き換わり、サーバーは元のリクエストへの途中結果として InputRequiredResult を返します。

その inputRequests に elicitation/create が入っていて、クライアントはユーザーの答えを inputResponses に入れて、元のリクエストをもう一度送ります。

仕様はこの形の狙いを、サーバーの複数のインスタンスで状態を共有する仕組みや、同じサーバーへ振り分け続けるロードバランサーを要らなくするためと説明しています。

次の例は、2026-07-28 版の仕様にある GitHub のユーザー名を求めるリクエストです。

{
  "method": "elicitation/create",
  "params": {
    "mode": "form",
    "message": "Please provide your GitHub username",
    "requestedSchema": {
      "type": "object",
      "properties": { "name": { "type": "string" } },
      "required": ["name"]
    }
  }
}

ユーザーが答えると、クライアントは元のリクエストを送り直すときの inputResponses に {"action": "accept", "content": {"name": "octocat"}} のような結果を入れます。

2026-07-28 版で変わった点は、MCP 仕様 2026-07-28 版の変更点(Key Changes)にまとまっています。

Key Changes - Model Context Protocol

フォームで求められる入力の形

フォームモードの requestedSchema は JSON Schema のすべてを使えるわけではなく、仕様が決めた一部に絞られています。

使えるのは、入れ子のない 1 段のオブジェクトと、その下に並べた基本の型のプロパティだけです。

型書ける主な制約
文字列(string)minLength・maxLength・format(email・uri・date・date-time)
数値(number・integer)minimum・maximum
真偽値(boolean)制約はなし(default は付けられる)
選択肢(enum・oneOf)1 つ選ぶ形と、配列で複数選ぶ形(minItems・maxItems)

どの型にも title・description・default を付けられ、default に対応するクライアントは入力欄にその値を入れておくよう勧められています。

default がすべての基本の型で使えるようになったのは、2025-11-25 版からでした。

入れ子のオブジェクトや、選択肢以外のオブジェクトの配列は意図して外されていて、仕様はその理由をクライアントの画面を単純に保つためとしています。

入れ子にしたい項目があるときは、平らな項目に分けて並べる形に直す必要があります。

ユーザーが返せる 3 つの応答

応答の action は、フォームでも URL でも次の 3 つのどれかです。

actionユーザーがしたことサーバーの扱いの例(仕様より)
accept送信・OK・確認を押した受け取ったデータを処理する
decline拒否・いいえを押して、はっきり断った別の手段を提案する
cancel選ばずに閉じた(ダイアログを閉じた・Esc を押した・ページが読み込めなかった など)後でもう一度聞く

フォームモードの accept では、requestedSchema に沿った値が content に入ります。

URL モードの accept は content を持たず、ユーザーがページを開くことに同意したという意味で、ページでの操作が終わったという意味ではありません。

ページでの操作はクライアントの外で進むため、終わったかどうかはサーバーが自分の記録や requestState から判断します。

仕様が decline と cancel を分けているのは、はっきり断られたのか、選ばずに閉じられたのかを区別するためです。

パスワードや API キーはフォームで聞かない

現行の仕様は、パスワード・API キー・アクセストークン・決済の認証情報をフォームモードで求めることを MUST NOT(してはならない)として禁じています。

こうした情報が絡むやり取りには、URL モードを使わなければならない(MUST)とされています。

ここでいう機密情報は、何かへのアクセスや取引を許可する秘密や認証情報を指します。

名前・メールアドレス・ユーザー名のような連絡先やプロフィールの情報は、一律に禁止されているわけではありません。

フォームで聞くかどうかはサーバーの判断で、ユーザーが中身を見て断れることが前提です。

URL モードなら、入力した秘密が LLM のコンテキストにもクライアントにも流れないので、クライアント側のログなどから漏れる経路を減らせます。

その代わり、URL モードにはクライアントとサーバーの両方に決まりがあります。

  • クライアントは、URL を先に読み込まない・ユーザーの同意なしに開かない・同意の前に URL 全体を見せる
  • サーバーは、URL に認証情報や個人を特定できる情報を入れない・ログイン済みの状態で使える URL を渡さない
  • サーバーは、URL を開いた人がリクエストを始めた本人と同じかを確かめる(他人に URL を開かせて乗っ取る手口への対策)

URL モードは、MCP クライアントが MCP サーバーに接続するための認可には使いません。

使うのは、MCP サーバーが外部サービスの OAuth 認可をユーザーから受けたいときや、決済のような流れにユーザーを送りたいときです。

2025-06-18 版の機密情報の定めは「求めてはならない」とあるだけで、何が機密かの説明も URL モードもまだありませんでした。

どんな場面で使うか

仕様の例に出てくるのは、GitHub のユーザー名や連絡先をフォームで聞く場面と、URL モードで API キーの入力ページや外部サービスの OAuth に送る場面です。

ツールの引数だけでは決めきれない値を、その場でユーザーに聞きたいときに向いています。

Claude Code のフックのドキュメントにも、サーバーがフォームでプロジェクトのキーを聞いてきて、フックが代わりに答える例が載っています。

AI に任せた作業の途中で人の判断を挟む考え方は、ヒューマン・イン・ザ・ループとも重なります。

ヒューマン・イン・ザ・ループとは?AIに人の承認を挟む仕組み

対応しているクライアントの確かめ方

プロトコルの上では、クライアントが elicitation の capability を宣言しているかどうかで分かります。

2025-11-25 版までは接続の最初の initialize で、2026-07-28 版ではすべてのリクエストの _meta にある io.modelcontextprotocol/clientCapabilities で宣言します。

中身が {"form": {}, "url": {}} なら両方のモード、空のオブジェクトならフォームモードだけに対応しているという意味です。

サーバーは、クライアントが宣言していないモードで Elicitation を送ってはいけません。

使う側として確かめるなら、使っているクライアントのドキュメントで Elicitation の扱いを探します。

Claude Code のドキュメントには、サーバーが入力を求めると対話のダイアログが自動で出て、利用者の設定は要らないと書かれています。

フォームモードではサーバーが決めた入力欄が並び、URL モードではブラウザでリンクを開くかどうかを聞かれます。

2026-07-28 版で接続したときに Claude Code が宣言するのは elicitation: {form: {}, url: {}} です。

詳しくは Claude Code のドキュメント「Connect Claude Code to tools via MCP」の Elicitation の節にあります。

Connect Claude Code to tools via MCP - Claude Code Docs

ダイアログを出さずに自動で答えたいときは、Claude Code の Elicitation フックで accept・decline・cancel のどれかを返せます。

ダイアログで「Decline」を選ぶと decline、Esc キーを押すと cancel がサーバーに届く、とフックの説明にあります。

フックそのものの考え方は、エージェントフックの記事で扱いました。

フックとは?AIエージェントの操作をコードで止める仕組み

つまずきやすい点

サーバーは、ユーザーが断ったり閉じたりする場合と、クライアントが処理できない場合を必ず扱わなければなりません。

答えが返ってくる前提で処理を組むと、ユーザーがダイアログを閉じただけで先へ進めないツールになります。

版の違いも見落としやすいところです。

2026-07-28 版では、URL モードの完了を知らせる notifications/elicitation/complete 通知と elicitationId が外されました。

続きの判断は、サーバーが requestState に持たせる形に変わっています。

古い版のサンプルを写すと、今の仕様にない通知を待つことになるので、どの版の仕様を見ているかを先に確かめます。

ユーザーが答えた内容で本人を決めないことも、仕様の定めの一つです。

フォームに「私は joe@example.com です」と入れられても、それを本人の証明として扱わず、MCP の認可で本人を確かめるよう仕様は求めています。

Claude Code の URL モードは、URL をコマンドライン引数として OS の URL ハンドラーに渡すので、長さに上限があります。

エスケープの要る文字がない URL なら約 8,000 文字、パーセントエスケープが多い URL なら約 4,000 文字で上限に届き、超えると断ることしかできません。

2026-07-28 版で公式の拡張に移った MCP の Tasks は、サーバー側で長い処理を走らせる仕組みで、Claude Code の CLI では v2.1.304 以降でパブリックベータです。

対話のないセッションで入力を求めたタスクには、Elicitation フックを呼ばずにキャンセルをサーバーへ頼むのが Claude Code の動きです。

最後に

Elicitation は、MCP サーバーが作業の途中でユーザーに聞き返すための仕様で、フォームモードと URL モードの 2 つがあります。

応答は accept・decline・cancel の 3 つで、断られた場合と閉じられた場合もサーバーが扱う前提になっています。

秘密はフォームで聞かずに URL モードへ回すことと、宣言されていないモードを送らないことが、作る側がまず守る線です。

仕様は版ごとに形が変わっているので、実装するときは使う版の Elicitation のページを開いて確かめてください。

以上です。

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

CAPTCHA