「APIを呼ぶのは人間ではない」MCPとOpenAPIで整えるエージェント時代のAPI設計
技術関連@IT
MCPOpenAPIAIエージェントAPI設計開発者向け
@ITは11月12日、AIエージェントがAPIの主な呼び出し元になる前提でのAPI設計論を掲載した。2026年7月のMCP仕様改訂でステートレス化が実現し、標準的なHTTPロードバランシングに乗るようになった点、OpenAPI定義があれば既存RESTを大きな改修なしにMCPサーバー化できる点を整理している。
何が発表されたか
- @ITの連載「Agent時代の必須知識 APIから読み解くAIの裏側」第回として、11月12日に公開された解説記事。筆者はPostmanの草薙昭彦氏。
- MCPは通常のWebインフラに近づいた。2026年7月の仕様改訂でステートレス化されたため、MCPサーバーも標準的なHTTPロードバランシングと水平スケールに載せられる。
- 既存APIは小さな改修でエージェントに開放できる。しっかりしたOpenAPI定義があるRESTなら、バックエンドを書き直さずツール経由でMCPサーバーを生成できる。
- ただしエージェントは仕様書を「解釈」する。機械可読な型定義だけでは足りず、各オペレーションが何をするもので、いつ使うべきかを説明する記述が要る。
- エンドポイントを1対1でツール化するとエージェントのコンテキストを圧迫しトークンを浪費する。少数のよく設計されたツールにまとめることが推奨される。
- 発見可能性とアクセス制御は一対で設計する。見つけられないAPIはエージェントにとって存在しないが、誰でも発見・実行できるAPIは危険だ。
- 関連プロトコルも動いている。MCP Apps(2026年1月)はエージェントの会話に対話型UIを足し、A2Aはエージェント間通信を担ってMCPと補完関係にある。
実務への影響
- 受託でAPIを作る案件の要件が一段増える。これまで「フロントが叩ければ十分」だったAPIに、説明文の質という納品物が加わる。
descriptionを埋めるかどうかで、顧客がそのAPIをエージェントに繋げられるかが決まる。 - 既存案件の棚卸しに使える観点でもある。OpenAPI定義がないAPIは、エージェント対応を頼まれた時点でまず定義書き起こしの工数が発生する。定義があるかどうかで見積りが変わると説明できる。
- ツールを絞る設計指針は、MCPサーバーを自作する際にそのまま効く。「全エンドポイントを公開する」実装は動くが、エージェント側の精度が落ちてトークン単価も上がる。
- 認証・エラーハンドリング・ツール統合・説明文は自動生成では詰め切れず、人の設計が残ると明言されている点も、工数の根拠として使いやすい。
補足
- 一次情報は仕様・ドキュメント側(MCP仕様、OpenAPI)にあり、本記事はそれを踏まえた解説である。個別の製品発表ではない。
