対話型ログイン(CLI)による認証

対話型ログインは、MCPサーバーをテストするために迅速にアクセスする必要があるローカルで作業する開発者向けに設計されています。このメソッドのクライアントは、開発マシン上で実行される UiPath CLI (uipath コマンド ライン ツール) です。

[ uipath auth] を実行すると、CLI によって既定のブラウザーが UiPath Cloud のログイン ページを開きます。認証後、CLI は結果のベアラー トークンを現在のディレクトリの .env ファイルに保存します。次に、このトークンを MCP サーバー エンドポイントへの HTTP 要求の Authorization ヘッダーに含めます。

対話型ログインは、次のシナリオに適しています。

• MCPサーバーのローカル開発とテスト。
• cURL、Postman、または MCP Inspector を使用したクイック API テスト。
• 完全なユーザー権限での MCP ツール呼び出しのデバッグ。
• ターミナルに人間の開発者が待機するあらゆるシナリオ

無人シナリオや自動化されたシナリオには適していません。その場合は、代わりに 外部アプリケーション を使用します。IDE 統合の場合は、 MCP OAuth フローを使用します。

前提条件

• UiPath CLI が開発マシンにインストールされます。
• MCP サーバーを含むフォルダーに、 Automation User、 Automation Developer、または Folder Administrator ロールを持つアカウントがあります。

MCP サーバーを認証して呼び出す

1. UiPath への認証:

   uipath auth
   

   CLI は、デフォルトのブラウザを開きます。UiPath Cloud にログインして認証を完了します。CLI は、生成されたベアラー トークンを現在のディレクトリ内の .env ファイルに UIPATH_ACCESS_TOKENとして保存します。

2. トークンをシェル環境にエクスポートします。

   export UIPATH_ACCESS_TOKEN=$(grep UIPATH_ACCESS_TOKEN .env | cut -d= -f2)
   

3. エクスポートされたトークンを使用して MCP サーバーを呼び出します。

   curl -X POST "https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folderKey}/{slug}" \
     -H "Authorization: Bearer $UIPATH_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}},"id":1}'
   

結果の

MCP サーバーはトークンを検証し、 initialize 要求に応答します。その後、すべての要求で同じ Authorization ヘッダーを使用して後続の MCP プロトコルメッセージを送信できます。

トークンの特性

• 型： Jwt
• 対象ユーザー: OrchestratorApiUserAccessを含む
• 発行者： UiPath Identity Server ({env}.uipath.com/identity_)
• 有効期限: 1 時間新しいトークンを取得するための自動更新、再実行 uipath auth はありません。

トークンは以下を付与します。

• ログイン ユーザーがロールを割り当てられているすべてのフォルダーへのアクセス権です。
• ユーザーがこれらのフォルダーで持つすべての権限 (ロールから継承)。
• Integration Service アクティビティとの相互運用性 (ユーザー コンテキストが存在)。

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

この認証方法は、すべての種類の MCP サーバー (UiPath、コード、コマンド、セルフホスト、リモート、プラットフォーム) で機能します。