AgentHub de UIP

Sintaxis y opciones para `uip agenthub mcp`, que registra y gestiona los servidores MCP de AgentHub: las herramientas a las que pueden llamar los agentes codificados y de bajo código.

uip agenthub los registros del servidor UiPath AgentHub: MCP (Protocolo de contexto de modelo) y sus herramientas, además de los registros de agente remotos A2A (agente a agente). Un servidor MCP de AgentHub es un recurso con nombre y ámbito de carpeta que expone un conjunto de herramientas invocables a agentes codificados y de código bajo, que no debe confundirse con el propio protocolo de conexión MCP, que es la forma en que un cliente invoca realmente esas herramientas en runtime.

Este recurso abarca dos páginas:

• Esta página : conceptos y mcp (registrar, enumerar, actualizar, eliminar servidores MCP).
• mcp-tools y remote-a2a-agent : gestiona las herramientas adjuntas a un servidor MCP y los registros de agentes A2A remotos.

Conceptos

• El tipo de servidor se fija en la creación y es inmutable después. Existen ocho tipos con nombre en el tipo enum (uipath, command, coded, selfhosted, remote, process-assistant, platform, swagger), cada uno asignado a un valor de conexión numérico ( 0–7 respectivamente). Solo seis de los ocho tienen una hoja mcp create <type> en funcionamiento: uipath, coded, command, remote, platform, swagger. selfhosted y process-assistant aparecen en el enum de tipo, en los tipos aceptados de mcp template, e incluso tienen ejemplos trabajados en el propio texto de ayuda de este comando, pero no hay ningún subcomando mcp create selfhosted o mcp create process-assistant registrado en ningún lugar en el origen . Intentar cualquiera de los dos falla como comando desconocido. mcp update <slug> se envía por el tipo existente del servidor (obtenido de la API), por lo que no hay tal brecha, pero solo puede actualizar un servidor que se creó de alguna otra manera para esos dos tipos.
• Contexto de la carpeta. Los recursos de AgentHub tienen un ámbito de carpeta de Orchestrator. Omitir --folder-key <guid> o --folder-path <path> en cada verbo; mcp list acepta además --all-folders para enumerar todas las carpetas que puede ver la persona que llama (carpeta por carpeta, deduplicadas por slug+folder, con fallos por carpeta; más comúnmente "sin permiso de AgentHub en esa carpeta" — tragado y aparecían como advertencias en lugar de abortar toda la lista). mcp create y mcp delete fallan antes de cualquier llamada de red si no se puede resolver ninguna carpeta; mcp list/mcp get no aplican este lado del cliente aunque la propia descripción de mcp list diga que se requiere un contexto de carpeta; omitir ambos probablemente aún falle en el lado del servidor.
• Modos de entrada en crear/actualizar: exactamente uno de --file, --body o marcadores escalares. Pasar más de un origen es un error ConflictingInput del lado del cliente; pasar none es MissingInput. --print-schema cortocircuita cualquier verbo para imprimir la forma JSON esperada del tipo en lugar de escribir cualquier cosa: una forma rápida de ver lo que --file/--body necesita antes de crearlo a mano. --dry-run para imprimir el plan de mutación resuelto (verbo HTTP, destino, carga útil resuelta) sin llamar a la API.
• update se fusiona en el servidor existente por defecto escalar; --file/--body reemplaza por completo. En el modo escalar, solo cambian los marcadores que pasas: el resto de los campos del servidor recuperados se conservan, incluido un servidor platform existente selectedToolNames cuando se omite --tool. El campo type en sí es inmutable: incluirlo en una carga útil --file/--body es un error del lado del cliente, no un no-op silencioso.

Sinopsis

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]

lista de mcp de agenthub de uip

Enumera los registros del servidor MCP. Los filtros (--type, --status, --name) y la paginación (--limit/--offset) se aplican en el lado del cliente, ya que la API subyacente devuelve una matriz plana.

Opciones

Largo	Valor	Predeterminado	Descripción
--type <kind>	uipath|command|coded|selfhosted|remote|process-assistant|platform|swagger	—	Filtrar por tipo de servidor. Los valores no válidos fallan en el lado del cliente antes de cualquier llamada a la API.
--status <s>	String	—	Filtrar por estado. Coincidencia con la enumeración de estado numérico como una cadena sin procesar.
--name <substr>	String	—	Coincidencia de subcadena que no distingue entre mayúsculas y minúsculas en el nombre del servidor.
--limit <number>	Entero	50	Tamaño de la página.
--offset <number>	Entero	0	Desplazamiento de fila.
--folder-key <key>	GUID	—	Carpeta de Orchestrator. Mutuamente exclusivo con --all-folders.
--folder-path <path>	String	—	Nombre para mostrar de la carpeta o ruta completa, resuelto en una clave a través del SDK de Orchestrator.
--all-folders	Marca	Desactivado	Enumera todas las carpetas que puede ver la persona que llama. Mutuamente exclusivo con --folder-key/--folder-path.
--login-validity <minutes>	Entero	—	Anula la vigencia del token de inicio de sesión interactivo para esta llamada.

Ejemplo

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

Forma de datos (--json de salida)

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

uip agenthub mcp get

Obtenga un servidor MCP por slug canónico. Sin respaldo de búsqueda de nombres: pasa el slug exacto de mcp list.

Argumentos

Nombre	Obligatorio	Propósito
<slug>	Sí	Slug del servidor MCP canónico.

Opciones

Largo	Valor	Descripción
--folder-key <key> / --folder-path <path>	GUID/cadena	Contexto de la carpeta.
--login-validity <minutes>	Entero	Anulación de la duración del token.

Ejemplo

uip agenthub mcp get invoice-mcp

Forma de datos (--json de salida)

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

uip agenthub mcp create

Crea un servidor MCP. Un subcomando por tipo: uipath, coded, command, remote, platform, swagger (consulta Conceptos para los dos nombres de tipo que existen en el enum pero que no tienen hoja create funcional) . Los seis comparten --name, --slug (el valor predeterminado es un slugified --name), --description, --version, más --file/--body/--print-schema/--dry-run y opciones de carpeta. Requiere una carpeta resoluble: de lo contrario, falla antes de cualquier llamada de red.

Opciones específicas del tipo

Tipo	Opciones adicionales	Notas
uipath	ninguno	Carga útil: { server: {name, slug, description, version}, tools: [] }. Las herramientas se añaden después a través de mcp-tools.
coded	--process-key <key>	Respaldado por un proceso de Orchestrator. --folder-key se duplica como folderKey de la carga útil.
command	--command <cmd>, --arg <arg> (repetible), --env <key=value> (repetible)	Inicia un binario local. arguments es la lista --arg unida (separada por espacios); environmentVariables es un objeto en cadena JSON creado a partir de --env pares.
remote	--uri <uri>, --header <key=value> (repetible), --use-relay	headers es un objeto JSON de --header pares.
platform	--service <name>, --tool <name> (repetible)	La carga útil anida los escalares en server, con selectedToolNames a su lado.
swagger	--spec-url <url>, --use-relay, --filter <expr> (repetible, reservado)	Se crea a través de un punto final de API específico de Swagger independiente.

Ejemplos

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

Forma de datos (--json de salida)

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

--print-schema devuelve Code: "AgentHubMcpTemplate" con el esquema JSON del tipo en lugar de crear nada. --dry-run devuelve Code: "DryRun" con el plan de mutación resuelto.

actualización de mcp de agenthub de uip

Actualiza un servidor MCP. Despachos por el tipo existente del servidor (obtenido primero): las mismas opciones específicas de tipo que create se registran en update independientemente del tipo real del destino, pero solo se fusionan las relevantes para el tipo recuperado.

Argumentos

Nombre	Obligatorio	Propósito
<slug>	Sí	Slug del servidor MCP canónico.

Opciones

Los mismos marcadores específicos de tipo que create (--name, --description, --version, --process-key, --command, --arg, --env, --uri, --header, --use-relay, --service, --tool, --spec-url), más --file/--body/--print-schema/--dry-run y opciones de carpeta. type es inmutable: incluirlo en una carga útil --file/--body es un error del lado del cliente.

Ejemplo

uip agenthub mcp update invoice-mcp --name InvoiceMcp

Forma de datos (--json de salida)

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

plantilla mcp de agenthub de uip

Emite un esqueleto JSON listo para editar para un tipo de servidor: un comando de referencia estático e independiente del conector (sin opciones de carpeta).

Argumentos

Nombre	Obligatorio	Propósito
<type>	Sí	Uno de uipath, coded, command, selfhosted, remote, process-assistant, platform, swagger (los 8, incluidos los dos sin hoja create funcional). swagger-mcp también se acepta, normalizado a swagger.

Ejemplo

uip agenthub mcp template uipath

Forma de datos (--json de salida)

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

eliminación de mcp de agenthub de uip

Eliminar un servidor MCP por slug. Destructivo: requiere -y/--yes. Requiere una carpeta resoluble.

Argumentos

Nombre	Obligatorio	Propósito
<slug>	Sí	Slug del servidor MCP canónico.

Opciones

Largo	Descripción
-y, --yes	Obligatorio para confirmar. La CLI nunca solicita.
--dry-run	Imprime el plan de mutación sin eliminarlo.

Ejemplo

uip agenthub mcp delete invoice-mcp -y

Forma de datos (--json de salida)

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

herramientas de actualización de mcp de agenthub de uip

Vuelve a derivar las herramientas de un servidor desde su origen activo (el esquema de un proceso, un punto final remoto/swagger, etc.).

Argumentos

Nombre	Obligatorio	Propósito
<slug>	Sí	Slug del servidor MCP canónico.

Opciones

Largo	Descripción
--folder-key <key> / --folder-path <path>	Se requiere uno : el punto final de actualización tiene ámbito de carpeta (/mcp/{folderKey}/{slug}/refresh-tools). Si faltan ambos, se produce un error explícito antes de cualquier búsqueda.
--dry-run	Imprime el plan de mutación sin actualizar.

El comportamiento difiere según el tipo de servidor: las actualizaciones coded/command devuelven un asíncrono runtimeId (HTTP 202, status: "Started"); remote/swagger/platform se actualizan de forma síncrona (status: "Refreshed", toolCount); Los servidores uipath y selfhosted se rechazan localmente (sus herramientas se crean manualmente, no se derivan) con una sugerencia NextCommand que apunta a mcp-tools create-resource.

Ejemplo

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

Forma de datos (--json de salida)

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

Las respuestas asíncronas (202) en su lugar devuelven { "runtimeId": "...", "status": "Started" }.

Relacionado

• mcp-tools y remote-a2a-agent : gestionar herramientas en un servidor y registros de agente A2A remotos.

Ver también

• Opciones globales
• Códigos de salida