UIP-Agenthub

Syntax und Optionen für „uip agenthub mcp“, das AgentHub-MCP-Server registriert und verwaltet – die Tools, die codierte und Low-Code-Agents aufrufen können.

uip agenthub verwaltet UiPath AgentHub: MCP-Serverregistrierungen (Model Context Protocol) und deren Tools sowie Remote-A2A-Agent-zu-Agent-Registrierungen. Ein AgentHub-MCP-Server ist eine benannte, ordnerbezogene Ressource, die eine Reihe von aufrufbaren Tools für codierte und Low-Code-Agents bereitstellt – nicht zu verwechseln mit dem MCP-Dropdownprotokoll selbst, mit dem ein Client diese Tools zur Runtime tatsächlich aufruft.

Diese Ressource umfasst zwei Seiten:

• Diese Seite – Konzepte und mcp (MCP-Server registrieren, auflisten, aktualisieren, löschen).
• mcp-tools und remote-a2a-agent – verwalten die an einen MCP-Server angehängten Tools und Remote-Registrierungen von A2A-Agents.

Konzepte

• Der Servertyp wird bei der Erstellung festgelegt und ist danach unveränderlich. In der Typaufzählung sind acht benannte Typen vorhanden (uipath, command, coded, selfhosted, remote, process-assistant, platform, swagger), die jeweils einem numerischen Verbindungenwert zugeordnet sind ( 0–7). Nur sechs der acht haben ein funktionierendes mcp create <type> -Blatt: uipath, coded, command, remote, platform, swagger. selfhosted und process-assistant werden in der Typeaufzählung in den akzeptierten Typen von mcp template angezeigt und haben sogar funktionierte Beispiele im eigenen Hilfetext dieses Befehls – aber es ist kein mcp create selfhosted oder mcp create process-assistant Unterbefehl in der Quelle registriert . Entweder schlägt der Versuch als unbekannter Befehl fehl. mcp update <slug> wird nach dem vorhandenen Typ des Servers verteilt (abgerufen von der API), sodass er keine solche Lücke aufweist – aber er kann nur einen Server aktualisieren, der auf andere Weise für diese beiden Typen erstellt wurde.
• Ordnerkontext. AgentHub-Ressourcen sind auf Orchestrator-Ordner beschränkt. Übergeben Sie --folder-key <guid> oder --folder-path <path> für jedes Verb; mcp list akzeptiert zusätzlich --all-folders, um jeden Ordner aufzulisten, den der Aufrufer sehen kann (Ordner für Ordner, dedupliziert durch slug+Ordner, mit Fehlern pro Ordner – am häufigsten „keine AgentHub-Berechtigung in diesem Ordner“ – verspätet und als Warnungen aufgetaucht, anstatt die gesamte Liste abzubrechen). mcp create und mcp delete schlagen vor jedem Netzwerkaufruf fehl, wenn kein Ordner auflösbar ist; mcp list/mcp get erzwingen diese Clientseite nicht, obwohl die eigene Beschreibung von mcp list besagt, dass ein Ordnerkontext erforderlich ist – das Auslassen von beiden dort schlägt wahrscheinlich immer noch auf der Serverseite fehl.
• Eingabemodi beim Erstellen/Aktualisieren: genau eines von --file, --body oder skalaren Flags. Das Übergeben von mehr als einer Quelle ist ein clientseitiger ConflictingInput -Fehler; keines übergeben wird MissingInput. --print-schema schließt eines der Verben kurz, um die erwartete JSON-Form des Typs auszugeben, anstatt etwas zu schreiben – eine schnelle Möglichkeit, zu sehen, was --file/--body benötigt, bevor es von Hand autorisiert wird. --dry-run -Kurzverbindungen zum Ausgeben des aufgelösten Migrationsplans (HTTP-Verb, Ziel, aufgelöste Nutzlast), ohne die API aufzurufen.
• update wird standardmäßig mit dem vorhandenen Server zusammengeführt; --file/--body wird vollständig ersetzt. Im Skalarmodus ändern sich nur die Flags, die Sie übergeben – die restlichen Felder des abgerufenen Servers werden beibehalten, einschließlich des vorhandenen selectedToolNames eines platform -Servers, wenn --tool weggelassen wird. Das Feld type selbst ist unveränderlich: Das Einfügen in eine --file/--body -Nutzlast ist ein clientseitiger Fehler und kein stiller No-Op.

Zusammenfassung

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-Liste

Listen Sie MCP-Serverregistrierungen auf. Filter (--type, --status, --name) und Paginierung (--limit/--offset) werden clientseitig angewendet, da die zugrunde liegende API ein flaches Array zurückgibt.

Optionen

Long	Wert	Standard	Beschreibung
--type <kind>	uipath|command|coded|selfhosted|remote|process-assistant|platform|swagger	–	Filtern Sie nach Servertyp. Ungültige Werte schlagen auf der Clientseite vor einem API-Aufruf fehl.
--status <s>	string	–	Nach Status filtern. Als Rohzeichenfolge mit der numerischen Statusaufzählung abgeglichen.
--name <substr>	string	–	Groß-/Kleinschreibung der Teilzeichenfolgeübereinstimmung beim Servernamen wird nicht berücksichtigt.
--limit <number>	Integer	50	Seitengröße.
--offset <number>	Integer	0	Zeilen-Offset.
--folder-key <key>	GUID	–	Orchestrator-Ordner. Sich gegenseitig mit --all-folders ausschließen.
--folder-path <path>	string	–	Anzeigename des Ordners oder vollqualifizierter Pfad, der über das Orchestrator SDK in einen Schlüssel aufgelöst wird.
--all-folders	Markieren	aus	Listen Sie jeden Ordner auf, den der Anrufer sehen kann. Sich gegenseitig mit --folder-key/--folder-path ausschließen.
--login-validity <minutes>	Integer	–	Überschreiben Sie die Lebensdauer des interaktiven Anmeldetokens für diesen Aufruf.

Beispiel

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

Datenform (--output json)

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

UIP AgentHub-MCP-Get

Rufen Sie einen MCP-Server durch kanonische Slug ab. Kein Fallback für die Namenssuche – übergeben Sie die genaue Slug von mcp list.

Argumente

Name	Erforderlich	Zweck
<slug>	ja	kanonische MCP-Server-Slug.

Optionen

Long	Wert	Beschreibung
--folder-key <key> / --folder-path <path>	GUID/Zeichenfolge	Ordnerkontext.
--login-validity <minutes>	Integer	Überschreibung der Token-Lebensdauer.

Beispiel

uip agenthub mcp get invoice-mcp

Datenform (--output json)

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

uip agenthub mcp erstellen

Erstellen Sie einen MCP-Server. Ein Unterbefehl pro Typ – uipath, coded, command, remote, platform, swagger (siehe Konzepte für die beiden Typnamen, die in der Aufzählung vorhanden sind, aber kein create -Arbeitsblatt haben) . Alle sechs teilen sich --name, --slug (standardmäßig ein slugifiziertes --name), --description, --version sowie --file/--body/--print-schema/--dry-run und Ordneroptionen. Erfordert einen auflösbaren Ordner – schlägt andernfalls vor jedem Netzwerkaufruf fehl.

Typspezifische Optionen

Typ	Zusätzliche Optionen	Hinweise
uipath	keine	Nutzlast: { server: {name, slug, description, version}, tools: [] }. Tools werden anschließend über mcp-tools hinzugefügt.
coded	--process-key <key>	Unterstützt durch einen Orchestrator-Prozess. --folder-key dient gleichzeitig als folderKey der Nutzlast.
command	--command <cmd>, --arg <arg> (wiederholbar), --env <key=value> (wiederholbar)	Startet eine lokale Binärdatei. arguments ist die verbundene --arg -Liste (durch Leerzeichen getrennt); environmentVariables ist ein JSON-String-Objekt, das aus --env -Paaren erstellt wurde.
remote	--uri <uri>, --header <key=value> (wiederholbar), --use-relay	headers ist ein JSON-stringified Objekt aus --header Paaren.
platform	--service <name>, --tool <name> (wiederholbar)	Nutzlast verschachtelt Skalare unter server, selectedToolNames daneben.
swagger	--spec-url <url>, --use-relay, --filter <expr> (wiederholbar, reserviert)	Erstellt über einen separaten Swagger-spezifischen API-Endpunkt.

Beispiele

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

Datenform (--output json)

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

--print-schema gibt Code: "AgentHubMcpTemplate" mit dem JSON-Schema des Typs zurück, anstatt etwas zu erstellen. --dry-run gibt Code: "DryRun" mit dem aufgelösten Migrationsplan zurück.

UIP AgentHub-MCP-Aktualisierung

Aktualisieren Sie einen MCP-Server. Versand nach dem vorhandenen Typ des Servers (zuerst abgerufen) – Dieselben typspezifischen Optionen wie create werden alle auf update registriert, unabhängig vom echten Typ des Ziels, aber nur diejenigen, die für den abgerufenen Typ relevant sind, werden zusammengeführt.

Argumente

Name	Erforderlich	Zweck
<slug>	ja	kanonische MCP-Server-Slug.

Optionen

Die gleichen typspezifischen Flags wie create (--name, --description, --version, --process-key, --command, --arg, --env, --uri, --header, --use-relay, --service, --tool, --spec-url) sowie --file/--body/--print-schema/--dry-run und Ordneroptionen. type ist unveränderlich – Das Einschließen in eine --file/--body -Nutzlast ist ein clientseitiger Fehler.

Beispiel

uip agenthub mcp update invoice-mcp --name InvoiceMcp

Datenform (--output json)

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

UIP AgentHub-MCP-Vorlage

Geben Sie ein sofort bearbeitungsfähiges JSON-Framework für einen Servertyp aus – einen statischen, Connector-unabhängigen Referenzbefehl (überhaupt keine Ordneroptionen).

Argumente

Name	Erforderlich	Zweck
<type>	ja	Eine von uipath, coded, command, selfhosted, remote, process-assistant, platform, swagger (alle 8, einschließlich der beiden ohne create -Arbeitsblatt). swagger-mcp wird ebenfalls akzeptiert, normalisiert zu swagger.

Beispiel

uip agenthub mcp template uipath

Datenform (--output json)

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

UIP AgentHub-MCP-Löschen

Löschen Sie einen MCP-Server per Slug. Destruktiv – erfordert -y/--yes. Erfordert einen auflösbaren Ordner.

Argumente

Name	Erforderlich	Zweck
<slug>	ja	kanonische MCP-Server-Slug.

Optionen

Long	Beschreibung
-y, --yes	Zur Bestätigung erforderlich. Die CLI fordert Sie nie auf.
--dry-run	Drucken Sie den Migrationsplan aus, ohne zu löschen.

Beispiel

uip agenthub mcp delete invoice-mcp -y

Datenform (--output json)

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

UIP AgentHub-MCP-Aktualisierungstools

Leiten Sie die Tools eines Servers erneut von seiner Livequelle ab (Schema eines Prozesses, ein Remote-/Swagger-Endpunkt usw.).

Argumente

Name	Erforderlich	Zweck
<slug>	ja	kanonische MCP-Server-Slug.

Optionen

Long	Beschreibung
--folder-key <key> / --folder-path <path>	Eine ist erforderlich – der Aktualisierungsendpunkt hat einen Ordner-Scope (/mcp/{folderKey}/{slug}/refresh-tools). Das Fehlen von beiden schlägt mit einem expliziten Fehler vor jeder Suche fehl.
--dry-run	Drucken Sie den Migrationsplan ohne Aktualisierung aus.

Verhalten unterscheidet sich je nach Servertyp: coded/command Aktualisierungen geben ein asynchrones runtimeId (HTTP 202, status: "Started") zurück; remote/swagger/platform synchron aktualisieren (status: "Refreshed", toolCount); uipath und selfhosted -Server werden lokal abgelehnt – ihre Tools werden manuell erstellt, nicht abgeleitet – mit einem NextCommand -Hinweis, der auf mcp-tools create-resource verweist.

Beispiel

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

Datenform (--output json)

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

Asynchrone (202) Antworten geben stattdessen { "runtimeId": "...", "status": "Started" } zurück.

Zugehörig

• mcp-tools und remote-a2a-agent – verwalten Sie Tools auf einem Server und Remote-Registrierungen von A2A-Agents.

Siehe auch

• Globale Optionen
• Exitcodes