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 agénticos 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.

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 Command MCP

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