MCP 接続について

MCP 接続: 共有の既定の接続またはユーザー単位の接続を使用して、リモート MCP サーバーを外部サービスに対して認証します。

MCP 接続は、 リモート MCP サーバー がプロキシする外部サーバーへの送信呼び出しを認証するために使用する Integration Service の接続です。リモート サービスに対して接続を一度認可してから、リモート MCP サーバーに接続します。コネクションは特定の URL に関連付けられているため、URL が一致するサーバーでのみ使用できます。

呼び出し時に、Orchestrator は接続から新しいアクセス トークンを要求し、 Authorization ヘッダーでリモート サーバーに送信します。資格情報は Integration Service のコネクションによって保持され、MCP サーバーは資格情報への参照のみを格納し、トークンやパスワード自体は保存しません。

UiPath ベアラー トークンがリモート サーバーに転送されることはありません。リモート サーバーは、コネクションまたはカスタム ヘッダーによって提供された資格情報のみを参照するため、UiPath ID がプラットフォーム外に出ることはありません。設定手順については、「 リモート MCP サーバーを作成する 」および 「MCP 接続を管理する」をご覧ください。

リモート MCP サーバーによるアウトバウンドの認証方法

リモート MCP サーバーでは、プロキシするエンドポイントへの認証方法が 3 つサポートされています。適切な設定は、リモート サービスが呼び出されることを予期する方法によって異なります。

メソッド	設定方法	該当する場合
アウトバウンド認証なし	ヘッダーとコネクションはどちらも空のままにします。	リモート サーバーが開いているか、ここで指定する必要のないメカニズムを使用して認証します。
カスタム ヘッダー	サーバーに追加されたヘッダー行です (例: Authorization: Bearer ... 、 X-Api-Key: ...)。Orchestrator のアセット参照では、値をプレーン テキスト ( など) に格納することを避け Authorization: %ASSETS/MyApiKey%。	リモート サービスは、静的トークンまたは API キーを使用します。
MCP 接続	サーバーに接続された Integration Service のコネクション (全ユーザーの既定またはユーザー アカウントごとの既定)。	リモート サービスで OAuth を使用するか、複数のユーザーが自身の資格情報を使用して操作する必要があります。

接続がアタッチされると、すべての呼び出しに Authorization ヘッダーが提供されます。その場合、カスタム ヘッダーで設定されている Authorization ヘッダーは無視されるため、接続のトークンのみが送信されます。アセットバッキング ヘッダーについて詳しくは、「 MCP サーバーで Orchestrator アセットを使用する」をご覧ください。

既定のコネクションとユーザーごとのコネクション

リモート MCP サーバーでは、次の 2 つのレベルでコネクションを使用できます。

• 既定の接続: サーバー上に設定され、それを呼び出すすべてのユーザーが共有する単一の接続です。既定として機能するのは、共有フォルダーのコネクションのみです。接続が MCP サーバーとは異なるフォルダーにある場合、呼び出し元は両方のフォルダーにアクセスする必要があります。
• ユーザーごとのコネクション: 個々のユーザー アカウントにマッピングされるコネクションです。ユーザーがサーバーを呼び出すと、既定の接続ではなく独自の接続が使用されます。ユーザーごとのコネクションは、共有フォルダーまたはそのユーザーの個人用ワークスペースから開始できます。

呼び出し時に、UiPath は次の順序でコネクションを選択します。

1. 呼び出し元自身のユーザーごとのコネクション (設定されている場合)。
2. サーバーの既定の接続です。
3. コネクションなし。UiPath はカスタム ヘッダーにフォールバックするか、設定されていない場合は認証を送信しません。

1 つの共有 ID がすべての呼び出し元にサービスを提供する場合は、既定の接続で十分です。ユーザー単位の接続は、各ユーザーがリモート サービスに対して自分自身として動作する必要がある場合に適しています。

接続ステータス

[ ユーザー アカウントごとの接続 ] ページには、構成されている各ユーザーのステータスが表示され、そのユーザーの呼び出しが認証されるかどうかが一目でわかります。

ステータス	意味	解決方法
アクティブ	接続が認可され、準備が整います。このユーザーからの呼び出しはそれを使用します。	必要ありません。
認証が必要	このユーザーに使用可能なコネクションがありません。何も設定されていないか、ユーザー自身のコネクションを再認証する必要があります。	ユーザーまたは管理者がこのユーザーのコネクションを追加または再接続します。
利用不可	共有されている既定の接続が見つからないか、無効化されているか、期限切れになっているか、または到達できません。	管理者がサーバーの既定の接続を修正または置換します。
非アクティブ	サーバーがアクティブでないか、接続が無効になっています。	サーバーがアクティブ化されているか、Integration Service でコネクションが有効化されている。

コネクションを設定および検証する手順については、「 MCP コネクションを管理する」をご覧ください。

コネクションとコネクションの種類

[リモート MCP サーバー] フォームには 2 つの設定があり、名前は似ていますが、目的が異なります。

• コネクションは 認証です: このページで説明されているように、リモート サーバーへの認証に使用される Integration Service のコネクションです。
• 接続の種類は ネットワーク ルーティングです。 標準 はパブリック インターネット経由でリモート サーバーに直接アクセスし、 プライベート (Relay) は受信ポートを開かずに UiPath Relay を介してオンプレミスのサーバーに接続します。

[接続の種類] は、送信される資格情報には影響しません。