Swagger MCP サーバーを作成する

ツールとして公開する API を記述した OpenAPI ドキュメントを提供して、Orchestrator で Swagger MCP サーバーを作成します。

注:

この機能はプレビュー版です。

Swagger MCP サーバーは、OpenAPI ドキュメントを MCP ツールに変換します。ドキュメントを指定すると、ドキュメントで説明されている各操作が、サーバーが HTTP 経由で呼び出すツールになります。

前提条件

• MCP サーバーに対するフォルダーレベルの作成権限。
• API 用の OpenAPI ドキュメントです (URL または貼り付け可能なファイル)。

Swagger MCP サーバーを作成する

1. In Agent Gateway > MCP Servers, select the MCP サーバーを追加 menu.

2. [ 外部] で [ Swagger] を選択します。

3. 名前を入力します。これは、サーバー リストに表示される表示名です。

4. ナメクジの登場です。

   注:

   スラッグでは、小文字、数字、ハイフンのみを使用でき、3 文字から 50 文字で設定する必要があります。これは、サーバー URL の最後のセグメントになります。

5. 任意で、最大 500 文字の 説明 を入力します。

6. OpenAPI ドキュメントの提供方法を選択します。[ 送信元 URL ] を選択して提供元の Swagger URL を入力するか、[ JSON を貼り付け ] を選択してドキュメント自体を貼り付けます。

   注:

   [URL から] は、後でツールを更新できる唯一のオプションであるため、優先するオプションです。UiPath がアクセスできるアドレスにドキュメントが提供されない場合は、[ JSON を貼り付け ] を使用します。この 2 つのオプションを切り替えると、もう一方のオプションで入力した内容がクリアされます。

7. 接続の種類を [標準] でパブリック インターネット経由で直接接続する場合、または [プライベート (Relay)] を選択して、ユーザー独自のネットワーク内の API に対して UiPath Relay 経由でトラフィックをルーティングします。

8. API が予期する ヘッダー を Name:valueの形式で 1 行に 1 つずつ追加します。

   注:

   解決された値は構成済みのヘッダーとして API に送信されるため、これらのシークレットで信頼できるエンドポイントに対してのみ、アセットバック ヘッダーを使用してください。

   シークレットを貼り付ける代わりに、ヘッダーに %ASSETS/AssetName%形式の値を指定します。UiPath は要求を送信する前にサーバーのフォルダー内のアセットに対してこのアドレスを解決し、アセットを読み取れない場合は、未解決のプレースホルダーを転送するのではなく、呼び出しが失敗します。オートコンプリートには、オートメーションと API へのアクセスを許可するアセットのみが表示されます。

9. 必要に応じて、[ ガードレール] を展開して設定します。

10. [追加] を選択します。

結果: UiPath はドキュメントを読み取り、URL を指定した場合はドキュメントを取得し、記述された操作ごとに 1 つのツールを作成します。ドキュメントを読み取れない場合、サーバーは作成されておらず、エラーによって理由が示されます。サーバーの行の [ URL をコピー ] を選択して、そのアドレスを取得します。

https://cloud.uipath.com/{org_name}/{tenant_name}/agenthub_/mcp/{folder_key}/{server_slug}

アセット支援ヘッダーでは、Text、Secret、Bool、Integer、Credential、および Windows Credential アセットがサポートされています。Credential アセットと Windows Credential アセットはパスワードの値に解決されます。Key-Value-List アセットはサポートされていません。1 つのヘッダー値が 1 つの文字列に解決される必要があるためです。

後で API への変更を取得するには、サーバーの [ 更新 ] を選択します。ドキュメントをその URL から再読み取り、ツール リストを再構築します。接続済みのクライアントには、次回リクエストしたときに新しいリストが表示されます。貼り付けたドキュメントから作成されたサーバーには再読み取る URL がないため、最新の状態に保つということは、貼り付けたドキュメントを編集することを意味します。

注:

標準接続では、UiPath が API に対して行う要求には 30 秒のタイムアウトと 1 MiB の応答制限があり、ツール呼び出しは戻るまで開いたままになります。実行時間の長い操作や、大きなペイロードを返す操作は、このサーバーの種類には適していません。

呼び出しは、サーバーの [ 実行 ] タブに表示されます。

呼び出し元の認証方法と必要なアクセス許可については、「 MCP サーバーの認証」をご覧ください。このサーバーの種類と他のサーバーの種類との比較については、「 MCP サーバーの種類」をご覧ください。