サーバーが渡す3つのもの ― ツール・リソース・プロンプト

分かれているのは「誰が決めるか」が違うから

ここが腑に落ちると、設計の迷いが減ります。

「モデルに勝手に実行されては困るもの」をツールにしてはいけません。逆に、「読ませたいだけのデータ」をツールにすると、モデルが不必要に呼び出して文脈を汚します。

迷ったときの問いはこれです。この操作を、モデルが自分の判断で起こしてよいか。 よければツール、よくなければリソースかプロンプトです。

ツール：一覧をもらってから、呼ぶ

ツールの使い方は2手です。

- tools/list — 使えるツールの一覧と、それぞれの入力の形をもらう
- tools/call — 名前と引数を指定して実行する

一覧が別になっているのが効いています。サーバー側でツールを増やしても、クライアントは tools/list を取り直すだけで対応できます。再起動も再ビルドも要りません。

結果は content という配列で返ります。テキストだけでなく、画像や他の形式も返せるようになっています。

ツールが増減したときは通知も受け取れますが、これは申し込み制です。クライアントが subscriptions/listen で「ツール一覧の変更を知りたい」と伝えたときだけ届きます。届かないこともあるので、たまに取り直す作りにしておくのが安全です。

ツールの説明文が、モデルの目になる

ツール1つの定義は、だいたいこの形です。

{
  "name": "searchFlights",
  "title": "航空券を探す",
  "description": "出発地・到着地・日付から空席を検索する",
  "inputSchema": {
    "type": "object",
    "properties": {
      "origin": { "type": "string", "description": "出発都市" },
      "destination": { "type": "string", "description": "到着都市" },
      "date": { "type": "string", "format": "date" }
    },
    "required": ["origin", "destination", "date"]
  }
}

入力の形は JSON Schema で書きます。型が決まるので、クライアントが呼び出し前に検証できます。

そして最重要なのが description です。モデルはこの文章だけを見て、使うかどうかを決めます。 コードの中身は見えていません。

- 名前は具体的に。calculate より calculator_arithmetic
- 説明には「何をするか」だけでなく「どんなときに使うか」を書く
- 引数1つ1つにも説明を付ける

説明文の質が、そのままツールの使われ方の質になります。ここは手を抜くところではありません。

リソース：URIで指す、読み取り専用のデータ

リソースには1つずつ URI が付きます。file:///Documents/report.md や calendar://events/2026 のような形です。MIMEタイプも一緒に宣言します。

指し方は2種類あります。

- 直接指定 — calendar://events/2026 のように、決まったURIを指す
- テンプレート — travel://activities/{city}/{category} のように、穴の空いたURIを置いておく

テンプレートがあると、travel://activities/barcelona/museums のような組み合わせを後から作れます。入力補完にも使えます。

操作は resources/list（一覧）、resources/templates/list（テンプレート一覧）、resources/read（読む）です。

リソースはアプリが選ぶものなので、見せ方は自由です。ファイルツリーのように並べても、検索欄を出しても、会話の内容から自動で選んでも構いません。プロトコルはUIを決めていません。

プロンプト：人が選んで起動する定型

プロンプトは、サーバー作者が用意する手順のひな形です。prompts/list で一覧を取り、prompts/get で中身をもらいます。

引数を持てるので、「休暇の計画」プロンプトに行き先・日数・予算を渡す、といった使い方ができます。

{
  "name": "plan-vacation",
  "title": "休暇の計画を立てる",
  "arguments": [
    { "name": "destination", "type": "string", "required": true },
    { "name": "duration", "type": "number" }
  ]
}

必ず人が明示的に選びます。 モデルが勝手に起動することはありません。スラッシュコマンド（/plan-vacation）やコマンドパレットとして出す実装が多いのは、この性質に合っているからです。

サーバーを作る側から見ると、プロンプトは「このサーバーの正しい使い方」を見せる場所でもあります。ツールとリソースをどう組み合わせるとよいかを、ひな形として配れます。