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

MCP サーバーの種類

UiPath MCP サーバー​

UiPath MCP サーバーは、UiPath の成果物 (RPA ワークフロー、エージェント、API ワークフロー、Maestro の BPMN プロセス、Integration Service アクティビティ) を MCP ツールとして公開します。オートメーション ロジックが UiPath にすでに存在しており、AI モデルが利用できるようにする必要がある場合に使用します。

この種類のサーバーは UiPath Platform 内で直接構築および管理されるため、Orchestrator を通じたネイティブ連携、簡素化されたデプロイ、一元的なガバナンスを提供します。

動作のしくみ​

構成はすべて Orchestrator のフォルダー範囲の [MCP サーバー ] タブで行います。ユーザーは、ツールとして公開する成果物を選択し、サーバーを保存します。パッケージ化、コード、外部プロセスは不要です。

設定が完了すると、標準の UiPath MCP サーバー URL を介してサーバーにアクセスできるようになります。URL の形式については、「 MCP サーバーの URL を取得する」をご覧ください。

認証​

UiPath MCP サーバーは、標準の MCP サーバー認証モデルを使用します。サポートされている方法と必要な権限の詳細については、「 MCP サーバーの認証」をご覧ください。

もう 1 つ制約が適用されます。 Integration Service アクティビティ によってサポートされるツールには、ユーザー コンテキスト トークンが必要です。これらのツールは、対話型ログインまたは MCP OAuth フローでは機能しますが、個人用アクセス トークンや外部アプリケーションのクライアント資格情報では使用できません。

構成​

ステップバイステップの手順については、「 UiPath MCP サーバーを作成する」をご覧ください。

リモート MCP サーバー​

リモート MCP サーバーを使用すると、UiPath は UiPath Platform の外部でホストされている MCP サーバーに接続できます。Orchestrator はプロキシとして機能し、指定した外部 URL に MCP 要求を転送します。

リモート MCP サーバーは、次の 2 つのシナリオに対応します。

  • 外部で管理されるサードパーティ サービス (Atlassian MCP や Stripe MCP など) はパブリック インターネット経由でアクセスできます。
  • 受信ポートを開かずに UiPath Cloud からアクセスする必要があるオンプレミスの MCP サーバー。[ Relay 経由で接続 ] オプションをオンにすると、 UiPath Relay はユーザーのネットワークから UiPath Cloud への有効期間の長い送信トンネルを確立し、リモート MCP サーバーは Relay URL に対して構成されます。VPN、公開、受信接続は必要ありません。

どちらのシナリオでも、リモートエンドポイントはStreamable HTTPを読み上げる必要があります。

動作のしくみ​

構成は Orchestrator で行います。リモート URL と、オプションのカスタム HTTP ヘッダーのセットを指定します。UiPath のパッケージ、コード、プロセスは一切関与しません。

ツールが呼び出されると、Orchestrator は設定されているカスタム ヘッダーとともにリモート URL に呼び出しを転送します。ベアラー トークンを含む UiPath 固有のヘッダーはリモート サーバーに転送されないため、UiPath ID がリモート サーバーに到達することはありません。secret、api_key、token などの用語を含む値を持つカスタム ヘッダーは、保存後に UI 上でマスクされます。

カスタム ヘッダー値では、 %ASSETS/AssetName% 構文を使用して Orchestrator のアセットを参照できます。リモート MCP サーバーは、要求を転送する前に Orchestrator アセット API を介してこれらの参照を解決します。ロボットやロボットのキーは必要ありません。詳しくは、「 MCP サーバーで Orchestrator のアセットを使用する」をご覧ください。

認証​

リモート MCP サーバーは、標準の MCP サーバー認証モデルを使用します。サポートされている 4 つの認証方法はすべてこの種類で機能します。詳しくは、「 MCP サーバーの認証」をご覧ください。

構成​

ステップバイステップの手順については、「 リモート MCP サーバーを作成する」をご覧ください。

プラットフォーム MCP サーバー​

注:

この機能はプレビュー版です。

プラットフォーム MCP サーバーは、選定された一連の MCP ツールとしてファーストパーティの UiPath サービスを公開します。サービスの API が提供するすべての操作を公開するのではなく、どの操作をツールにするかを選択すると、その選択はサーバーに保存されます。モデルが UiPath サービスに直接アクセスする必要があり、管理者がどの操作をスコープに設定するかを正確に決定する必要がある場合に使用します。

以下のサービスが利用可能です。

  • Test Manager: プロジェクト内のテストのライフサイクルです。要件、テスト ケースとそのステップ、テスト セット、実行、実行ログなどがあります。これは、「Test Manager」、「Test Manager External」、「Test Manager Performance Testing」の 3 つのエントリとして表示され、最後のエントリにはパフォーマンス シナリオ、負荷グループ、実行レポートが記載されています。
  • ケース管理コントロール: 単一のケース インスタンスへの読み取り専用アクセス権 (変数、最新の実行状態、ケース計画、ケース プラン、ケースが実行されるルールを含む)。
  • Docs AI: UiPath 製品ドキュメントを検索します。1 つのツールは AI が生成した引用付きの回答を返し、別のツールは一致するドキュメント チャンクを返し、3 つ目のツールは以前の回答に対するフィードバックを送信します。

動作のしくみ​

構成は Orchestrator で行います。サービスを選択し、その操作を選択します。リストはカテゴリ別にグループ化されているため、関連する操作が一緒に表示されます。サービスで提供されるすべての操作 (後で追加した操作を含む) を公開するには、代わりに [すべてのツール ] を有効化します。パッケージ、コード、プロセスは一切関与しません。

UiPath がサービスに対して行う要求には 30 秒のタイムアウトがあり、ツール呼び出しは戻るまで開いたままになります。呼び出しはサーバーの [ 実行 ] タブに表示され、トレース コンテキストはサービスに引き継がれます。

認証​

プラットフォーム MCP サーバーは、標準の MCP サーバー認証モデルを使用します。詳しくは、「 MCP サーバーの認証」をご覧ください。

構成​

ステップバイステップの手順については、「 プラットフォーム MCP サーバーを作成する」をご覧ください。

Swagger MCP サーバー​

注:

この機能はプレビュー版です。

Swagger MCP サーバーは、OpenAPI ドキュメントを MCP ツールに変換します。ドキュメントを指定すると、ドキュメントで説明されている各操作が、サーバーが HTTP 経由で呼び出すツールになります。UiPath のファーストパーティ サービスではなく、独自の MCP サーバーを持たない API に使用します。

すでに MCP を話しているものをプロキシするリモート MCP サーバーとは異なり、Swagger MCP サーバーは、そうでない API に MCP レイヤーを提供します。固定されたリストから UiPath サービスを開始するプラットフォーム MCP サーバーとは異なり、Swagger MCP サーバーは、ユーザーが指定した任意の OpenAPI ドキュメントから開始します。

動作のしくみ​

Orchestrator で設定するには、ドキュメントの URL を指定するか、ドキュメント自体を貼り付けます。他の種類のサーバーと同じ %ASSETS/AssetName% 構文を使用して、API が予期する任意の HTTP ヘッダーを追加し、シークレットを構成に含めないようにします。プライベート ネットワーク上の API の場合は、Relay を介して接続します。

標準接続では、UiPath が API に対して行う要求には 30 秒のタイムアウトと 1 MiB の応答制限があります。

認証​

Swagger MCP サーバーは、標準の MCP サーバー認証モデルを使用します。詳しくは、「 MCP サーバーの認証」をご覧ください。

構成​

ステップバイステップの手順については、「 Swagger MCP サーバーを作成する」をご覧ください。

コマンド MCP サーバー​

コマンド MCP サーバーを使用すると、UiPath は、プラットフォームでサポートされているコマンドを使用して、NPM (npx) や PyPI (uvx) などの外部パッケージ フィードから既存の MCP サーバーを連携できます。これを使用すると、既存の MCP サーバーやサードパーティの MCP サーバーを実行でき、UiPath の成果物として再パッケージ化される必要がありません。

動作のしくみ​

コマンド MCP サーバーは UiPath サーバーレス上で実行され、Python サーバーと JavaScript/Node.js MCP サーバーの両方をサポートします。各サーバーはジョブごとに 1 つのセッションを維持し、ジョブの最大実行時間は 15 分です。

Orchestrator で構成するには、 コマンドとその引数を指定します。UiPath のパッケージ、コード、プロセスの定義は不要です。構成は、エントリとして mcp.json ファイルに保存されます。以下に例を示します。

{
  "servers": {
    "filesystem-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    }
  }
}
{
  "servers": {
    "filesystem-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    }
  }
}

コマンド MCP サーバーは、コード化された MCP サーバーやセルフホスト MCP サーバーと同じ実行時および構成形式を共有します。詳しくは、「 MCP サーバー共有基盤」をご覧ください。

環境変数とシークレット​

環境変数は Orchestrator の MCP サーバー上で直接設定し、暗号化されて保存されます。%ASSETS/AssetName%構文を使用してシークレットの管理のために Orchestrator アセットを参照できます。詳しくは、「 MCP サーバーで Orchestrator のアセットを使用する」をご覧ください。

認証​

コマンド MCP サーバーは、標準の MCP サーバー認証モデルを使用します。ツールの呼び出しごとにサーバーレス ジョブが開始されるため、呼び出し元には MCPServers.View 権限と Jobs.Create 権限の両方が必要です。詳しくは、「 MCP サーバーの認証」をご覧ください。

構成​

ステップバイステップの手順については、「 コマンド MCP サーバーを作成する」をご覧ください。

コード化された MCP サーバー​

コード化された MCP サーバーは、mcp Python パッケージの FastMCP フレームワークを使用して記述された Python MCP サーバーであり、パッケージ化され、UiPath NuGet 成果物 (.nupkg) として Orchestrator にパブリッシュされます。uipath-mcp ライブラリは、サーバーを UiPath Platform と連携するランタイム レイヤーを提供します。

この種類は、カスタム MCP サーバーを UiPath 上で構築およびホストし、UiPath のパッケージ管理システムを通じてコードを保存、バージョン管理、配布する必要がある場合に使用します。

動作のしくみ​

コード化された MCP サーバーは UiPath サーバーレス上で実行されます。各サーバーはジョブごとに 1 つのセッションを維持し、ジョブの最大実行時間は 15 分です。アクティブなツールの呼び出しには約 3.5 分の接続タイムアウトが適用され、アイドル状態のセッションは約 6 分から 7 分間非アクティブ状態が続くと終了します。

コード化された MCP サーバーをデプロイするには、 uipath-mcp CLI を使用してサーバー コードをパックし、Orchestrator にパブリッシュします。その後、コード化された MCP サーバーを、Orchestrator でパッケージがデプロイされているフォルダーと同じフォルダーに構成します。サーバーは、 mcp.json エントリによって参照されます。

{
  "servers": {
    "math-server": {
      "type": "stdio",
      "command": "python",
      "args": ["server.py"]
    }
  }
}
{
  "servers": {
    "math-server": {
      "type": "stdio",
      "command": "python",
      "args": ["server.py"]
    }
  }
}

コマンド MCP サーバーと同様に、コード化されたサーバーも mcp.json エントリによって定義されます。違いは、コード化されたサーバーでは、外部フィードからパッケージをプルするのではなく、Orchestrator にパブリッシュされた UiPath NuGet 成果物のコードを実行する点です。

コード化された MCP サーバーは、コマンド MCP サーバーやセルフホスト MCP サーバーと同じランタイム、構成形式、トランスポートを共有します。詳しくは、「 MCP サーバー共有基盤」をご覧ください。

環境変数とシークレット​

コード化された MCP サーバーの場合、MCP サーバー エンティティ自体には環境変数は設定されません。代わりに、Orchestrator のプロセスの設定>環境変数に設定され、暗号化されて保存されます。%ASSETS/AssetName%構文を使用してシークレットの管理のために Orchestrator アセットを参照できます。詳しくは、「 MCP サーバーで Orchestrator のアセットを使用する」をご覧ください。

認証​

コード化された MCP サーバーは、標準の MCP サーバー認証モデルを使用します。ツールの呼び出しごとにサーバーレス ジョブが開始されるため、呼び出し元には MCPServers.View 権限と Jobs.Create 権限の両方が必要です。詳しくは、「 MCP サーバーの認証」をご覧ください。

構成​

ステップバイステップの手順については、「 コード化された MCP サーバーを作成する」をご覧ください。実装の詳細とはじめにガイドについては、「 uipath-mcp クイック スタート」をご覧ください。

セルフホスト MCP サーバー​

セルフホスト MCP サーバーは、ユーザー、ローカル マシン、オンプレミス サーバー、またはプライベート クラウド環境によって制御されるインフラストラクチャ上で実行されると同時に、ガバナンスと検出性のために UiPath に接続します。MCP サーバーが、クラウド インフラストラクチャからアクセスできないローカル リソースにアクセスする必要がある場合、またはポリシーによりランタイムを顧客所有のハードウェア上に存在させる必要がある場合に使用します。

動作のしくみ​

セルフホスト MCP サーバーは、Orchestrator の UI を使用して設定できません。代わりに、ローカルで起動すると、それ自体が UiPath に登録されます。コード化された MCP サーバーやコマンド MCP サーバーとは異なり、セルフホスト ランタイム インスタンスは複数の同時セッションをサポートし、複数のセッションが同じスラッグに接続されている場合はランダムに分散されます。サーバーのライフサイクルは完全にユーザーが制御します。

セルフホスト MCP サーバーは、コマンド MCP サーバーやコード化された MCP サーバーと同じランタイム、構成形式、トランスポートを共有します。詳しくは、「 MCP サーバー共有基盤」をご覧ください。

サーバーを登録する​

サーバーを起動する前に、ランタイムはサーバーをどの Orchestrator フォルダーに登録するかを知る必要があります。認証方法に応じて、次の 2 つの登録パスがサポートされています。

  • 対話型認証 (uipath authの場合) では、フォルダー パスに UIPATH_FOLDER_PATH が設定されます。ランタイムによって自動的にフォルダー キーに解決されます。
  • クライアント資格情報認証の場合: フォルダー解決 API はクライアント資格情報をサポートしないため、 UIPATH_FOLDER_KEY はフォルダー GUID に直接設定されます。

登録コマンドの例

# Interactive auth
export UIPATH_FOLDER_PATH=<your-folder-path>
uipath run my-mcp

# Client-credential auth
export UIPATH_FOLDER_KEY=<your-folder-key>
uipath run my-mcp
# Interactive auth
export UIPATH_FOLDER_PATH=<your-folder-path>
uipath run my-mcp

# Client-credential auth
export UIPATH_FOLDER_KEY=<your-folder-key>
uipath run my-mcp

登録が完了すると、サーバーが Orchestrator に表示され、標準の MCP エンドポイント URL を介してアクセスできるようになります。URL の形式については、「 MCP サーバーの URL を取得する」をご覧ください。

認証​

セルフホスト MCP サーバーでは、認証は次の 2 つのレイヤーで動作します。

  • 開発者の uipath auth トークン (またはクライアント資格情報) でランタイムが登録されます。
  • 呼び出し元のベアラー トークンは、各ツール呼び出しを認証します。

呼び出し元のトークンがローカル ランタイムに到達することはありません。UiPath はこれをクラウドで検証し、MCP プロトコル メッセージのみを転送します。

サポートされている認証方法と必要な権限について詳しくは、「 MCP サーバーの認証」をご覧ください。

構成​

実装の詳細とはじめにガイドについては、「 uipath-mcp クイック スタート」をご覧ください。

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

接続

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

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

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

最新情報を取得