MCP サーバーの種類

UiPath MCP サーバー

UiPath MCP サーバーは、UiPath の成果物 (RPA ワークフロー、エージェント、API ワークフロー、エージェンティック プロセス、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 上でマスクされます。

認証

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

構成

詳細な手順については、「 リモート 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 のクイック スタートをご覧ください。