Autenticación con inicio de sesión interactivo (CLI)

El inicio de sesión interactivo está diseñado para desarrolladores que trabajan localmente y necesitan acceso rápido para probar servidores MCP. El cliente en este método es UiPath CLI (herramienta de línea de comandos uipath ) que se ejecuta en tu máquina de desarrollo.

Al uipath auth, la CLI abre tu navegador predeterminado en la página de inicio de sesión de UiPath Cloud. Después de autenticarte, CLI guarda el token portador resultante en un archivo .env en tu directorio actual. A continuación, incluyes este token en el encabezado Authorization de tus solicitudes HTTP al punto final del servidor MCP.

El inicio de sesión interactivo es adecuado para los siguientes escenarios:

• Desarrollo local y pruebas de servidores MCP.
• Pruebas rápidas de API con cURL, Postman o MCP Inspector.
• Depuración de llamadas de herramienta MCP con permisos de usuario completos.
• Cualquier escenario en el que un desarrollador humano esté presente en el terminal.

No es adecuado para escenarios desatendidos o automatizados. En este caso, utiliza una aplicación externa en su lugar. Para las integraciones IDE, utiliza el flujo OAuth de MCP.

Requisitos previos

• La UiPath CLI se instala en tu máquina de desarrollo.
• Tienes una cuenta con el rol Automation User, Automation Developer o Folder Administrator en la carpeta que contiene el servidor MCP.

Autenticar y llamar a un servidor MCP

1. Autenticarse en UiPath:

   uipath auth
   

   La CLI abre tu navegador predeterminado. Inicia sesión en UiPath Cloud para completar la autenticación. La CLI guarda el token de portador resultante en un archivo .env en tu directorio actual como UIPATH_ACCESS_TOKEN.

2. Exporta el token a tu entorno de shell:

   export UIPATH_ACCESS_TOKEN=$(grep UIPATH_ACCESS_TOKEN .env | cut -d= -f2)
   

3. Llama a un servidor MCP utilizando el token exportado:

   curl -X POST "https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folderKey}/{slug}" \
     -H "Authorization: Bearer $UIPATH_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}},"id":1}'
   

Resultado

El servidor MCP valida el token y responde a la solicitud initialize . A continuación, puedes enviar mensajes de protocolo MCP posteriores con el mismo encabezado Authorization en cada solicitud.

Características del token

• Tipo: JWT
• Audiencia: incluye OrchestratorApiUserAccess
• Emisor: UiPath Identity Server ({env}.uipath.com/identity_)
• Caducidad: una hora. No hay actualización automática, vuelva a ejecutar uipath auth para obtener un nuevo token.

El token otorga:

• Acceso a todas las carpetas donde el usuario que ha iniciado sesión tiene asignaciones de roles.
• Todos los permisos que el usuario tiene en esas carpetas (heredados de sus roles).
• Compatibilidad con las actividades de Integration Service (el contexto de usuario está presente).

Tipos de servidor MCP aplicables

Este método de autenticación funciona con todos los tipos de servidor MCP: UiPath, codificado, comando, autoalojado, remoto y plataforma.