Servidor MCP para UiPath Orchestrator

Este servidor conecta un cliente MCP (como Claude) con UiPath Orchestrator para poder listar carpetas, procesos, robots y trabajos, y disparar la ejecución de un proceso — todo en lenguaje natural.

⚠️ Aclaración importante: esto habla con Orchestrator (la parte cloud que gestiona y dispara robots), no con UiPath Studio. Studio, el programa donde diseñas el workflow, no tiene una API para esto — por eso el primer paso es tener una cuenta de Orchestrator, aunque sea gratis.

---

Paso 1 — Crear una cuenta gratis de Orchestrator (Community Edition)

Si ya usas UiPath Studio local, probablemente iniciaste sesión con una cuenta de UiPath — esa misma cuenta ya te da acceso a un Orchestrator gratis en la nube:

1. Entra a https://cloud.uipath.com e inicia sesión (o "Sign Up" si nunca te registraste — es gratis, plan Community).
2. Una vez adentro, verás la URL con el nombre de tu organización, algo así: https://cloud.uipath.com/TU_ORGANIZACION/DefaultTenant/orchestrator_/... Ese TU_ORGANIZACION es tu UIPATH_ORG_NAME.
3. (Opcional pero recomendado para probar) Desde Studio, publica tu proceso piloto a Orchestrator: Design → Publish → Orchestrator. Así vas a tener al menos un proceso real para listar y ejecutar.

Paso 2 — Crear una External Application (credenciales OAuth2)

Esto es lo que te da el client_id y client_secret para que el servidor se autentique sin usar tu usuario/contraseña.

1. En Orchestrator, ve a Admin → External Applications (o busca "External Applications" en el buscador de la interfaz).
2. Click en Add Application.
3. Tipo de aplicación: Confidential Application.
4. En Scopes, agrega el scope de Orchestrator OR.Default con permisos de al menos: Folders.Read, Releases.Read, Jobs.Read, Jobs.Create, Robots.Read (puedes marcar más si quieres, pero con esto alcanza para el piloto).
5. Guarda y copia el App ID (client_id) y el App Secret (client_secret) — el secret solo se muestra una vez.
6. Verifica que esa aplicación tenga un rol asignado (ej. "Automation User") en la carpeta donde publicaste tu proceso: Manage Access dentro de esa carpeta → asignar la external app.

Paso 3 — Configurar el proyecto

cd uipath-mcp-server
python3 -m venv .venv
source .venv/bin/activate        # En Windows: .venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env

Abre .env y completa UIPATH_ORG_NAME, UIPATH_CLIENT_ID y UIPATH_CLIENT_SECRET con lo que copiaste en el Paso 2.

Paso 4 — Probar localmente (sin conectarlo a Claude todavía)

La forma más rápida de verificar que todo funciona es con el MCP Inspector, una interfaz web que viene incluida:

mcp dev server.py

Esto abre un enlace local en tu navegador donde puedes:

• Ver las 5 herramientas disponibles (listar_carpetas, listar_procesos, etc.)
• Ejecutarlas manualmente con botones y ver la respuesta cruda del API

Empieza siempre por listar_carpetas — de ahí sacas el folder_id que piden las demás herramientas.

Si algo falla, el mensaje de error te va a decir si el problema fue en la autenticación (revisa client_id/secret) o en la API (revisa que la external app tenga el rol asignado en esa carpeta).

Paso 5 — Conectarlo a Claude Desktop (opcional, uso local)

Si usas la app de escritorio de Claude, puedes registrarlo directamente:

mcp install server.py --name "UiPath Orchestrator" --env-file .env

Esto lo agrega a la configuración de Claude Desktop automáticamente, junto con tus variables de entorno del .env.

Paso 6 — Conectarlo a Claude en el navegador (URL pública)

El campo "Servidores MCP" que viste en la web de Claude pide una URL pública (no localhost). Eso requiere desplegar este servidor en algún lugar accesible por internet (un VPS, Render, Railway, etc.) usando transporte SSE/HTTP en vez de stdio. Es un paso aparte, con sus propias consideraciones de seguridad (no vas a querer exponer tu Orchestrator sin protección) — armamos eso cuando hayas probado que todo funciona local.

Herramientas incluidas

Herramienta	Qué hace
listar_carpetas	Lista las carpetas del Orchestrator (punto de partida)
listar_procesos(folder_id)	Lista procesos publicados en una carpeta
listar_robots(folder_id)	Lista robots de una carpeta
listar_trabajos(folder_id, top)	Lista los últimos trabajos (jobs)
iniciar_trabajo(folder_id, release_key)	Dispara la ejecución de un proceso