The Engineering of Intent 第4章:Model Context Protocol(MCP)

本記事は、私の著書The Engineering of Intent(英語版)を1章ずつ読み解くシリーズの第4回です。前回の記事では、プロジェクトの勢いと経路依存──なぜ初期のプロンプトと規約がその後のすべてを形づくるのか──を見てきました。第4章は本書の第II部:エージェントのエコシステムとインフラの幕開けです。三者関係のエージェントの側と、そもそもそれを可能にしているインフラを扱います。


エージェントにとってのMCPは、初期のWebにとってのHTTPです

Model Context Protocol、すなわちMCPは、エージェント型エディタの台頭以来、AIネイティブなソフトウェアにおいてもっとも重要なインフラ上の進展です。モデルと外の世界とをつなぐ共通語なのです。

MCP以前は、あらゆる統合が個別対応でした。IDEごとに独自のツール呼び出し形式がありました。エージェントフレームワークごとに独自の関数定義スキーマがありました。企業ごとに独自のアダプターを書いていました。MCP以後は、一度実装したツールが、準拠したどのクライアントからでも使えるようになりました。この変化こそが、エージェント型開発がデモの小技ではなく、本格的な分野のように感じられ始めている理由です。


MCPが解決する問題

あなたのチームの社内ツールのひとつを思い浮かべてください──エンジニアが1日に100回は実行する「デプロイ状況の確認」コマンドです。MCP以前、それをエージェントから呼べるようにするための選択肢は3つありました。

  • チームが使っているアシスタント向けのカスタムプラグインで包む──そして自らをロックインする。
  • ローカルのHTTPエンドポイントとして公開し、エージェントにそれと話すことを教え込む──慎重なプロンプトエンジニアリングが永遠に続く。
  • エージェントにシェルへのアクセスを与えて祈る──インフラの世界でいえば、家のマスターキーを手渡すのと同じこと。

どれもスケールしませんでした。50の社内ツールを抱える中規模の企業が、アシスタントごとに50のプラグインを書く余裕などありませんし、広範なシェルアクセスに伴うセキュリティ上の責任を引き受けることもできません。MCPはこの問題をひとつにまとめてしまいます。サーバーをひとつ書くだけです。準拠したクライアントであれば、追加の作業なしにそれを利用できます。

💡 ポイント: MCPは3つの役割──ホスト、クライアント、サーバー──と、3種類の機能を定義しています。ツール(モデルが呼び出せる関数)、リソース(モデルが読めるコンテンツ)、そしてプロンプト(名前付きのテンプレート)です。トランスポートは、stdioまたはストリーミング可能なHTTP上のJSON-RPC 2.0です。スキーマは自己記述的なので、クライアントは事前登録なしにサーバーが何をするのかを発見できます。この最後の点こそが、それ以前のツール呼び出し形式にはなかった相互運用性をMCPにもたらしています。

15行で書く、はじめてのMCPサーバー

この章では、ひとつのツール──デプロイ状況の確認──を公開する、TypeScriptによる必要最小限のサーバーを順に見ていきます。本質だけに絞れば、実際のコードはおよそ15行です。その価値は複利で増えていきます。次のエンジニアが同じサーバーにtrigger_rollbackツールを追加すれば、クライアント側の更新を一切必要とせずに、すべてのエージェントの能力が豊かになるのです。

本書には、本番品質の認証、ロギング、エラーハンドリングを備えた完全なコードが載っています。けれども、スターターは紙ナプキンに書けるほど短く、そこが肝心なのです。MCPの活性化エネルギーの低さこそが、MCPを広めているのです。


大半のチームがつまずくのはセキュリティです

MCPは統合を簡単にするので、設定ミスも簡単にしてしまいます。この章では、私が現場で目にするもっともよくあるセキュリティ上の失敗を3つ整理しています。

  1. 広すぎるツールの公開範囲。「ちょっとしたひとつのこと」を公開するために書かれたサーバーが、何十ものツールへと膨らみ、デプロイ状況を読むだけのはずのエージェントが、ロールバックを実行し、データベースを書き換え、全社宛てのメールを送れるようになってしまいます。最小権限の原則が、これほど重要になったことはありません。
  2. 認証情報の漏洩。エージェントは役に立とうとします。リソースの中に認証情報を見つければ、あとのメッセージにそれを貼り付けてしまうかもしれません。生の認証情報は決して公開しないでください。有効期間が短く、スコープが限定されたトークンを使ってください。認証情報はサーバー側で解決してください。
  3. ツールの出力を介したプロンプトインジェクション。Webページを取得するツールは、エージェントへの指示を含む、攻撃者が制御するテキストを返すかもしれません。エージェントは役に立とうとして、それに従ってしまいます。これは仮定の話ではありません。すでに現実に悪用されています。ツールの出力はすべて、信頼できない入力として扱ってください。

良いツールとはどういうものか

コードベースのあらゆる関数をMCPツールにすべきではありません。うまく機能するツールには、見分けのつく共通の形があります。この章のチェックリストを凝縮すると、次のとおりです。

  • 狭く、動詞の形をした名前。get_customerのほうがcustomer_utilitiesより優れています。handlerやmanagerで終わるツールは、ほぼ例外なく範囲が広すぎて役に立ちません。
  • 正確な入力スキーマ。列挙型、必須フィールド、説明を備えたJSON Schemaは必須です。「任意の文字列」という入力は、ハルシネーションによるパラメーターを招きます。
  • 型付きの構造化された出力。自由形式のテキストの塊ではなく、名前付きのフィールドにしてください。エージェントがパースし直さなければならないたびに、誤解の機会が生まれます。
  • 可能な限りべき等なセマンティクス。リトライによって異なる副作用が生じてはいけません。
  • 失敗するときは派手に失敗する。「顧客が見つかりません」は役に立ちます。空の配列は曖昧です。
  • 短く、例の豊富な説明。説明文は、MCPサーバーの中でもっとも重要な文章です。時間をかけてください。
  • デフォルトは読み取り専用。list_customersとcreate_customerは分けてください。読み取りツールはリスクが低く、書き込みツールにはより高い権限での呼び出しが必要です。

「MCPサーバーは網羅的である必要はない。重要なことについて正しくあればよい。完璧なツール3つは、凡庸なツール100個に勝る。」


痛い目にあうアンチパターン

この章のアンチパターンのリストは、私がもっともよく引用される部分です。

  • 「何でもできる」ツール。生のSQLを受け付ける、ひとつのdatabase_query。エージェントにデータベースのroot権限を与えるのと同じです。出荷しないでください。
  • バージョン管理されていないツール。名前もバージョンも変えずにセマンティクスを変えること。ツールの契約は公開APIです。
  • 情報が漏れるツール。メールアドレスだけを求められたのに、顧客レコード全体を返すこと。
  • 副作用のある読み取り。こっそりとアナリティクスシステムにログを送るget_report。読み取りは読み取りであるべきです。
  • 認証のないゲートウェイ。ローカル開発なら問題ありません。本番の近くでは致命的です。
  • 曖昧なスコープ。それが何を意味するのかを示さずに「現在のプロジェクト」を操作するツール。相互汚染は避けられない帰結です。
⚠ 注意: 運用しているすべてのMCPサーバーは、トレースを出力すべきです──すべてのツール呼び出し、すべての入力、すべての出力、すべてのエラーを。これは任意ではありません。エージェントは奇妙なことをします。そしてその奇妙なことを再現できないとき、トレースが唯一の証拠になります。構造化ログ、OpenTelemetryのスパン、本番では1週間の保持期間。頻繁に呼ばれ、かつ頻繁に失敗するツールこそ、最初に直すべきツールです。

レガシーERPのケーススタディ

この章の締めくくりは、私がある製造業の企業で実装を手伝ったパターンです。築20年のOracleベースのERPが在庫の信頼できる唯一の情報源になっていて、エンジニアはそこからデータを取り出すのに途方もない時間を費やしていました。私たちは、その前段にMCPサーバーを構築しました。

ERP全体を公開したわけではありません。エンジニアが実際に使っていた3つのクエリ──get_inventory_level、get_reorder_forecast、get_supplier_contact──を特定し、3つのツールを構築しました。それぞれが事前に最適化された読み取り専用のビューに支えられ、30秒間キャッシュされ、ユーザーごとにスコープが限定され、呼び出しのたびにログが記録されます。

サーバーのコードは300行でした。それが20ページにわたる社内Wikiを置き換えました。そのチームの新任エンジニアが戦力になるまでの時間は、2週間から1日に短縮されました。


次回 ── 第5章「エージェント型エディタとフロー状態」 MCPが配線だとすれば、エディタはその配線があなたの手と出会う場所です。第5章では、エディタの3つの世代、コードベースのセマンティック検索があなたの一日を実際にどう変えるのか、そして現代のAIツールによる絶え間ない割り込みからフローを守るための設計パターンを順に見ていきます。


📖 さらに詳しく知りたい方へ

この章では、TypeScriptによるスターターサーバーの全体、セキュリティの完全な分解(プロンプトインジェクションへの防御を含む)、具体例つきの良いツールのチェックリスト、具体的な修正方法つきの6つのアンチパターン、エンタープライズでのMCP展開のケーススタディ(保険会社。6か月で7つのシステム。戦力化までの時間が2週間から3日に)、そして4時間の障害からあなたを救うツールのバージョン管理パターンを解説しています。

The Engineering of Intent をAmazonで購入する →(英語版)

2026-04-20

下田 昌平

開発に関するインプットをアウトプットしています。