UIP AgentHub

「uip agenthub mcp」の構文とオプション - AgentHub MCP サーバーを登録および管理します。コード化されたエージェントとローコード エージェントが呼び出すことができるツールです。

uip agenthub は、 UiPath AgentHub を管理します。MCP (モデル コンテキスト プロトコル) サーバーの登録とそのツールに加え、リモートの A2A (エージェント間) エージェントの登録も行っています。AgentHub MCP サーバーは、名前付きのフォルダー範囲のリソースです。コード化されたエージェントとローコード エージェントに一連の呼び出し可能なツールを公開します。MCP ワイヤ プロトコル自体と混同しないでください。MCP ワイヤ プロトコル自体は、クライアントが実行時に実際にツールを呼び出す方法です。

このリソースは、次の 2 ページにまたがっています。

• このページ — 概念と mcp (MCP サーバーの登録、一覧表示、更新、削除) です。
• mcp-toolsとremote-a2a-agent — MCP サーバーに接続されているツールとリモート A2A エージェントの登録を管理します。

概念

• サーバーの種類は作成時に固定され、作成後は変更できません。型列挙型には 8 つの名前付き型 (uipath、 command、 coded、 selfhosted、 remote、 process-assistant、 platform、 swagger) が存在し、それぞれがワイヤー数値 (それぞれ 0 から 7) にマッピングされています。8 つのうち、mcp create <type>uipath、coded、command、remote、platform、swaggerの 6 つだけです。selfhosted と process-assistant は、 mcp templateの受け入れられた型の型の列挙型に登場し、このコマンド独自のヘルプテキストにも動作例がありますが、ソースのどこにも mcp create selfhosted または mcp create process-assistant サブコマンドが登録されていません。いずれかを試行しても、不明なコマンドとして失敗します。mcp update <slug> サーバーの 既存の 型(APIから取得された)でディスパッチするので、そのようなギャップはありませんが、これら2つのタイプに対して別の方法で作成されたサーバーのみを更新できます。
• フォルダー コンテキスト。AgentHub リソースは Orchestrator フォルダー範囲です。すべての動詞に --folder-key <guid> または --folder-path <path> を渡します。 mcp list はさらに、呼び出し元が参照できるすべてのフォルダー (フォルダーごと、スラッグ + フォルダーによる重複除去、フォルダーごとの失敗 (通常は「そのフォルダーに AgentHub 権限がありません」)、飲み込まれて、リスト全体を中止するのではなく警告として表示される) を列挙する --all-folders も受け入れます。解決可能なフォルダーがない場合は、ネットワーク呼び出しの前にmcp createおよびmcp deleteハード フェイルします。mcp list/mcp getは、mcp list自身の説明にフォルダコンテキストが必要であると記載されているにもかかわらず、これをクライアント側で強制しません—両方を省略しても、サーバー側で失敗する可能性があります。
• 作成/更新時の入力モード: --file、 --body、またはスカラー フラグのいずれか 1 つだけです。複数のソースを渡すと、クライアント側の ConflictingInput エラーになります。「なし」を渡すと MissingInput。--print-schema 、どちらかの動詞を短絡させて、何も書くのではなく、型の予期される JSON 形状を出力します — 手作業で作成する前に、 --file/--body が必要とするものをすばやく確認できます。API を呼び出さずに、解決されたミューテーション プラン (HTTP 動詞、ターゲット、解決されたペイロード) を出力するための短絡を--dry-runします。
• update は、スカラーデフォルトで既存のサーバーにマージされます。 --file/--body 完全に置き換えます。スカラーモードでは、渡すフラグのみが変更され、取得されたサーバーの残りのフィールドは保持されます。--toolを省略するとplatformサーバーの既存のselectedToolNamesも含まれます。type フィールド自体は変更不可能です。--file/--body ペイロードに含めることはクライアント側のエラーであり、サイレントな操作不能ではありません。

概要

uip agenthub mcp list [--type <type>] [--status <s>] [--name <substr>] [--limit <n>] [--offset <n>] [--folder-key <key> | --folder-path <path> | --all-folders]
uip agenthub mcp get <slug> [--folder-key <key> | --folder-path <path>]
uip agenthub mcp create <uipath|coded|command|remote|platform|swagger> [type-specific options] [--file <path> | --body <json> | scalars] [--print-schema] [--dry-run]
uip agenthub mcp update <slug> [type-specific options] [--file <path> | --body <json> | scalars] [--print-schema] [--dry-run]
uip agenthub mcp template <type>
uip agenthub mcp delete <slug> -y [--dry-run]
uip agenthub mcp refresh-tools <slug> --folder-key <key> [--dry-run]

UIP AgentHub MCP のリスト

MCP サーバーの登録のリストを表示します。フィルター (--type、 --status、 --name) とページング (--limit/--offset) はクライアント側で適用されます。基になる API はフラット配列を返すためです。

オプション

長押し	値 (Value)	既定 (Default)	説明
--type <kind>	uipath|command|coded|selfhosted|remote|process-assistant|platform|swagger	—	サーバーの種類でフィルター処理します。無効な値は、API 呼び出しの前にクライアント側で失敗します。
--status <s>	string	—	ステータスでフィルター処理する。生の文字列として数値のステータス列挙型と照合されます。
--name <substr>	string	—	サーバー名での部分文字列の一致は大文字と小文字を区別しません。
--limit <number>	integer	50	ページ サイズ
--offset <number>	integer	0	行のオフセット。
--folder-key <key>	GUID	—	Orchestrator のフォルダー。--all-foldersと相互に排他的です。
--folder-path <path>	string	—	フォルダーの表示名または完全修飾パスです。Orchestrator SDK を介してキーに解決されます。
--all-folders	フラグ	無効	呼び出し元が参照できるすべてのフォルダーを列挙します。--folder-key/--folder-pathと相互に排他的です。
--login-validity <minutes>	integer	—	この呼び出しの対話型ログイン トークンの有効期間を上書きします。

例

uip agenthub mcp list --folder-path Shared --type uipath --name invoice

データシェイプ(--output json)

{
  "Code": "AgentHubMcpList",
  "Data": {
    "items": [{ "slug": "invoice-mcp", "name": "Invoice MCP", "type": 0, "status": 0 }],
    "total": 1,
    "count": 1
  }
}

UIP AgentHub MCP Get

正規スラッグで 1 つの MCP サーバーを取得します。名前検索のフォールバックはありません — mcp listから正確なスラッグを渡します。

引数

名前	Required	目的
<slug>	○	正規の MCP サーバー スラッグ。

オプション

長押し	値 (Value)	説明
--folder-key <key> / --folder-path <path>	GUID/文字列	フォルダー コンテキスト。
--login-validity <minutes>	integer	トークンの有効期間の上書き。

例

uip agenthub mcp get invoice-mcp

データシェイプ(--output json)

{ "Code": "AgentHubMcpGet", "Data": { "slug": "invoice-mcp", "name": "Invoice MCP", "type": 0 } }

UIP AgentHub MCP の作成

MCP サーバーを作成します。型につき 1 つのサブコマンド — uipath、coded、command、remote、platform、swagger (列挙型に存在するものの、createリーフに機能しない 2 つの型名については、「概念」をご覧ください)。6 つすべてが --name、 --slug (既定ではスラッグ化された --name)、 --description、 --version、さらに --file/--body/--print-schema/--dry-run とフォルダー オプションを共有します。解決可能なフォルダーが必要です。そうでない場合は、ネットワーク呼び出しの前に失敗します。

種類固有のオプション

入力	追加オプション	備考
uipath	なし	ペイロード: { server: {name, slug, description, version}, tools: [] }。ツールは後から mcp-toolsを介して追加されます。
coded	--process-key <key>	Orchestrator プロセスによって動作します。--folder-key は、ペイロードの folderKeyを兼ねます。
command	--command <cmd>、 --arg <arg> (反復可能)、 --env <key=value> (反復可能)	ローカル バイナリを起動します。arguments は結合された --arg リスト (スペース区切り) です。 environmentVariables は、 --env ペアから構築される JSON 文字列化オブジェクトです。
remote	--uri <uri>、 --header <key=value> (繰り返し可能)、 --use-relay	headers は、 --header ペアの JSON 文字列化されたオブジェクトです。
platform	--service <name>、 --tool <name> (繰り返し可能)	ペイロードは、 serverの下にスカラーを入れ子にし、そばに selectedToolNames を追加します。
swagger	--spec-url <url>、 --use-relay、 --filter <expr> (反復可能、予約済み)	Swagger 固有の別の API エンドポイントを使用して作成します。

例

uip agenthub mcp create uipath --name InvoiceMcp --slug invoice-mcp
uip agenthub mcp create command --name LocalMcp --slug local-mcp --command npx --arg @some/server
uip agenthub mcp create remote --name RemoteMcp --slug remote-mcp --uri https://example/mcp

データシェイプ(--output json)

{ "Code": "AgentHubMcpCreate", "Data": { "slug": "invoice-mcp", "name": "InvoiceMcp" } }

--print-schema は、何も作成するのではなく、型の JSON スキーマを含む Code: "AgentHubMcpTemplate" を返します。--dry-run は、解決されたミューテーション プランを含む Code: "DryRun" を返します。

UIP AgentHub MCP の更新

MCP サーバーを更新します。サーバーの 既存の 型によるディスパッチ (最初にフェッチされる) — ターゲットの実際の型に関係なく、 create と同じ型固有のオプションがすべて update に登録されますが、取得された型に関連するもののみがマージされます。

引数

名前	Required	目的
<slug>	○	正規の MCP サーバー スラッグ。

オプション

createと同じ種類固有のフラグ (--name、 --description、 --version、 --process-key、 --command、 --arg、 --env、 --uri、 --header、 --use-relay、 --service、 --tool、 --spec-url)、さらに --file/--body/--print-schema/--dry-run およびフォルダー オプションがあります。type は不変です。 --file/--body ペイロードに含めると、クライアント側のエラーになります。

例

uip agenthub mcp update invoice-mcp --name InvoiceMcp

データシェイプ(--output json)

{ "Code": "AgentHubMcpUpdate", "Data": { "slug": "invoice-mcp", "name": "InvoiceMcp" } }

UIP AgentHub MCP テンプレート

1 つのサーバーの種類に対して、すぐに編集できる JSON スケルトンを出力します。これは、コネクタに依存しない静的な参照コマンドです (フォルダー オプションは一切ありません)。

引数

名前	Required	目的
<type>	○	uipath、coded、command、selfhosted、remote、process-assistant、platform、swaggerのいずれか (8 つすべて、作業中のcreateリーフがない 2 つを含む)。swagger-mcp も受け入れられ、 swaggerに正規化されます。

例

uip agenthub mcp template uipath

データシェイプ(--output json)

{ "Code": "AgentHubMcpTemplate", "Data": { "server": { "name": "uipath-mcp", "description": "", "version": "1.0.0", "isActive": true }, "tools": [] } }

UIP AgentHub MCP の削除

スラッグで MCP サーバーを削除します。破壊的 — -y/--yesが必要です。解決可能なフォルダーが必要です。

引数

名前	Required	目的
<slug>	○	正規の MCP サーバー スラッグ。

オプション

長押し	説明
-y, --yes	確認が必要です。CLI はプロンプトを表示しません。
--dry-run	削除せずにミューテーションプランを出力します。

例

uip agenthub mcp delete invoice-mcp -y

データシェイプ(--output json)

{ "Code": "AgentHubMcpDelete", "Data": { "slug": "invoice-mcp", "deleted": true } }

uip agenthub mcp refresh-tools

サーバーのツールをライブ ソース (プロセスのスキーマ、リモート/Swagger エンドポイントなど) から再派生させます。

引数

名前	Required	目的
<slug>	○	正規の MCP サーバー スラッグ。

オプション

長押し	説明
--folder-key <key> / --folder-path <path>	1 つは必須です 。更新エンドポイントはフォルダー スコープです (/mcp/{folderKey}/{slug}/refresh-tools)。両方を見逃すと、検索の前に明示的なエラーが発生して失敗します。
--dry-run	更新せずにミューテーション計画を出力します。

動作はサーバーの種類によって異なります。coded/command 更新では、非同期runtimeId (HTTP 202、status: "Started") が返されます。remote/swagger/platform同期更新 (status: "Refreshed"、 toolCount)。uipath サーバーと selfhosted サーバーはローカルで拒否されます。mcp-tools create-resourceを指すNextCommandヒントが表示されます。

例

uip agenthub mcp refresh-tools remote-mcp --folder-key f1f2f3f4-0000-0000-0000-000000000001

データシェイプ(--output json)

{ "Code": "AgentHubMcpRefreshTools", "Data": { "status": "Refreshed", "toolCount": 3 } }

非同期 (202) 応答は、代わりに { "runtimeId": "...", "status": "Started" }を返します。

関連

• mcp-toolsとremote-a2a-agent — サーバー上のツールとリモート A2A エージェントの登録を管理します。

参照

• グローバル オプション
• 終了コード