Crear servidores Swagger MCP

Crea un servidor MCP de Swagger en Orchestrator proporcionando un documento OpenAPI que describa la API para exponer como herramientas.

Nota:

Esta funcionalidad está en vista previa.

Un servidor Swagger MCP convierte un documento OpenAPI en herramientas MCP. Proporcionas el documento y cada operación que describe se convierte en una herramienta que el servidor invoca a través de HTTP.

Requisitos previos

• El permiso Crear en el nivel de carpeta para servidores MCP.
• El documento OpenAPI para la API, ya sea como URL o como archivo que puedes pegar.

Crear un servidor MCP de Swagger

1. En Agent Gateway > Servidores MCP, selecciona el menú Añadir servidor MCP .

2. En Externo, selecciona Swagger.

3. Introduce un Nombre. Este es el nombre para mostrar que se muestra en la lista de servidores.

4. Introduce un Slug.

   Nota:

   El slug solo acepta letras minúsculas, números y guiones, y debe tener entre 3 y 50 caracteres. Se convierte en el último segmento de la URL del servidor.

5. Opcionalmente, introduce una Descripción de hasta 500 caracteres.

6. Elige cómo proporcionar el documento OpenAPI: selecciona Desde URL e introduce la URL de Swagger desde la que se sirve, o selecciona Pegar JSON y pega el propio documento.

   Nota:

   Desde la URL es la opción preferida, ya que es la única que admite la actualización posterior de las herramientas. Utiliza Pegar JSON cuando el documento no se sirva en una dirección a la que UiPath pueda acceder. Al cambiar entre las dos opciones se borra lo que has introducido en la otra.

7. Selecciona el Tipo de conexión: Estándar para conectarte directamente a Internet pública, o Privada (Relay) para enrutar el tráfico a través de UiPath Relay para una API dentro de tu propia red.

8. Añade los encabezados que espera la API, uno por línea, en el formulario Name:value

   Nota:

   El valor resuelto se envía a la API como encabezado configurado, por lo que utiliza encabezados respaldados por activos solo para los puntos finales en los que confías esos secretos.

   En lugar de pegar un secreto, asigna a un encabezado un valor de la forma %ASSETS/AssetName%. UiPath lo resuelve con el activo en la carpeta del servidor antes de enviar la solicitud, y la llamada falla en lugar de reenviar un marcador de posición no resuelto si el activo no se puede leer. El autocompletado enumera solo los activos que permiten el acceso a automatizaciones y API.

9. Opcionalmente, expande Barreras y configúralas.

10. Selecciona Añadir.

Resultado: UiPath lee el documento, lo obtiene si le diste una URL y crea una herramienta por operación que describe. Si el documento no se puede leer, el servidor no se crea y el error nombra el motivo. Selecciona Copiar URL en la fila del servidor para obtener su dirección:

https://cloud.uipath.com/{org_name}/{tenant_name}/agenthub_/mcp/{folder_key}/{server_slug}

Los activos de texto, secreto, booleano, entero, credencial y credencial de Windows son compatibles con los encabezados respaldados por activos; Los activos de credenciales y credenciales de Windows se resuelven en el valor de la contraseña. Los activos de lista de valores-clave no son compatibles, ya que un valor de encabezado debe resolverse en una cadena.

Para recoger los cambios en la API más tarde, selecciona Actualizar en el servidor. Vuelve a leer el documento desde su URL y reconstruye la lista de herramientas; los clientes conectados verán la nueva lista la próxima vez que la soliciten. Un servidor creado a partir de un documento pegado no tiene URL para volver a leer, por lo que mantenerlo actualizado significa editar el documento pegado.

Nota:

En una conexión estándar , la solicitud que UiPath realiza a la API tiene un tiempo de espera de 30 segundos y un límite de respuesta de 1 MiB, y la llamada de la herramienta se mantiene abierta hasta que vuelve. Las operaciones de larga duración y las operaciones que devuelven grandes cargas útiles no son una buena opción para este tipo de servidor.

Las llamadas aparecen en la pestaña Ejecuciones en el servidor.

Para saber cómo se autentican las personas que llaman y qué permisos necesitan, consulta Autenticación del servidor MCP. Para saber qué es este tipo de servidor y cómo se compara con los demás, consulta Tipos de servidor MCP.