Ground-to-Cloud の認証

MCP サーバーがローカルで ( uipath runを使用して) 実行される場合、認証は 2 つの別々のレイヤーで行われます。

• クラウドへのランタイム: ローカル ランタイムは、MCP サーバーをクラウドに登録できるように認証します。
• クラウドへのクライアント: 外部クライアントは、クラウドに面した MCP サーバー エンドポイントを呼び出すときに認証します。

レイヤー 1: ランタイムからクラウドへ (サーバー登録)

uipath run コマンドには、MCP サーバーをクラウドに登録するための独自のトークンが必要です。これは開発者の認証であり、サーバーをローカルで実行している人の身元です。

# Authenticate the runtime — interactive login
uipath auth

# Or authenticate the runtime — client credentials
uipath auth --client-id "..." \
  --client-secret "..." \
  --base-url "https://cloud.uipath.com/{org}/{tenant}" \
  --scope "OR.Default"

# Start the local server
uipath run mcp-server

ランタイムは、このトークンを使用してクラウドへの SignalR 接続を確立し、サーバーのツールを登録します。

レイヤー 2: クライアントからクラウドへ (サーバーを呼び出す)

外部クライアント (MCP Inspector、cURL、IDE、任意の HTTP クライアントなど) は、「 MCP サーバー認証」で説明されている 4 つの標準方法のいずれかを使用してクラウドに対して認証します。URL は、他の MCP サーバーと同じです。

https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folderKey}/{slug}

要求の流れ

クライアントのベアラー トークンがローカル ランタイムに到達することはありません。クラウドはトークンを検証し、Redis を介して MCP プロトコル メッセージのみを転送します。ローカル ランタイムと MCP サーバー プロセスにはトークンが表示されません。

適用可能な MCP サーバーの種類

地上からクラウドへの認証は、ローカルランタイムを持つMCPサーバータイプに適用されます。

• セルフホスト: 常にローカルで実行され、常に地上からクラウドへの認証を使用します。
• コード化 および コマンド: 開発中に uipath run を介してローカルで実行する場合は、グラウンドからクラウドへの認証を使用します。Orchestrator にデプロイした後は、クラウド ジョブとして実行され、ローカル ランタイムは関与しません。

ローカル サーバーを使用したクライアント資格情報

uipath runでクライアント資格情報を使用する場合は、UIPATH_FOLDER_KEY 環境変数を設定します。Python SDK の GetFoldersForCurrentUser 呼び出しは、クライアント資格情報をサポートしていません。詳しくは、「 既知の制限事項: GetFoldersForCurrentUser」をご覧ください。