個人用アクセス トークンを使用して認証する

個人用アクセス トークン (PAT) は、有効期間を設定可能 (最大 1 年) を持つ、ユーザー範囲のトークンです。対話型ログインよりも有効期間の長いトークンが必要な場合や、対話型ログインuipath auth実行できないがユーザーとして認証する必要がある場合に便利です。

PAT を作成する際は、 Orchestrator API アクセス リソースから、必要な MCP 操作をカバーする権限を選択する必要があります。

前提条件

• MCP サーバーを含むフォルダーで、 Automation User、 Automation Developer、または Folder Administrator のロールを持っている。これらのロールには、 MCPServers.View 権限が含まれます。

個人用アクセス トークンを生成する

1. UiPath に移動し、ユーザー アイコンを選択して [ 設定] を選択します。

2. [個人用アクセス トークン] に移動し、[新しいトークンを生成] を選択します。

3. 名前と有効期限を入力します。

4. [ スコープ] で、[ Orchestrator API アクセス ] リソースから以下の権限を選択します。

   • OR.Execution: ツールを一覧表示するために必要です。MCP サーバーは Orchestrator ListReleases API を呼び出してプロセス メタデータを解決し、そのエンドポイントにはこのスコープが必要です。
   • OR.Jobs: ツールの実行に必要です。プロセスをツール (UiPath、Coded、Command) として実行するすべての種類の MCP サーバーは、このスコープを必要とする Orchestrator StartJobs API を呼び出します。

5. [ 保存 ] を選択し、トークンをすぐにコピーします。

   重要:

   トークンは一度だけ表示されます。ここでコピーしない場合は、新しいトークンを生成する必要があります。

結果

トークンは、MCP サーバーへの HTTP 要求の Authorization ヘッダーで使用できるようになりました。

個人用アクセス トークンを使用する

トークンを使用して MCP サーバーを呼び出すには:

curl -X POST "https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folderKey}/{slug}" \
  -H "Authorization: Bearer <your-PAT>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{...},"id":1}'

トークンの特性

• オーディエンス UiPath.Orchestratorを持つ不透明なトークン。
• 設定可能な有効期限 (最大 1 年)。
• アクセス権は、PAT スコープとユーザーのフォルダー レベルのロール権限の共通部分です。
• 任意のHTTPクライアント(cURL、Postman、MCP Inspector、カスタムコード)で動作します。

制限事項

• PAT は特定のユーザー ID に関連付けられます。ユーザーが非アクティブ化されると、PAT は機能を停止します。
• PAT は、UiPath への対話型アクセス権を持つユーザーのみが作成できます。
• Integration Service アクティビティでは PAT 認証はサポートされていません。MCP 接続は成功しますが、Integration Service のコネクションに依存するツール呼び出しは失敗します。