メインコンテンツへスキップ
見出し画像

Postmanの新機能:Kafka、MCPテスト、RAMLに対応

    本記事は2026/11/13に公開された以下の記事の日本語版です
    What’s new in Postman: Kafka, MCP tests, RAML

    一つのシステムが扱うプロトコルは、もはや一種類にとどまりません。たとえば決済処理では、HTTPリクエストから始まり、Kafkaトピックへイベントを発行し、最後にAIエージェントがMCPサーバー上のツールを呼び出して完了する流れが一般的です。しかし、この一連の挙動を検証しようとすると、プロトコルが切り替わるたびに別のクライアントツールへ持ち替え、そのあいだをつなぐグルーコードを自前で書く必要がありました。

    今週のアップデートでは、こうした工程をPostmanひとつに集約できます。Postmanのリクエスト種別にKafkaが加わり、MCPリクエストがスクリプトとテストに対応し、Spec HubでRAML 1.0とOpenAPI 3.2を直接扱えるようになりました。以下では、主な変更点とそれぞれの使い方を紹介します。

    PostmanでのKafka対応

    Postmanのリクエスト種別に、新たにApache Kafkaが加わりました。すべてのユーザーが追加設定なしで利用でき、メッセージの送信(プロデュース)と受信(コンシューム)、スクリプトの記述、テストの実行までを単一の画面で行えます。トリガーとなるHTTPリクエストと同じコレクション内にKafkaリクエストを並べられるため、検証環境としてJVMや専用フレームワーク、セルフホスト型の管理コンソールを別途立ち上げる必要はありません。

    トピックへのメッセージ送信と受信

    メッセージを送信する際は、キー、パーティション、ヘッダーを指定できます。受信する際は、読み取りの開始位置を「最も古いオフセット(earliest)」「最新のオフセット(latest)」「特定のオフセット」「タイムスタンプ」から選択します。トピックへの待機が続いて処理が止まらないよう、読み取りを自動終了してリクエストを完了させる上限付きコンシューム(Bounded consume)も備えています。

    クラスターへの接続

    クラスターへの接続認証は、SASL、AWS IAM、mTLSに対応しています。コレクションまたはフォルダの階層で認証情報を一度設定すれば、配下のすべてのKafkaリクエストにその設定が継承されます。最初のメッセージを送信する前に、接続テスト機能で疎通を確かめることも可能です。

    AsyncAPIからのKafkaコレクション生成

    イベント仕様をAsyncAPIで記述している場合、リクエストを手作業で組み立てる手間はかかりません。Spec HubにAsyncAPI 2.xまたは3.xの仕様書を取り込めば、Kafkaコレクションを自動生成できます。仕様書を更新するとコレクション側にも変更が同期され、各トピックにスキーマが対応づけられるため、スキーマを基準としたコントラクトテストを記述できます。この機能はLocal Modeでも動作します。

    HTTPリクエストと並べたKafkaの実行

    送信・受信するメッセージにはプレリクエストスクリプトやテストを組み込め、変数、Console、Historyもそのまま機能します。スクリプトの記述自体はAgent Modeに任せることもできます。Collection Runnerを使えば、データセットを適用しながらHTTPや他のプロトコルと並べてKafkaのステップを連続実行し、ステップ間で値を受け渡せます。1回の実行の中でAPIを呼び出し、その結果として発行されたイベントを続けて検証する流れがそのまま組めます。

    作成したコレクションは、Postman CLIを通じてCI/CDパイプライン上でも実行できます。

    postman collection run 12345678-abcd-4e5f-9a0b-1c2d3e4f5a6b \
      --environment 98765432-staging

    Kafkaリクエスト単体の利用は、すべてのプランで無料です。Collection RunnerおよびPostman CLIでのKafka実行は、Solo、Team、Enterpriseの各プランで提供されます。

    MCPリクエストでのスクリプトとテスト対応

    Model Context Protocol(MCP)に準拠したサーバーを構築・利用している開発者も、HTTP APIと同じ手順で動作を検証できるようになりました。MCPリクエストのスクリプトとテスト機能は、Freeや従量課金制(Consumption Pricing)を含むすべてのプランで利用できます。接続を構成してサーバーが公開する機能を確かめたうえで、各ツールの呼び出し、プロンプト、リソースの読み取りを検証し、それらをCollection Runner上でHTTPリクエストと並べて一括実行できます。

    実行順に動作する4つのスクリプトフック

    MCPセッションの開始から終了まで、以下の4つのフックが順番に実行されます。

    1. Before connect
      URL、ヘッダー、認証情報、STDIOコマンドを設定します。必要に応じて接続自体をスキップする制御も可能です。

    2. After connect
      サーバー名、プロトコルバージョン、ケイパビリティ(機能一覧)を検証し、必要なツールが期待どおりの入力スキーマとともに存在しているかを確かめます。

    3. After response
      ツールの呼び出し、プロンプト、リソースの読み取りごとに実行されます。実行結果、エラー、構造化コンテンツ、レスポンスタイムを検証し、後続の呼び出しで使う値を保存できます。スクリプトの編集内容は次回の送信時にすぐ反映されるため、セッションを再接続する必要はありません。

    4. After disconnect
      セッションが終了するタイミングで実行されます。

    コレクションやフォルダからのスクリプト継承

    コレクションまたはフォルダの階層で mcp:beforeConnect、mcp:afterConnect、mcp:afterResponse、mcp:afterDisconnect の各スクリプトを一度定義すれば、配下のすべてのMCPリクエストに継承されます。共通の接続確認処理をリクエストごとに複製する必要がなくなり、保守箇所を一か所に集約できます。

    フェーズ別のテスト結果表示

    新しくなったTest Resultsタブでは、セッション内のテスト結果が「Connection(接続)」「各呼び出し単位」「Disconnection(切断)」のグループに分けて表示されます。ツール呼び出しが失敗した際も、フラットな一覧を延々とスクロールすることなく、どのフェーズで問題が起きたのかを即座に特定できます。Collection Runnerでは、HTTPやその他のマルチプロトコルリクエスト(Multiprotocol Requests)と同じ実行フローの中でMCPリクエストとテストを動かし、ステップ間で値を受け渡せます。

    Spec HubでのRAML 1.0とOpenAPI 3.2のサポート

    変換なしで直接扱えるAPI仕様フォーマットが、Spec Hubに新たに2つ加わりました。

    RAML 1.0

    RAML形式のAPIを運用しているチームは、事前にOpenAPIへ変換することなく、Spec Hub上で直接APIの設計・管理を行い、コレクションを生成できるようになりました。この機能はv12.34.4でリリースされています。

    • 仕様メニューからRAML 1.0仕様を新規作成できるほか、既存のRAMLファイルやフォルダをインポートできます。複数ファイルを一括で取り込んだ場合でも、Spec Hubがルートファイルを自動的に判別します。

    • !include や uses: によるライブラリ参照に対応しており、関連ファイルとして .raml、.yaml、.yml、.json、.xsd、.xml、.md、.txt を扱えます。

    • RAML仕様でも、アウトライン表示とバリデーション(構文検証)ペインを利用できます。

    • 仕様書からコレクションを生成し、仕様の変更内容をコレクションへ同期できます。

    以下のような複数ファイル構成の仕様書も、構造を変えずにそのままインポートできます。

    #%RAML 1.0
    title: Orders API
    version: v1
    baseUri: https://api.example.com/{version}
    uses:
      common: libraries/common.raml
    types:
      Order: !include types/order.raml
    /orders:
      get:
        responses:
          200:
            body:
              application/json:
                type: Order[]

    RAMLサポートは、Free、Solo、Team、Enterpriseの各プランで利用できます。

    OpenAPI 3.2

    Free、Solo、Team、Enterpriseの各プランにおいて、Spec HubでOpenAPI 3.2仕様の作成と管理も可能になりました。既存の仕様書をインポートし、アウトラインスニペット、バリデーション、ライブプレビューを使いながら編集できます。仕様書からのコレクション生成はもちろん、コレクションからOpenAPI 3.2仕様を生成して双方向に同期することも可能です。ガバナンス用のLintチェックはPostmanアプリ上でもPostman CLIでも実行できるため、手元の開発環境とCI/CDパイプラインの双方で同じルールを強制できます。

    リージョンをまたいだ複数チームでのドメインキャプチャ

    Advanced Security Administrationを契約しているEnterpriseプランの組織では、米国(US)と欧州(EU)のリージョンをまたいで、単一のドメインを複数のチームに紐づけられるようになりました。ドメインの許可リスト(allowlist)に別リージョンのチームを追加すると、該当ドメインのメールアドレスを持つユーザーは、どちらのリージョンの許可済みチームにもアクセスできるようになります。従来の単一リージョン・単一チーム構成や、リージョン横断の単一チーム構成の挙動は変わりません。この機能はユーザーを適切なチームへルーティングする仕組みであり、ユーザーのデータ自体をリージョン間で移動させるものではありません。

    今週試せる3つの検証ステップ

    • AsyncAPI仕様書をSpec HubにインポートしてKafkaコレクションを生成し、受信したメッセージをスキーマと照合するテストを1つ追加します。

    • 普段利用しているサーバーに向けてMCPリクエストを設定し、必要なツールの存在を確かめるAfter connectスクリプトを追加して、Collection RunnerでHTTPリクエストと並べて実行します。

    • RAMLプロジェクトをSpec Hubにインポートし、そこからコレクションを生成します。

    これら3つをつなげれば、HTTPリクエストの呼び出しからKafkaイベントの発行、そしてMCPツールの実行まで、冒頭で挙げた一連の処理を1回のテスト実行で通し検証できます。

    関連リソース

     
     
    Postmanは、APIを構築し利用するためのAPIプラットフォームです。PostmanはAPIライフサイクルの各ステップを簡素化し、コラボレーションを合理化することで、より良いAPIをより速く作成することができます。

    あなたへのおすすめ