Autenticarse con un token de acceso personal

Los tokens de acceso personal (PAT) son tokens de ámbito de usuario con una vida útil configurable (hasta un año). Son útiles cuando necesitas un token de mayor duración que el que proporciona el inicio de sesión interactivo , o cuando no puedes ejecutar uipath auth de forma interactiva pero aún necesitas autenticarte como usuario.

Al crear un PAT, debes seleccionar permisos del recurso Acceso a la API de Orchestrator que cubran las operaciones de MCP que necesitas.

Requisitos previos

• Tienes el rol Automation User, Automation Developer o Folder Administrator en la carpeta que contiene el servidor MCP. Estos roles incluyen el permiso MCPServers.View .

Generar un token de acceso personal

1. Ve a UiPath, selecciona tu icono de usuario y luego selecciona Preferencias.

2. Navega a Token de acceso personal y selecciona Generar nuevo token.

3. Introduce un nombre y una fecha de vencimiento.

4. En Ámbitos, selecciona los siguientes permisos del recurso Acceso a la API de Orchestrator :

   • OR.Execution: necesario para las herramientas de listado. Los servidores MCP llaman a la API ListReleases de Orchestrator para resolver los metadatos del proceso, y ese punto final requiere este ámbito.
   • OR.Jobs: necesario para ejecutar herramientas. Todos los tipos de servidor MCP que ejecutan procesos como herramientas (UiPath, Coded y Command) llaman a la API StartJobs de Orchestrator, que requiere este ámbito.

5. Selecciona Guardar y copia el token inmediatamente.

   Importante:

   El token se muestra solo una vez. Si no lo copia ahora, debe generar un nuevo token.

Resultado

El token ahora está disponible para su uso en el encabezado Authorization de las solicitudes HTTP al servidor MCP.

Utilizar el token de acceso personal

Para llamar a un servidor MCP con el token:

curl -X POST "https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folderKey}/{slug}" \
  -H "Authorization: Bearer <your-PAT>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{...},"id":1}'

Características del token

• Token opaco con audiencia UiPath.Orchestrator.
• Caducidad configurable (hasta un año).
• El acceso es la intersección de los ámbitos de PAT y los permisos de rol a nivel de carpeta del usuario.
• Funciona con cualquier cliente HTTP (cURL, Postman, MCP Inspector, código personalizado).

Limitaciones

• Los PAT están vinculados a una identidad de usuario específica. Si el usuario está desactivado, el PAT deja de funcionar.
• Solo los usuarios que tienen acceso interactivo a UiPath pueden crear PAT.
• Las actividades de Integration Service no admiten la autenticación PAT. La conexión MCP se realiza correctamente, pero las llamadas de herramientas que dependen de las conexiones de Integration Service fallan.