Tipos de servidor MCP

Servidores MCP de UiPath

El servidor MCP de UiPath expone los artefactos de UiPath (flujos de trabajo de RPA, agentes, flujos de trabajo de API, procesos de Maestro BPMN y actividades de Integration Service) como herramientas de MCP. Úsalo cuando la lógica de automatización ya exista en UiPath y deba estar disponible para los modelos de IA.

Este tipo de servidor se crea y gestiona directamente dentro de UiPath Platform, lo que proporciona integración nativa, implementación simplificada y gobernanza centralizada a través de Orchestrator.

Cómo funciona

La configuración se realiza por completo en Orchestrator, en la pestaña Servidores MCP de ámbito de carpeta. Los usuarios seleccionan los artefactos para exponer como herramientas y guardar el servidor. No se requiere empaquetado, código o proceso externo.

Una vez configurado, se puede acceder al servidor a través de la URL estándar del servidor MCP de UiPath. Para el formato de URL, consulta Obtener la URL del servidor MCP.

Autenticación

Los servidores MCP de UiPath utilizan el modelo de autenticación de servidor MCP estándar. Para obtener más información sobre los métodos compatibles y los permisos necesarios, consulta Autenticación del servidor MCP.

Se aplica una restricción adicional: las herramientas respaldadas por actividades de Integration Service requieren tokens de contexto de usuario. Estas herramientas funcionan con el inicio de sesión interactivo o el flujo OAuth de MCP, pero no con los tokens de acceso personal o las credenciales de cliente de aplicaciones externas.

Configuración

Para obtener instrucciones paso a paso, consulta Crear servidores MCP de UiPath.

Servidores MCP remotos

El servidor MCP remoto permite a UiPath conectarse a servidores MCP alojados fuera de UiPath Platform. Orchestrator actúa como proxy, reenviando las solicitudes de MCP a una URL externa que proporciones.

El servidor MCP remoto cubre dos escenarios:

• Servicios de terceros gestionados externamente: por ejemplo, Atlassian MCP o Stripe MCP, a los que se accede a través de Internet público.
• Servidores MCP locales a los que se debe acceder desde UiPath Cloud sin abrir puertos de entrada. Al marcar la opción Conectar a través de Relay , UiPath Relay establece un túnel saliente de larga duración desde tu red a UiPath Cloud, y el servidor MCP remoto se configura en la URL de Relay. No se requiere VPN, exposición pública o conectividad entrante.

En ambos escenarios, el punto final remoto debe hablar HTTP Streamable.

Cómo funciona

La configuración se realiza en Orchestrator proporcionando la URL remota y un conjunto opcional de encabezados HTTP personalizados. No interviene ningún paquete, código o proceso de UiPath.

Cuando se invoca una herramienta, Orchestrator reenvía la llamada a la URL remota junto con cualquier encabezado personalizado que esté configurado. Los encabezados específicos de UiPath, incluido el token al portador, no se reenvían al servidor remoto, por lo que tu identidad de UiPath nunca llega a él. Los encabezados personalizados con valores que contienen términos como secret, api_key o token se enmascaran en la IU después de guardar.

Los valores de encabezado personalizados pueden hacer referencia a los activos de Orchestrator utilizando la sintaxis %ASSETS/AssetName%. Los servidores MCP remotos resuelven estas referencias a través de la API de activos de Orchestrator antes de reenviar la solicitud, sin requerir un robot o una clave de robot. Para obtener más información, consulta Utilizar activos de Orchestrator en servidores MCP.

Autenticación

Los servidores MCP remotos utilizan el modelo de autenticación de servidor MCP estándar. Los cuatro métodos de autenticación compatibles funcionan con este tipo. Para obtener más información, consulta Autenticación del servidor MCP.

Configuración

Para obtener instrucciones paso a paso, consulta Crear un servidor MCP remoto.

Servidores MCP de plataforma

Nota:

Esta funcionalidad está en vista previa.

El servidor MCP de la plataforma expone un servicio UiPath de origen como un conjunto seleccionado de herramientas MCP. En lugar de exponer cada operación que ofrece la API del servicio, eliges cuáles se convierten en herramientas, y esa elección se guarda en el servidor. Úsalo cuando un modelo necesite llegar a un servicio UiPath directamente, y un administrador deba decidir exactamente qué operaciones están en el ámbito.

Están disponibles los siguientes servicios:

• Test Manager: el ciclo de vida de la prueba dentro de un proyecto, incluidos los requisitos, los casos de prueba y sus pasos, los conjuntos de pruebas, las ejecuciones y los registros de ejecución. Aparece como tres entradas: Test Manager, Test Manager externo y Test Manager Performance Testing, la última que cubre escenarios de rendimiento, grupos de carga e informes de ejecución.
• Control de gestión de casos: acceso de solo lectura a una única instancia de caso, incluidas sus variables, el último estado de ejecución, el plan del caso y las reglas bajo las que se ejecuta.
• Docs AI: busca en la documentación del producto UiPath. Una herramienta devuelve una respuesta generada por IA con citas, otra devuelve los fragmentos de documento coincidentes y una tercera envía comentarios sobre una respuesta anterior.

Cómo funciona

La configuración se realiza en Orchestrator: elige el servicio y luego elige sus operaciones. La lista está agrupada por categoría, por lo que las operaciones relacionadas aparecen juntas. Para exponer todas las operaciones que ofrece el servicio, incluidas las añadidas posteriormente, habilita Todas las herramientas en su lugar. No hay ningún paquete, código o proceso involucrado.

La solicitud que UiPath realiza al servicio tiene un tiempo de espera de 30 segundos, y la llamada de la herramienta se mantiene abierta hasta que regrese. Las llamadas aparecen en la pestaña Ejecuciones en el servidor, y el contexto de seguimiento se traslada al servicio.

Autenticación

Los servidores MCP de plataforma utilizan el modelo de autenticación de servidor MCP estándar. Para obtener más información, consulta Autenticación del servidor MCP.

Configuración

Para obtener instrucciones paso a paso, consulta Crear servidores MCP de plataforma.

Servidores MCP de Swagger

Nota:

Esta funcionalidad está en vista previa.

El servidor MCP de Swagger 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. Úsalo para una API que no sea un servicio de primera parte de UiPath y no tenga un servidor MCP propio.

A diferencia de un servidor MCP remoto, que actúa como proxy de algo que ya habla MCP, un servidor MCP de Swagger proporciona la capa MCP para una API que no lo habla. A diferencia de un servidor MCP de plataforma, que se inicia a partir de una lista fija de servicios de UiPath, un servidor MCP de Swagger se inicia a partir de cualquier documento OpenAPI que proporciones.

Cómo funciona

La configuración se realiza en Orchestrator proporcionando la URL del documento o pegando el propio documento. Añade los encabezados HTTP que la API espera, utilizando la misma sintaxis %ASSETS/AssetName% que otros tipos de servidores para mantener los secretos fuera de la configuración. Para una API en una red privada, conéctese a través de Relay.

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.

Autenticación

Los servidores MCP de Swagger utilizan el modelo de autenticación de servidor MCP estándar. Para obtener más información, consulta Autenticación del servidor MCP.

Configuración

Para obtener instrucciones paso a paso, consulta Crear servidores Swagger MCP.

Servidores MCP de comando

El servidor MCP de comando permite a UiPath integrar un servidor MCP existente desde una fuente de paquete externo, como NPM (npx) o PyPI (uvx), utilizando un comando compatible con la plataforma. Úsalo para ejecutar servidores MCP preexistentes o de terceros sin volver a empaquetarlos como artefactos de UiPath.

Cómo funciona

Los servidores MCP de comando se ejecutan en UiPath Serverless y admiten servidores MCP Python y JavaScript/Node.js. Cada servidor mantiene una sesión por trabajo, con una duración máxima del trabajo de 15 minutos.

La configuración se realiza en Orchestrator proporcionando el comando y sus argumentos. No se requiere ningún paquete, código o definición de proceso de UiPath. La configuración se almacena como una entrada en un archivo mcp.json. Por ejemplo:

{
  "servers": {
    "filesystem-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    }
  }
}

Un servidor MCP de comando comparte el mismo runtime y formato de configuración que los servidores MCP codificados y autoalojados. Para obtener más información, consulta Base compartida del servidor MCP.

Variables de entorno y secretos

Las variables de entorno se configuran directamente en el servidor MCP en Orchestrator y se almacenan cifradas. Se puede hacer referencia a los activos de Orchestrator para la gestión de secretos utilizando la sintaxis %ASSETS/AssetName%. Para obtener más información, consulta Utilizar activos de Orchestrator en servidores MCP.

Autenticación

Los servidores MCP de comando utilizan el modelo de autenticación de servidor MCP estándar. Cada llamada de herramienta inicia un trabajo sin servidor, por lo que las personas que llaman necesitan los permisos MCPServers.View y Jobs.Create . Para obtener más información, consulta Autenticación del servidor MCP.

Configuración

Para obtener instrucciones paso a paso, consulta Crear servidores MCP de comando.

Servidores MCP codificados

Un servidor MCP codificado es un servidor MCP Python escrito utilizando el marco FastMCP del paquete mcp Python, luego empaquetado y publicado en Orchestrator como un artefacto UiPath NuGet (.nupkg). La biblioteca uipath-mcp proporciona la capa de runtime que integra el servidor con UiPath Platform.

Utiliza este tipo cuando un servidor MCP personalizado deba crearse y alojarse en UiPath, con código almacenado, versionado y distribuido a través del sistema de gestión de paquetes de UiPath.

Cómo funciona

Los servidores MCP codificados se ejecutan en UiPath Serverless. Cada servidor mantiene una sesión por trabajo, con una duración máxima del trabajo de 15 minutos. Las llamadas de herramientas activas están sujetas a un tiempo de espera de conexión de aproximadamente 3,5 minutos, y las sesiones inactivas finalizan después de aproximadamente 6-7 minutos de inactividad.

Para implementar un servidor MCP codificado, el código del servidor se empaqueta y se publica en Orchestrator mediante la uipath-mcp CLI. A continuación, el servidor MCP codificado se configura en Orchestrator en la misma carpeta donde se implementa el paquete. Una entrada mcp.json hace referencia al servidor:

{
  "servers": {
    "math-server": {
      "type": "stdio",
      "command": "python",
      "args": ["server.py"]
    }
  }
}

Al igual que un servidor MCP de comando, un servidor codificado se define mediante una entrada mcp.json. La diferencia es que un servidor codificado ejecuta código de un artefacto UiPath NuGet publicado en Orchestrator, en lugar de extraer un paquete de una fuente externa.

Un servidor MCP codificado comparte el mismo runtime, formato de configuración y transporte que los servidores MCP de comando y autoalojados. Para obtener más información, consulta Base compartida del servidor MCP.

Variables de entorno y secretos

Para los servidores MCP codificados, las variables de entorno no se configuran en la propia entidad del servidor MCP. En su lugar, se establecen en el proceso en Orchestrator, en Configuración > Variables de entorno, y se almacenan cifradas. Se puede hacer referencia a los activos de Orchestrator para la gestión de secretos utilizando la sintaxis %ASSETS/AssetName%. Para obtener más información, consulta Utilizar activos de Orchestrator en servidores MCP.

Autenticación

Los servidores MCP codificados utilizan el modelo de autenticación de servidor MCP estándar. Cada llamada de herramienta inicia un trabajo sin servidor, por lo que las personas que llaman necesitan los permisos MCPServers.View y Jobs.Create. Para obtener más información, consulta Autenticación del servidor MCP.

Configuración

Para obtener instrucciones paso a paso, consulta Crear servidores MCP codificados. Para obtener más información sobre la implementación y una guía de inicio, consulta la uipath-mcp inicio rápido.

Servidores MCP autoalojados

El servidor MCP autoalojado se ejecuta en una infraestructura controlada por el usuario, máquinas locales, servidores locales o entornos de nube privada, mientras se conecta a UiPath para el control y la visibilidad. Úsalo cuando el servidor MCP necesite acceder a recursos locales a los que no se puede acceder desde la infraestructura en la nube, o cuando la política requiera que el runtime viva en hardware propiedad del cliente.

Cómo funciona

Un servidor MCP autoalojado no se puede configurar a través de la IU de Orchestrator. En su lugar, se registra con UiPath cuando se inicia localmente. A diferencia de los servidores MCP codificados y de comando, una instancia de runtime autoalojada admite varias sesiones simultáneas, con distribución aleatoria cuando varias sesiones se conectan al mismo slug. El ciclo de vida del servidor está totalmente controlado por ti.

Un servidor MCP autoalojado comparte el mismo runtime, formato de configuración y transporte que los servidores MCP de comando y codificado. Para obtener más información, consulta Base compartida del servidor MCP.

Registrar el servidor

Antes de iniciar el servidor, el runtime debe saber en qué carpeta de Orchestrator registrarlo. Se admiten dos rutas de registro, dependiendo del método de autenticación:

• Con autenticación interactiva (uipath auth): UIPATH_FOLDER_PATH se establece en la ruta de la carpeta. El runtime lo resuelve automáticamente en una clave de carpeta.
• Con autenticación de credenciales de cliente: UIPATH_FOLDER_KEY se establece directamente en el GUID de la carpeta, ya que la API de resolución de carpetas no admite credenciales de cliente.

Comandos de registro de ejemplo:

# Interactive auth
export UIPATH_FOLDER_PATH=<your-folder-path>
uipath run my-mcp

# Client-credential auth
export UIPATH_FOLDER_KEY=<your-folder-key>
uipath run my-mcp

Una vez registrado, el servidor aparece en Orchestrator y es accesible a través de la URL del punto final de MCP estándar. Para el formato de URL, consulta Obtener la URL del servidor MCP.

Autenticación

La autenticación opera en dos capas para servidores MCP autoalojados:

• El token uipath auth del desarrollador (o las credenciales de cliente) registra el runtime.
• El token al portador de la persona que llama autentica cada llamada de herramienta.

El token de la persona que llama nunca llega al runtime local. UiPath lo valida en la nube y solo reenvía el mensaje de protocolo MCP.

Para obtener más información sobre los métodos de autenticación compatibles y los permisos necesarios, consulta Autenticación del servidor MCP.

Configuración

Para obtener más información sobre la implementación y una guía de inicio, consulta la uipath-mcp inicio rápido.