- スタート アップ ガイド
- ベスト プラクティス
- テナント
- デプロイ レジストリ
- 通知
- フォルダー コンテキスト
- プロセス
- ジョブ
- Apps (アプリ)
- トリガー
- ログ
- 監視
- インデックス
- キュー
- アセット
- コネクション
- ビジネス ルール
- ストレージ バケット
- Agent Gateway
- Orchestrator のテスト
- リソース カタログ サービス
- Integrations
- トラブルシューティング
MCP サーバー認証
UiPath MCP サーバーでは、すべての HTTP 要求で認証が必要です。セッションベースの認証の繰り越しはありません。MCP セッションが確立された後でも、以降のすべての要求に有効な Authorization: Bearer <token> ヘッダーを含める必要があります。
mcp-session-id ヘッダーは、MCP プロトコルの状態管理専用です。これは認証メカニズムではありません。
認証方法
UiPath MCP サーバーにアクセスするためのトークンを取得するには、次の 4 つの方法があります。
| メソッド | トークンのソース | 必要なスコープと権限 |
|---|---|---|
| MCP の OAuth フロー | 自動、IDE で処理 | 検出フローによって処理されます |
| 個人用アクセス トークン (PAT) | UiPath Cloud UI | Orchestrator リソースから [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 クレーム) の照合を強制します。