MCP のユース ケースとフロー

パブリックまたはプライベートの外部ツールを UiPath にリモート MCP サーバーとして接続するための設定手順と、それぞれに必要な認証です。

エージェントが必要とするツールの多くは、すでに別の場所、つまりユーザー自身のインフラストラクチャ内で静かに実行されているソフトウェアに存在しています。リモート MCP サーバーを使用すると、これらを MCP ツールとして UiPath に取り込むことができます。これにより、エージェントは、プラットフォーム上にネイティブに構築され、UiPath Platform のガバナンス機能を継承するツールと同じ方法でそれらを検出して呼び出すことができます。

接続方法は、ツールが存在する場所によって異なります。

• インターネット上ですでに公開されている場合は、直接。
• UiPath Relay 経由 (自身のネットワーク内に存在する場合)。

このページでは、両方を、それぞれの設定手順とともに説明します。その他の MCP サーバーの種類 (UiPath、コード、コマンド、セルフホスト) については、「 MCP サーバーの種類」をご覧ください。

ユース ケース

• パートナーの API をオートメーションに取り込む: チームはすでに配送業者や支払いプロバイダーへの API アクセス権を持っています。リモート MCP サーバーとして、エージェントが直接利用することができ、カスタム連携を構築したり保守したりする必要はありません。
• エージェントにすでに必要な SaaS ツールを接続します。一般的なプラットフォームの多くは、独自のパブリック MCP サーバーをパブリッシュしています。一度 Orchestrator に追加すると、そのフォルダーへのアクセス権を持つすべてのエージェントとオートメーションが利用できるようになります。
• インターネットに公開せずに内部システムにアクセスする: チケット システムまたはレガシー サービスは、独自のデータセンター内で実行され、公開することはできません。Relay を使用すると、エージェントは受信ポートを 1 つも開かなくてもツールを呼び出すことができます。

一目でわかる

	ユースケース1:リレー	ユース ケース 2: 直接
最適な用途	独自のネットワークまたはデータセンター内のツール	インターネット上ですでにアクセス可能なツール
追加のセットアップ	Relay Client がネットワークにインストールおよび登録されている	MCP サーバーを追加する以外に何もありません
受信ファイアウォールの変更	なし、Relay は送信専用トンネルを開いたままにします	なし

ユース ケース 1: Relay + OAuth 経由の外部 MCP

要求フロー

シナリオ

エージェントが必要とするツール (ERP、チケット発行システム、レガシ サービス) は、ファイアウォールの背後にある独自のネットワーク内で実行され、パブリック インターネットからはアクセスできません。UiPath エージェントが、カタログ内の他の MCP サーバーを呼び出すのと同じ方法でツールを呼び出すようにし、ツールをインターネットに公開させる必要があります。

アクセス可能性と ID に対処する必要があります。

• パブリック ルートのないホストに到達する場合 - UiPath Relay を介して解決
• 呼び出し元の UiPath ID を証明する - OAuth 動的認証で解決

ツール自体の資格情報は両方から分離されたままです。

ツールがすでにパブリック インターネットからアクセス可能な場合は、Relay は必要ないため、代わりに ユース ケース 2 を使用してください。

コネクションを設定する

前提条件:

• Relay がテナント用にプロビジョニングされ、Relay クライアントがインストールされてネットワークに登録されている。有効化については、 『Relay 管理ガイド 』をご覧ください。
• ユーザーの ID は、MCP サーバーを保持するフォルダーの MCPServers.View 権限を持っています。Automation User ロールと Automation Developer ロールには、このロールが含まれます。
• ツール自体に必要な資格情報 (API キーまたは Integration Service のコネクション) は、そのフォルダーに用意されています。

手順

1. [ MCP サーバー ] ページで、[ MCP サーバーを追加] を選択します。
2. [ リモート ] の種類を選択します。
3. MCP サーバー の名前 を入力します。
4. [説明] を追加します。
5. 接続の種類を [ プライベート (リレー)] に設定します。
6. 認証を設定します。
   • コネクション: 認証トークンの取得に使用する Integration Service のコネクションを選択または追加します。
     
   • 認証トークン: [ヘッダー] セクションに、静的認証トークンを追加します。シークレットをハードコーディングするのではなく、アセットを参照することをお勧めします (例: Authorization: %ASSETS/RemoteBearerToken%)。
     
7. [リモート URL] に、ネットワーク内に表示されるツールのアドレスを入力します。これは、Relay クライアントがすでに到達しているのと同じアドレスです。
8. [追加] を選択します。

呼び出し元を認証する

呼び出し元は、他の MCP サーバーと同じ方法で認証します。つまり、IDE などの対話型クライアントの場合は MCP OAuth フロー 、自動呼び出し元の場合は個人用アクセス トークン、外部アプリケーション、または対話型ログインを使用します。メソッドの完全なマトリクスについては、「 MCP サーバー認証 」をご覧ください。

POST https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folderKey}/{slug}
Authorization: Bearer <token>
Content-Type: application/json

{ "jsonrpc": "2.0", "method": "tools/list", "id": 1 }

サインイン資格情報がツールと共有されることはありません。上記の [ヘッダー ] または [ 接続 ] フィールドから取得した独自の資格情報が、すべての呼び出しで個別に適用されます。

コネクションを確認する

ツールのツールを返す tools/list 呼び出しは、呼び出し元の ID と渡されたツール自身の資格情報の両方を確認します。呼び出しが失敗した場合は、以下を実行します。

• 401 は通常、呼び出し元のトークンを意味します。
• 403 は通常、フォルダーが MCPServers.Viewないことを意味します。
• 502 または 504 は通常、Relay クライアントがオフラインであるか、ツールが自身の資格情報を拒否したことを意味します。

詳細については、「 MCP サーバー認証のトラブルシューティング 」および 「MCP サーバーのトラブルシューティング 」をご覧ください。

ユース ケース 2: 外部 MCP、直接 + OAuth

シナリオ

エージェントが必要とするツールが、パブリック インターネット、SaaS またはパートナーの MCP サーバー、またはユーザーがホストして公開するサーバーにすでに公開されている。エージェントが他の MCP サーバーを呼び出すのと同じ方法で、同じガバナンスと監査証跡を使用して、Relay を必要としないようにする必要があります。

ツールがプライベートまたはオンプレミスの場合は、代わりに ユース ケース 1 を使用します。

コネクションを設定する

前提条件:

• ユーザーの ID は、MCP サーバーを保持するフォルダーの MCPServers.View 権限を持っています。Automation User ロールと Automation Developer ロールには、このロールが含まれます。
• ツール自体に必要な資格情報 (API キーまたは Integration Service のコネクション) は、そのフォルダーに用意されています。

手順

1. [ MCP サーバー ] ページで、[ MCP サーバーを追加] を選択します。
2. [ リモート ] の種類を選択します。
3. MCP サーバー の名前 を入力します。
4. [説明] を追加します。
5. 接続の種類を [ 標準] に設定します。
6. 認証を設定します。
   • コネクション: 認証トークンの取得に使用する Integration Service のコネクションを選択または追加します。
     
   • 認証トークン: [ヘッダー] セクションに、静的認証トークンを追加します。シークレットをハードコーディングするのではなく、アセットを参照することをお勧めします (例: Authorization: %ASSETS/RemoteBearerToken%)。
     
7. [ リモート URL] に、ネットワーク内に表示されるツールのアドレスを入力します。
8. [追加] を選択します。

呼び出し元を認証する

呼び出し元は、他の MCP サーバーと同じ方法で認証します。つまり、IDE などの対話型クライアントの場合は MCP OAuth フロー 、自動呼び出し元の場合は個人用アクセス トークン、外部アプリケーション、または対話型ログインを使用します。メソッドの完全なマトリクスについては、「 MCP サーバー認証 」をご覧ください。

POST https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folderKey}/{slug}
Authorization: Bearer <token>
Content-Type: application/json

{ "jsonrpc": "2.0", "method": "tools/list", "id": 1 }

コネクションを確認する

ツールのツールを返す tools/list 呼び出しにより、接続が機能することを確認します。呼び出しが失敗した場合は、以下を実行します。

• 401 は通常、呼び出し元のトークンを意味します。
• 403 は通常、フォルダーが MCPServers.Viewないことを意味します。
• 502 は通常、ツールにアクセスできないか、ツールが独自の資格情報を拒否したことを意味します。
• 予期されない接続エラーは、通常、アドレスがプライベート ホストまたは内部ホストに解決されることを意味します。代わりにユース ケース 1 に切り替えてください。

詳細については、「 MCP サーバー認証のトラブルシューティング 」および 「MCP サーバーのトラブルシューティング 」をご覧ください。