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 Platform の外部でホストされている MCP サーバーに UiPath を接続できます。Orchestrator はプロキシとして機能し、指定した外部 URL に MCP 要求を転送します。

リモート MCP サーバーには、次の 2 つのシナリオがあります。

• 外部で管理されているサードパーティ サービス: パブリック インターネット経由でアクセス可能な Atlassian MCP や Stripe MCP など。
• オンプレミスの MCP サーバー 。受信ポートを開かずに UiPath Cloud からアクセスする必要があります。[ リレー経由で接続 ] オプションをオンにすると、 UiPath リレー はネットワークから UiPath Cloud への長寿命の送信トンネルを確立し、リモート MCP サーバーをリレー 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 サーバーを 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"]
    }
  }
}

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

環境変数とシークレット

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

認証

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

構成

詳細な手順については、「 コマンド MCP サーバーの作成」を参照してください。

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

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

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

動作のしくみ

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

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

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

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

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

環境変数とシークレット

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

認証

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

構成

詳細な手順については、「 コード化された MCP サーバーの作成」を参照してください。実装の詳細と最初のガイドについては、 uipath-mcp のクイック スタートをご覧ください。

セルフホスト MCP サーバー

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

動作のしくみ

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

セルフホスト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

登録が完了すると、サーバーは Orchestrator に表示され、標準の MCP エンドポイント URL を介して到達できます。URL の形式については、「 MCP サーバーの URL を取得する」を参照してください。

認証

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

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

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

サポートされている認証方法と必要なアクセス許可の詳細については、「 MCP サーバー認証」を参照してください。

構成

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