Hub d’agent de l’IU

Syntaxe et options pour `uip agenthub MCP`, qui enregistre et gère les serveurs MCP AgentHub — les outils codés et les agents low-code peuvent appeler.

uip agenthub gère UiPath AgentHub: enregistrements de serveurs MCP et leurs outils, plus les enregistrements d’agents A2A à distance. Un serveur MCP AgentHub est une ressource nommée dans l'étendue du dossier qui expose un ensemble d'outils appelables aux agents codés et low-code — à ne pas confondre avec le protocole fil MCP lui-même, qui est la façon dont un client invoque concrètement ces outils au moment du Runtime.

Cette ressource s'étend sur deux pages:

• Cette page — concepts et mcp (enregistrer, répertorier, mettre à jour, supprimer des serveurs MCP).
• mcp-tools et remote-a2a-agent — gérez les outils liés à un serveur MCP et les enregistrements d'agents A2A à distance.

Concepts

• Le type de serveur est corrigé lors de la création et immuable par la suite. huit types nommés existent dans l’enum de type (uipath, command, coded, selfhosted, remote, process-assistant, platform, swagger), chacun mappé à une valeur de fil numérique ( 0 à 7 respectivement). Seuls six d'entre eux ont une feuille mcp create <type> active: uipath, coded, command, remote, platform, swagger. selfhosted et process-assistant apparaissent dans l'enum de type, dans les types acceptés de mcp template, et ont même fonctionné dans le propre texte d'aide de cette commande - mais aucune sous-commande mcp create selfhosted ou mcp create process-assistant n'est enregistrée nulle part dans la source . Toute tentative échoue en tant que commande inconnue. mcp update <slug> est envoyé par le type existant du serveur (extraire de l'API), il n'a donc pas cet écart, mais il ne peut mettre à jour qu'un serveur qui a été créé d'une autre manière pour ces deux types.
• Contexte du dossier. Les ressources AgentHub sont limitées au dossier d'Orchestrator. Transmettez --folder-key <guid> ou --folder-path <path> sur chaque verbe; mcp list accepte en outre --all-folders pour énumérer chaque dossier que l’appelant peut voir (dossier par dossier, désélectionné par champ de données dynamique + dossier, avec des échecs par dossier — le plus souvent "aucune autorisation AgentHub dans ce dossier" — avalé et apparaissant comme des avertissements plutôt que d'abandonner la liste entière). mcp create et mcp delete échouent définitivement avant tout appel réseau si aucun dossier ne peut être résolu; mcp list/mcp get n'appliquent pas cette politique côté client, même si la description de mcp list indique qu'un contexte de dossier est requis; le fait d'omettre les deux à ce stade échoue toujours côté serveur.
• Modes d'entrée lors de la création/mise à jour: exactement l'un des indicateurs --file, --body ou scalaires. La transmission de plusieurs sources est une erreur ConflictingInput côté client; en passant aucun est MissingInput. --print-schema raccourcit l'un ou l'autre des verbes pour imprimer la forme JSON attendue du type au lieu d'écrire n'importe quoi — un moyen rapide de voir ce dont --file/--body a besoin avant de l'écrire par la main. --dry-run raccourcit pour imprimer le plan de transformation résolu (verbe HTTP, cible, charge utile résolue) sans appeler l'API.
• update fusionne sur le serveur existant par défaut scalaire; --file/--body remplace entièrement. En mode scalaire, seuls les indicateurs que vous transmettez sont modifiés - le reste des champs du serveur récupéré est conservé, y compris un selectedToolNames existant pour un serveur platform lorsque --tool est omis. Le champ type lui-même est immuable: son utilisation dans une charge utile --file/--body est une erreur côté client, et non une erreur de validation silencieuse.

Synthèse

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]

Hub d'agent UiP - Liste MCP

Répertorie les enregistrements de serveurs MCP. Les filtres (--type, --status, --name) et la pagination (--limit/--offset) sont appliqués côté client, car l'API sous-jacente renvoie un tableau plate.

Options

Long	Valeur (Value)	Default	Description
--type <kind>	uipath|command|coded|selfhosted|remote|process-assistant|platform|swagger	—	Filtrez par type de serveur. Les valeurs non valides échouent côté client avant tout appel d'API.
--status <s>	string	—	Filtrez par statut. Correspondance avec l’enum de statut numérique sous la forme d’une chaîne brute.
--name <substr>	string	—	Correspondance de sous-chaîne insensible à la casse sur le nom du serveur.
--limit <number>	Integer	50	Taille de la page.
--offset <number>	Integer	0	Décalage de la ligne.
--folder-key <key>	GUID	—	Dossier Orchestrator. Capture mutuellement exclusive avec --all-folders.
--folder-path <path>	string	—	Nom complet du dossier ou chemin complet, résolu en une clé via le SDK Orchestrator.
--all-folders	Drapeau	désactivé	Énumérez chaque dossier que l'appelant peut voir. Capture mutuellement exclusive avec --folder-key/--folder-path.
--login-validity <minutes>	Integer	—	Remplacez la durée de vie du jeton de connexion interactive pour cet appel.

Exemple

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

Format des données (--sortie json)

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

Obtenir le MCP uip agenthub

Obtenez un serveur MCP par champ de données dynamique. Aucune solution de secours pour la recherche de noms: saisissez le champ de données dynamique exact à partir de mcp list.

Arguments

Nom	Requis	Objectif
<slug>	oui	Champ de données dynamique du serveur MCP.

Options

Long	Valeur (Value)	Description
--folder-key <key> / --folder-path <path>	GUID/chaîne	Contexte du dossier.
--login-validity <minutes>	Integer	Remplacement de la durée de vie du jeton.

Exemple

uip agenthub mcp get invoice-mcp

Format des données (--sortie json)

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

Création MCP uip agenthub

Créez un serveur MCP. Une sous-commande par type — uipath, coded, command, remote, platform, swagger (voir Concepts pour les deux noms de type qui existent dans l'enum mais n'ont pas de feuille create de travail) . Les six partagent les options --name, --slug (par défaut, --name), --description, --version, plus --file/--body/--print-schema/--dry-run et les options de dossier. Nécessite un dossier résolvable — échoue avant tout appel réseau dans le cas contraire.

Options spécifiques au type

Saisie de texte	Options supplémentaires	Remarques
uipath	aucun	Charge utile: { server: {name, slug, description, version}, tools: [] }. Les outils sont ajoutés ensuite via mcp-tools.
coded	--process-key <key>	Soumis à un processus Orchestrator. --folder-key se double de folderKey de la charge utile.
command	--command <cmd>, --arg <arg> (répétable), --env <key=value> (répétable)	Lance un fichier binaire local. arguments correspond à la liste --arg jointe (séparée par des espaces); environmentVariables est un objet sous forme de chaîne JSON créé à partir de --env paires.
remote	--uri <uri>, --header <key=value> (répétable), --use-relay	headers est un objet basé sur une chaîne de caractères JSON de --header paires.
platform	--service <name>, --tool <name> (répétable)	La charge utile imbrique les scalateurs sous server, selectedToolNames à côté.
swagger	--spec-url <url>, --use-relay, --filter <expr> (répétable, réservé)	Crée via un point de terminaison d'API spécifique à Swagger distinct.

Exemples

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

Format des données (--sortie json)

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

--print-schema renvoie Code: "AgentHubMcpTemplate" avec le schéma JSON du type au lieu de créer quoi que ce soit. --dry-run renvoie Code: "DryRun" avec le plan de migration résolu.

Mise à jour MCP uip agenthub

Mettre à jour un serveur MCP Répartition par le type existant du serveur (récupéré en premier) — les mêmes options spécifiques au type que create sont toutes enregistrées sur update quel que soit le type réel de la cible, mais seules celles pertinentes pour le type récupéré sont fusionnées.

Arguments

Nom	Requis	Objectif
<slug>	oui	Champ de données dynamique du serveur MCP.

Options

Mêmes indicateurs spécifiques au type que create (--name, --description, --version, --process-key, --command, --arg, --env, --uri, --header, --use-relay, --service, --tool, --spec-url), plus --file/--body/--print-schema/--dry-run et les options de dossier. type est immuable - l'inclure dans une charge utile --file/--body est une erreur côté client.

Exemple

uip agenthub mcp update invoice-mcp --name InvoiceMcp

Format des données (--sortie json)

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

Modèle MCP uip agenthub

Émettez un squelette JSON prêt à modifier pour un type de serveur — une commande de référence statique indépendante du connecteur (aucune option de dossier du tout).

Arguments

Nom	Requis	Objectif
<type>	oui	L’un des uipath, coded, command, selfhosted, remote, process-assistant, platform, swagger (l’ensemble des 8, y compris les deux sans feuille create active). swagger-mcp est également accepté, normalisé à swagger.

Exemple

uip agenthub mcp template uipath

Format des données (--sortie json)

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

Suppression MCP uip agenthub

Supprimez un serveur MCP par champ de données dynamique. Destructeur — nécessite -y/--yes. Nécessite un dossier résolvable.

Arguments

Nom	Requis	Objectif
<slug>	oui	Champ de données dynamique du serveur MCP.

Options

Long	Description
-y, --yes	Requis pour confirmer. La CLI ne s’affiche jamais.
--dry-run	imprimez le plan de évolution sans le supprimer.

Exemple

uip agenthub mcp delete invoice-mcp -y

Format des données (--sortie json)

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

Outils d’actualisation MCP uip agenthub

Récupérez les outils d'un serveur à partir de sa source active (schéma d'un processus, point de terminaison distant/swagger, etc.).

Arguments

Nom	Requis	Objectif
<slug>	oui	Champ de données dynamique du serveur MCP.

Options

Long	Description
--folder-key <key> / --folder-path <path>	Un est requis , — le point de terminaison de réactualisation est à l'échelle du dossier (/mcp/{folderKey}/{slug}/refresh-tools). L'absence des deux échoue avec une erreur explicite avant toute recherche.
--dry-run	imprimez le plan de migration sans actualiser.

Le comportement diffère par le type de serveur: codedstatus: "Started" command actualise le fichier runtimeId asynchrone; remote/swagger/platform actualiser de manière synchrone (status: "Refreshed", toolCount); Les serveurs uipath et selfhosted sont rejetés localement - leurs outils sont créés manuellement, et non dérivés - avec une suggestion NextCommand pointant vers mcp-tools create-resource

Exemple

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

Format des données (--sortie json)

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

Les réponses asynchrones (202) renvoient plutôt { "runtimeId": "...", "status": "Started" }.

Associé

• mcp-tools et remote-a2a-agent — gérez les outils sur un serveur et les enregistrements d'agents A2A à distance.

Voir également

• Options globales
• Codes de sortie