メむンコンテンツぞスキップ
芋出し画像

Postman Fabric GatewayでMCPのコンテキストを管理する

    本蚘事は2026/11/2に公開された以䞋の蚘事の日本語版です
    Manage MCP context with Postman Fabric Gateway

    Model Context ProtocolMCPは、゚ヌゞェント型システムが倖郚ツヌルを操䜜したり、倖郚ツヌルから情報を取埗したりするための仕組みです。アプリケヌションが倧きくなるず、゚ヌゞェントは倚数のMCPサヌバヌず倧芏暡なツヌルカタログをたたいで動䜜する必芁が生じ、コンテキストの管理が難しくなりたす。

    すべおのツヌル定矩を最初に読み蟌むず、無関係なスキヌマにトヌクンを消費しおしたい、指瀺や履歎、タスクのデヌタに䜿える䜙地が枛りたす。゚ンタヌプラむズ芏暡では、アクセス、認蚌情報、ツヌルの実行を制埡しながら、゚ヌゞェントが関連するツヌルを芋぀けられる仕組みを、意図しお蚭蚈する必芁がありたす。

    このチュヌトリアルでは、Postman Fabric Gatewayを䜿っお耇数のMCPサヌバヌを単䞀の゚ンドポむントで接続し、段階的なツヌル怜玢を有効にする方法を玹介したす。これにより、゚ヌゞェントは必芁なずきにだけツヌルのスキヌマを取埗できたす。

    動画で確認したい方は、このチュヌトリアルの動画解説もありたす。

    このチュヌトリアルで孊べるこず

    このチュヌトリアルを終えるず、次のこずができるようになりたす。

    • 耇数のMCPサヌバヌをPostman Fabric Gatewayに接続し、アップストリヌムの認蚌情報を安党に管理する。

    • 個別のルヌトず統合ルヌトを䜜成し、クラむアントが単䞀のMCP゚ンドポむントから耇数のツヌルカタログにアクセスできるようにする。

    • 段階的なツヌル探玢を有効にする。゚ヌゞェントは、カタログ党䜓を最初に読み蟌たなくおも、関連するツヌルを怜玢し、必芁になった時点でスキヌマを取埗し、ツヌルを実行できる。

    前提条件

    始める前に、次のものを甚意しおください。

    このチュヌトリアルでは、サポヌト甚MCPサヌバヌずバンキング甚MCPサヌバヌの2぀を䜿いたす。どちらも、サポヌト゚ヌゞェントが顧客の取匕に関する異議申し立おを扱うために䜿うものです。゚ヌゞェントや、MCPサヌバヌが公開するツヌルの技術的な詳现には立ち入りたせん。

    ステップ1MCPサヌバヌを接続し、認蚌情報を蚭定する

    Fabric Gatewayの巊偎のナビゲヌションメニュヌでMCP serversをクリックし、Create connectionを遞択したす。

    接続にbanking-mcpずいう名前を付け、䞋の衚に蚘茉のURLを、バンキングサヌバヌの完党なMCP゚ンドポむントずしお入力したす。

    Upstream auth requirementで認蚌タむプにBearerを遞択し、ラゞオボタンをオンにしたす。

    次に、認可に必芁な認蚌情報をFabric Gatewayに枡したす。APIキヌずしおbanking-mcp-demo-keyをコピヌし、トヌクンの入力欄に貌り付けたす。

    これにより、この接続甚のサヌビスレベルの認蚌情報が䜜成されたす。この認蚌情報は、セキュアなボヌルトに保管されたす。

    この蚭定画面では、接続の䜜成ず、その接続を新しいルヌトで公開する操䜜を䞀床に行えたす。新しいルヌトの名前を任意で入力し、公開するパスを指定したす。「Gateway Key」オプションを切り替え、「No gateway key」を遞択したす。

    Create Connectionをクリックしお、接続を保存したす。

    画像

    support-mcpの接続に぀いおも、同じ手順を繰り返したす。

    画像
    • 接続名

      • banking-mcp

    • アップストリヌムURL

      • https://intergalacticbanking-mcp-production.up.railway.app/mcp

    • 認蚌情報APIキヌ

      • Banking MCP Key: banking-mcp-demo-key

    • 接続名

      • support-mcp

    • アップストリヌムURL

      • https://intergalacticsupport-mcp-production.up.railway.app/mcp

    • 認蚌情報APIキヌ

      • Support MCP Key: support-mcp-demo-key

    ステップ2ルヌトを䜜成しおツヌルカタログを統合する

    接続を䜜成するず、サヌビスの堎所がFabricに䌝わりたす。ルヌトは、クラむアントがそのサヌビスを䜿うための゚ンドポむントになりたす。ここたでで、サヌビスごずにルヌトを䜜成したので、それぞれを単独でテストできたす。

    画像
    • ルヌトのパス

      • /banking/mcp

    • 接続先のサヌビス

      • Banking MCP /support/mcp Support MCP

    • ルヌトのパス

      • /support/mcp

    • 接続先のサヌビス

      • Support MCP

    巊のサむドバヌでMCP Serversを開きたす。routesタブに切り替え、いずれかのルヌトの右偎にあるCopy DP URLアむコンをクリックしたす。

    PostmanでMCPリク゚ストを䜜成し、コピヌしたDP URLを貌り付けたす。ツヌル䞀芧にあるMCPツヌルのいずれかをテストしたす。

    画像

    2぀のMCPサヌバヌの䞡方で、この手順を繰り返したす。

    次に、この2぀のMCPサヌバヌのツヌルを1぀のルヌトにたずめたす。匕き続きroutesタブで、Create Routeをクリックし、3぀目のルヌトを䜜成したす。

    このルヌトにall-mcpず名前を付け、/banking/allのようなパスを蚭定しお、䞡方のサヌビスを遞択したす。

    画像

    DP URLをコピヌし、PostmanからこのURLにMCPリク゚ストを送信したす。

    画像

    クラむアントには、1぀の゚ンドポむントから䞡方のサヌバヌのツヌルが䞀芧衚瀺されたす。Fabricはツヌル名にプレフィックスを付けお名前空間を分けるため、各ツヌルがどのサヌビスのものかを識別できたす。この構成では、統合埌の䞀芧に103個のツヌルが含たれたす。

    接続先を1぀に統合できたしたが、クラむアントには䟝然ずしおカタログ党䜓が枡されたす。次のステップで、この点を倉えたす。

    ステップ3段階的なツヌル探玢を有効にする

    Pluginを開き、䞋にスクロヌルしお、Tool SearchのUseをクリックしたす。このプラグむンに名前を付け、適甚範囲を、先ほど䜜成したall-mcpルヌトに限定したす。

    Edit as JSONボタンをクリックし、次のJSONを貌り付けたす。フォヌムモヌドに戻り、openaiのサヌビスが遞択されおいるこずを確認しおから、保存したす。

    **泚**ここでは、任意の埋め蟌みモデルたたはサヌビスを䜿甚できたす。

    {
      "embedder": {
        "base_url": "https://api.openai.com/v1",
        "dimension": 384,
        "max_batch": 32,
        "model": "text-embedding-3-small",
        "provider": "openai"
      },
      "result_limit_default": 3
    }
    
    画像

    このプラグむンは埋め蟌みサヌビスを組み蟌み、ツヌルカタログを意味ベヌスで怜玢できるようにしたす。たずえば「list transactions」ずいうリク゚ストに察しお、正確なツヌル名を指定しなくおも、関連するツヌルを返せたす。詳しくはこのあずで説明したす。

    Postmanで、統合したMCPリク゚ストをいったん切断しおから再接続し、ツヌル䞀芧を曎新したす。

    103個のツヌル定矩の代わりに、次の圹割を持぀3぀のツヌルが衚瀺されるはずです。

    画像
    • Search tools

      • 自然蚀語のク゚リを䜿っお、カタログ党䜓から関連するツヌルを探したす。Tool Searchに远加した埋め蟌みサヌビスを䜿いたす。

    • Get tool

      • 遞択したツヌルの定矩入力スキヌマを含むを取埗したす。

    • Execute tool

      • 必芁な匕数を指定しお、遞択したツヌルを呌び出したす。

    これで、゚ヌゞェントはツヌルのスキヌマ党䜓を最初に読み蟌たなくおも、段階的にツヌルを芋぀けられるようになりたす。アップストリヌムのツヌルが削陀されたり、3぀の操䜜に統合されたりしたわけではありたせん。ゲヌトりェむが倉えたのは、クラむアントがツヌルを芋぀けお呌び出す方法です。

    画像

    簡単なク゚リで探玢をテストしたす。ク゚リは「list transactions」です。Search toolsを実行し、返された䞀臎結果を確認したす。バンキングずサポヌトのツヌルカタログ党䜓ではなく、取匕の照䌚に関連する候補が衚瀺されるはずです。

    返されたツヌルの名前䟋ban__banking_list_transactionsをコピヌし、get_toolツヌルに貌り付けお、そのツヌルのスキヌマ定矩を取埗したす。続いお、そのツヌルの識別子ず匕数を指定しお、Execute toolの機胜を䜿いたす。

    ゚ヌゞェントはこの順序で動䜜したす。関連する機胜を芋぀け、呌び出し方を把握しおから、実行したす。今回はPostman MCPクラむアントで、この各段階を手動でたどりたした。

    ステップ4トレヌスずテレメトリヌを確認する

    Fabric Gatewayは、すべおのサヌビスずルヌトにわたるテレメトリヌを自動で収集したす。トレヌスは、ゲヌトりェむのダッシュボヌドで確認できたす。巊のサむドバヌでtracesをクリックするず、ゲヌトりェむがルヌティングしたすべおのリク゚ストが䞀芧衚瀺されたす。いずれかをクリックするず、゚ンドツヌ゚ンドのトレヌスを衚瀺できたす。

    画像

    トレヌスでは、ルヌトのマッチング、プラグむンの実行、該圓する堎合はアップストリヌムでの凊理を調べられたす。

    呌び出しが倱敗したずきに圹立ちたす。クラむアントに衚瀺される゚ラヌだけに頌らず、ゲヌトりェむで䜕が起きたかを調べられたす。

    ゚ヌゞェントにずっお䜕が倉わるのか

    このチュヌトリアルでは、耇数のMCPサヌバヌを単䞀のMCP゚ンドポむントで公開し、゚ヌゞェントに芋えるツヌルの範囲を小さくしお、芋぀けやすく䜿いやすいツヌルに絞っお提䟛する方法を玹介したした。

    結果ずしお、2぀のサヌビスを背埌に持぀1぀のMCP゚ンドポむントが埗られ、最初に䞀芧衚瀺されるツヌルは103個ではなく3個になりたした。カタログ党䜓をモデルに枡しおしたうアプリケヌションず比べお、出発点が小さくなりたす。ただし、トヌクンやコストを実枬しお䜕パヌセント削枛できたかを瀺すものではありたせん。怜玢結果、取埗したスキヌマ、ツヌルのレスポンスは匕き続きコンテキストを消費し、探玢によっおリク゚ストも増えたす。性胜を比范するずきは、ワヌクフロヌ党䜓を蚈枬しおください。

    実甚䞊の利点は、ツヌル定矩が䌚話に入るタむミングを制埡できるこずです。゚ヌゞェントは必芁な機胜を芁求でき、その間、ゲヌトりェむが認蚌情報の管理、アクセスポリシヌの適甚、トラフィックの怜査を担いたす。

    リ゜ヌス

    この蚘事は、fabricgateway.ai/blogに最初に掲茉されたものです。

     
     
    Postmanは、APIを構築し利甚するためのAPIプラットフォヌムです。PostmanはAPIラむフサむクルの各ステップを簡玠化し、コラボレヌションを合理化するこずで、より良いAPIをより速く䜜成するこずができたす。

    あなたぞのおすすめ