uip agenthub mcp-tools と remote-a2a-agent

AgentHub MCP サーバーに接続されたツールを管理する「uip agenthub mcp-tools」と、リモートのエージェント間登録を管理する「uip agenthub remote-a2a-agent」の構文とオプション。

uip agenthub コマンド ファミリの一部です。このページでは、 mcp-tools ( uipath型または platform型 MCP サーバーに接続されているツール) と remote-a2a-agent (MCP サーバーとは無関係のエージェント間の登録) について説明します。共有されている概念 (サーバーの種類、フォルダーのスコープ、入力モード) については、「 uip agenthub 」をご覧ください。

概要

uip agenthub mcp-tools list --mcp <slug> [--name <substr>] [--limit <n>] [--offset <n>]
uip agenthub mcp-tools get --mcp <slug> [<id>] [--name <name>] [--allow-multiple]
uip agenthub mcp-tools create-resource --mcp <slug> --category <category> (--target-name <name> | --target-identifier <guid>) [options...]
uip agenthub mcp-tools create-raw --mcp <slug> --file <path> | --body <json> [options...]
uip agenthub mcp-tools update [<id>] --mcp <slug> [--name <substr>] [--rename <name>] [options...]
uip agenthub mcp-tools delete [<ids...>] --mcp <slug> [--name <substr>] -y
uip agenthub mcp-tools template <resource|raw>
uip agenthub mcp-tools candidates --category <category> [--name <substr>] [--limit <n>] [--offset <n>]
uip agenthub mcp-tools enable --mcp <slug> [--name <name>]...
uip agenthub mcp-tools disable --mcp <slug> [--name <name>]...

uip agenthub remote-a2a-agent list [--name <substr>] [--limit <n>] [--offset <n>]
uip agenthub remote-a2a-agent get <slug>
uip agenthub remote-a2a-agent create --name <name> --slug <slug> [options...]
uip agenthub remote-a2a-agent update <slug> [options...]
uip agenthub remote-a2a-agent delete <slug> -y
uip agenthub remote-a2a-agent refresh-card <slug>

uip agenthub mcp-tools

AgentHub MCP サーバーに接続されているツールを管理します。すべての動詞には、親サーバーを識別するための --mcp <slug> が必要です。ツールを作成するパスには、 create-resource (リソース カタログ サービスを介して既存の Orchestrator プロセス/エージェント/API ワークフローをツールに解決) と create-raw (手書きの JSON ペイロード) の 2 つがあります。どちらも uipathタイプの親サーバーに対してのみ機能します。enable/disable は、 platformタイプのサーバーに固有の別のメカニズムであり、個別のツールリソースを作成するのではなく、そのサーバーの selectedToolNames リストのメンバーシップを切り替えます。

UIP AgentHub MCP-ツールのリスト

オプション

長押し	値 (Value)	説明
--mcp <slug>	string	必須。親 MCP サーバー スラッグ。
--name <substr>	string	名前でフィルター処理: 部分文字列。
--limit <number> / --offset <number>	integer	ページング。

例

uip agenthub mcp-tools list --mcp invoice-mcp

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

{ "Code": "AgentHubMcpToolsList", "Data": { "items": [], "total": 0, "count": 0 } }

uip agenthub mcp-tools get

ID または --name ルックアップで 1 つのツールを取得します。

引数

名前	Required	目的
[id]	×	ツール IDを使用する場合は省略します --name。

オプション

長押し	値 (Value)	説明
--mcp <slug>	string	必須。親 MCP サーバー スラッグ。
--name <name>	string	名前部分文字列で検索。1 つのツール以外のツールに一致すると、 --allow-multiple 合格しない限り失敗します。
--allow-multiple	フラグ	あいまいさで失敗するのではなく、一致するすべての名前を返します。

<id>も --nameも渡さず、 を指すNextCommandヒントが表示されmcp-tools list。

例

uip agenthub mcp-tools get --mcp invoice-mcp tool-1

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

{ "Code": "AgentHubMcpToolsGet", "Data": { "id": "tool-1", "name": "CreateInvoice" } }

uip agenthub mcp-tools create-resource / create-raw

uipath型 MCP サーバーにツールを追加します。親が実際に uipath型されている必要があります — それ以外の場合は、 NextCommand ヒント (実際の型に応じて refresh-tools または mcp-tools enableを指す) で失敗します。

オプション

長押し	値 (Value)	適用対象	説明
--mcp <slug>	string	両方	必須。親 MCP サーバー スラグ ( uipathタイプのサーバーに解決する必要があります)。
--name <name>	string	両方	ツール名。
--description <text>	string	両方	ツールの説明
--target-name <name>	string	create-resource	リソース カタログ サービスを介してターゲットを表示名で解決します。--categoryが必要です。AmbiguousNameが (candidatesのリスト付き) に失敗し、一致が複数ない場合は UnknownTarget として失敗します。
--target-identifier <guid>	GUID	create-resource	明示的なターゲット識別子 — RCS 名解決をスキップします。両方が与えられた場合、 --target-name に勝ちます。
--category <category>	automation|agent|agentic-process|api-workflow	create-resource	RCS エンティティ型/サブタイプのフィルターのペア (automation→Process、 agent→Agent、 agentic-process→ProcessOrchestration、 api-workflow→Api) にマッピングされます。--target-nameで必須です。
--target-folder-key <key> / --target-folder-path <path>	GUID/文字列	両方	MCP サーバー独自のフォルダーと異なる場合に使用されるターゲット リソースのフォルダー。ここでの明示的な値は、常に RCS 候補またはペイロード フィールドから解決された値よりも優先されます。
--input-schema <json> / --output-schema <json> / --metadata <json>	JSON	両方	ツールのスキーマ/メタデータ。呼び出し前に解析可能な JSON 文字列として検証されます。
--continue-on-error (既定) / --fail-fast	フラグ	両方	バッチ失敗動作 (登録されているが、単一ツールでの作成では実行されない)。
--file <path> / --body <json>	パス/JSON	create-raw (必須 — スカラー モードなし)	未加工のツールのペイロード。create-raw には、同等のスカラーフラグ入力モードはありません。 --file/--body がコンテンツ供給の唯一の方法です。
--dry-run	フラグ	両方	API を呼び出さずにミューテーション計画を出力します。

例

uip agenthub mcp-tools create-resource --mcp invoice-mcp --category automation \
  --target-name InvoiceProcess --folder-key f1f2f3f4-0000-0000-0000-000000000001

uip agenthub mcp-tools create-raw --mcp invoice-mcp --file ./tool.json \
  --folder-key f1f2f3f4-0000-0000-0000-000000000001

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

{ "Code": "AgentHubMcpToolsCreate", "Data": { "id": "tool-1", "name": "InvoiceProcess" } }

uip agenthub MCP-tools の更新

uipathタイプのサーバー上の 1 つ以上のツールを (--name一致する--allow-multipleを介して) 更新します。

引数

名前	Required	目的
[id]	×	ツール IDを使用する場合は省略します --name。

オプション

長押し	値 (Value)	説明
--mcp <slug>	string	必須。親 MCP サーバー スラッグ。
--name <substr>	string	Lookup フラグ (更新するツールを選択) — 名前の変更 ではありません 。そのためには、 --rename を使用してください。
--allow-multiple	フラグ	あいまいさで失敗するのではなく、すべての --name 一致に更新を適用します。
--rename <name>	string	新しいツール名。
--description <text> / --target-identifier <guid> / --target-folder-key <key> / --target-folder-path <path> / --input-schema <json> / --output-schema <json> / --metadata <json>	—	上記の [ create-resource/create-raw フィールドと同じセマンティクス。

例

uip agenthub mcp-tools update tool-1 --mcp invoice-mcp --rename CreateInvoice
uip agenthub mcp-tools update --mcp invoice-mcp --name LegacyTool --rename NewTool

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

{ "Code": "AgentHubMcpToolsUpdate", "Data": { "id": "tool-1", "name": "NewTool" } }

単一 ID の更新では 1 つのオブジェクトが返されます。 --allow-multiple を更新すると、 配列が返されます。

uip agenthub mcp-tools 削除

引数

名前	Required	目的
[ids...]	×	ツール IDを使用する場合は省略します --name。

オプション

長押し	説明
--mcp <slug>	必須。親 MCP サーバー スラッグ。
--name <substr>	id ではなく名前の部分文字列で検索します。
--allow-multiple	あいまいさで失敗するのではなく、一致するすべての名前を削除します。
-y, --yes	確認が必要です。CLI はプロンプトを表示しません。
--dry-run	削除せずにミューテーションプランを出力します。

例

uip agenthub mcp-tools delete --mcp invoice-mcp tool-1 -y

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

{ "Code": "AgentHubMcpToolsDelete", "Data": { "ids": ["tool-1"], "deleted": true } }

UIP AgentHub MCP-Tools テンプレート

resource-tool の JSON スケルトンを出力します。フォルダーのオプションはありません。

引数

名前	Required	目的
<kind>	○	resource または raw。

例

uip agenthub mcp-tools template resource

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

{ "Code": "AgentHubMcpToolsTemplate", "Data": { "type": 0, "name": "resource-tool", "processType": "automation", "targetIdentifier": "resource-id", "targetFolderKey": "folder-guid" } }

UIP AgentHub MCP-ツール候補

create-resource --target-name/--target-identifier解決の対象となるリソース カタログ サービス エンティティを 1 つのカテゴリについて一覧表示します。

オプション

長押し	値 (Value)	Required	説明
--category <category>	automation|agent|agentic-process|api-workflow	○	候補のソース カテゴリ。値が見つからないか無効な場合、クライアント側で失敗し、許可されたセットのリストが表示されます。
--name <substr>	string	×	候補者名をフィルター処理します。
--limit <number> / --offset <number>	integer	×	ページング。

RCS.Searchスコープが必要です — 401/invalid-scope エラーには、uip loginを再実行してリトライするように指示が含まれます。

例

uip agenthub mcp-tools candidates --category automation

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

{ "Code": "AgentHubMcpToolsCandidates", "Data": { "items": [], "total": 0, "count": 0, "category": "automation" } }

UIP AgentHub MCP-ツール 有効化/無効化

ツール メンバーシップを platformMCP サーバーの selectedToolNames リストで切り替えます。親サーバーが platform型されていない場合は失敗します。

オプション

長押し	値 (Value)	説明
--mcp <slug>	string	必須。親 MCP サーバーのスラグ ( platform型である必要があります)。
--name <name>	文字列、繰り返し可能	有効化/無効化するツール名です。または、JSON 配列または単一の名前を使用して --file/--body を渡します。
--dry-run	フラグ	API を呼び出さずにミューテーション計画を出力します。

例

uip agenthub mcp-tools enable --mcp orch-mcp --name CreateAsset
uip agenthub mcp-tools disable --mcp orch-mcp --name CreateAsset

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

{ "Code": "AgentHubMcpToolsEnable", "Data": { "slug": "orch-mcp", "selectedToolNames": ["CreateAsset"] } }

disableに相当する Code は AgentHubMcpToolsDisableです。応答には、削除後の selectedToolNames が反映されます。

uip agenthub remote-a2a-agent

リモートのエージェント間 (A2A) 登録の管理 — ソースに「詳細 - Orchestrator UI には公開されていません」と記載されています。 MCP サーバーとは無関係。独自のエージェント カード メタデータ (名前、説明、カード URL、またはカードの生の JSON)、任意の静的ヘッダー、Integration Service のコネクション ID、およびアクティベーション フラグを持ちます。AgentHub の他の部分と同様にフォルダー範囲です。

uip agenthub remote-a2a-agentlist

オプション

長押し	値 (Value)	説明
--name <substr>	string	名前、部分文字列 (サーバー側、 search パラメーター) でフィルター処理します。
--limit <number> / --offset <number>	integer	ページング (top/skip で)。

例

uip agenthub remote-a2a-agent list

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

{ "Code": "AgentHubRemoteA2aAgentList", "Data": { "items": [] } }

uip agenthub remote-a2a-agent get

引数

名前	Required	目的
<slug>	○	エージェント スラッグ。

例

uip agenthub remote-a2a-agent get remote-agent

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

{ "Code": "AgentHubRemoteA2aAgentGet", "Data": { "slug": "remote-agent" } }

uip agenthub remote-a2a-agent 作成

オプション

長押し	値 (Value)	説明
--slug <slug> / --name <name> / --description <text>	string	エージェント ID のフィールド。
--agent-card-url <url>	url	エージェント カードの URL。
--agent-card-json <json>	JSON	URL の代替としての生のエージェント カード JSON。
--header <key=value>	文字列、繰り返し可能	静的な要求ヘッダー。ペイロードの JSON 文字列化 headers 。
--connection-id <id>	string	Integration Service のコネクション ID
--use-relay	フラグ	要求を UiPath Relay 経由でルーティングする
--file <path> / --body <json>	パス/JSON	スカラー フラグの代替手段 — mcp createと同じ相互に排他的な入力モード ルールです。
--dry-run	フラグ	API を呼び出さずにミューテーション計画を出力します。

例

uip agenthub remote-a2a-agent create --name RemoteAgent --slug remote-agent

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

{ "Code": "AgentHubRemoteA2aAgentCreate", "Data": { "slug": "remote-agent" } }

uip agenthub remote-a2a-agent の更新

create と同じフィールド (位置引数である --slugを引いた値)、さらに以下を追加します。

長押し	値 (Value)	説明
--is-active <boolean>	true|false	アクティブ化の状態。その他のリテラル値を引数解析エラーで拒否します。

引数

名前	Required	目的
<slug>	○	エージェント スラッグ。

例

uip agenthub remote-a2a-agent update remote-agent --name RemoteAgent

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

{ "Code": "AgentHubRemoteA2aAgentUpdate", "Data": { "slug": "remote-agent" } }

uip agenthub remote-a2a-agent 削除

引数

名前	Required	目的
<slug>	○	エージェント スラッグ。

オプション

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

例

uip agenthub remote-a2a-agent delete remote-agent -y

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

{ "Code": "AgentHubRemoteA2aAgentDelete", "Data": { "slug": "remote-agent", "deleted": true } }

uip agenthub remote-a2a-agent refresh-card

リモート エージェントのカード メタデータを再取得して更新します。

引数

名前	Required	目的
<slug>	○	エージェント スラッグ。

オプション

長押し	説明
--dry-run	更新せずにミューテーション計画を出力します。

例

uip agenthub remote-a2a-agent refresh-card remote-agent

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

{ "Code": "AgentHubRemoteA2aAgentRefreshCard", "Data": { "slug": "remote-agent" } }

関連

• uip agenthub — 概念とmcp (サーバー登録)。

参照

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