UiPath Documentation
orchestrator
latest
false
Orchestrator ユーザー ガイド
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。 新しいコンテンツの翻訳は、およそ 1 ~ 2 週間で公開されます。

MCP サーバー認証

UiPath MCP サーバーでは、すべての HTTP 要求で認証が必要です。セッションベースの認証の繰り越しはありません。MCP セッションが確立された後でも、以降のすべての要求に有効な Authorization: Bearer <token> ヘッダーを含める必要があります。

mcp-session-id ヘッダーは、MCP プロトコルの状態管理専用です。これは認証メカニズムではありません。

認証方法​

UiPath MCP サーバーにアクセスするためのトークンを取得するには、次の 4 つの方法があります。

メソッドトークンのソース必要なスコープと権限
MCP の OAuth フロー自動、IDE で処理検出フローによって処理されます
個人用アクセス トークン (PAT)UiPath Cloud UIOrchestrator リソースから [OR.JobsしてOR.Execution] を選択します。
外部アプリケーション外部Apps>管理アプリで OR.Execution と OR.Jobs を設定します。トークンの要求時に、ルーティング動作を制御するための OR.Default を含めます。
対話型ログイン (CLI)uipath auth CLI コマンドログイン時に自動的に付与されます

各メソッドをどのような場合に使用するか​

適切な方法は、サインイン時に人間が存在するかどうか、および MCP サーバーが Integration Service のコネクタを公開するかどうかによって異なります。

シナリオ推奨される方法備考
IDE (VS Code、GitHub Copilot) を使用するMCP の OAuth フローIDE では、検出、ログイン、トークンの更新が自動的に処理されます。MCP サーバーの URL 以外に構成するものはありません。
自動化または無人のワークロード (CI/CD パイプライン、サービス アカウント、マイクロサービス、長期実行プロセス)外部アプリケーション - アプリケーション スコープユーザーの操作なしで動作する唯一の方法です。最も簡単な設定の OR.Default をリクエストしてください。
サードパーティ アプリ (Copilot Studio、ChatGPT) から接続する外部アプリケーション - ユーザー スコープユーザー スコープを使用して機密アプリを作成し、サードパーティ アプリの OAuth 設定を手動で構成して、ユーザーにアプリ経由でログインしてもらいます。
デスクトップまたはモバイルの MCP クライアントを構築する外部アプリケーション - PKCE を使用する非機密アプリクライアント シークレットの漏洩は一切なく、PKCE によって認可コード フローが保護されます。ユーザーがブラウザーからログインすると、アプリはユーザーに代わってトークンを受け取ります。
ローカルでの開発またはテスト (人間が存在する)対話型ログイン (CLI) または 個人用アクセス トークン対話型ログインに必要なコマンドは 1 つで、フォルダーのアクセス許可が継承されます。トークンの持続時間は 1 時間です。PAT の有効期限は最大 1 年まで設定可能で、任意の HTTP クライアントで機能します。
MCP サーバーは Integration Service のアクティビティを使用しますMCP の OAuth フロー、 対話型ログイン、外部 アプリケーション - ユーザー スコープIntegration Service のアクティビティにはユーザー コンテキストが必要です。PAT とクライアント資格情報は MCP サーバーに接続しますが、Integration Service でサポートされるツールの呼び出しはタイムアウトします。

一般的な要件​

選択した認証方法に関係なく、以下の要件が適用されます。

すべての要求を認証する必要があります​

セッションの繰越はありません。すべての HTTP 要求には、有効な Authorization: Bearer <token> ヘッダーを含める必要があります。mcp-session-id ヘッダーは、MCP プロトコル状態専用です。

URL 形式​

MCP サーバーのエンドポイント URL は常に次の形式です。

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

場所:

  • {org}: UiPath の組織名
  • {tenant}: テナント名
  • {folderKey}: フォルダーの GUID (フォルダー名やパスではない)
  • {slug}: MCP サーバーの URL スラグ

最小フォルダー権限​

認証された ID (ユーザーまたは外部アプリ) には、MCP サーバーを含むフォルダーで MCPServers.View 権限が必要です。この権限は、 Automation User、 Automation Developer、および Folder Administrator のロールに含まれています。

コード化されたサーバーとコマンド サーバーに対する追加の権限​

コード化された MCP サーバーとコマンド MCP サーバーは、Orchestrator のジョブを実行します。ID には、 Jobs.Create 権限も必要です。この権限は、 Automation User ロールと Automation Developer ロールに含まれています。

Integration Service の制限事項​

MCP サーバーが Integration Service アクティビティによって動作するツールを公開する場合、ユーザー コンテキスト認証のみが機能します (対話型ログイン または MCP OAuth フロー)。

PAT と外部アプリ クライアント資格情報は MCP サーバーに接続しますが、Integration Service で動作するツールの呼び出しはタイムアウトします。

トークンの検証​

UiPath MCP サーバーは、次のスキームを使用してトークンを順番に検証します。最初の試合が勝利します。

スキームオーディエンス使用者
ロボットのアクセス トークンOrchestratorロボット実行トークン
Identity OAuth アクセス トークンOrchestratorApiUserAccess対話型ログイン
Identity 個人用アクセス トークンUiPath.Orchestrator個人用アクセス トークン、外部アプリケーション トークン、MCP OAuth フロー トークン

すべてのスキームは、要求 URL から組織に対して署名の検証、発行者の検証、オーディエンスの検証、有効期限の検証、およびパーティション ID (prt_id クレーム) の照合を強制します。

このページは役に立ちましたか?

接続

ヘルプ リソース サポート(opens in new window)

学習する UiPath アカデミー(opens in new window)

質問する UiPath フォーラム(opens in new window)

最新情報を取得