Cómo configurar el MCP de UiPath en Cursor (guía práctica y segura)

Si trabajas con UiPath y quieres operar colas, jobs y assets desde Cursor, el MCP de UiPath te ahorra muchísimo tiempo. Pero hay tres puntos que suelen romper la integración: instalación, auth y permisos de carpeta.

En esta guía te dejo la configuración que funciona y, sobre todo, cómo evitar los errores más típicos sin exponer información sensible.

Qué es MCP en este contexto

MCP (Model Context Protocol) te permite exponer herramientas de Orchestrator para que Cursor las ejecute desde chat/comandos.

En práctica, podrás:

• consultar jobs y su estado,
• revisar queue items,
• leer assets y robots,
• y acelerar diagnóstico de procesos RPA.

1) Instalar servidor MCP de UiPath

Con uv:

uv tool install uipath-orchestrator-mcp

Comprueba que el binario existe:

~/.local/bin/uipath-mcp --help

Si Cursor no encuentra el comando (ENOENT), usa ruta absoluta en la config.

2) Configurar MCP en Cursor

En Cursor → Settings → Features → MCP añade un server uipath.

Opción A (OAuth2 cloud)

{
  "mcpServers": {
    "uipath": {
      "command": "/home/tu_usuario/.local/bin/uipath-mcp",
      "env": {
        "AUTH_MODE": "cloud",
        "UIPATH_CLIENT_ID": "<client_id>",
        "UIPATH_CLIENT_SECRET": "<client_secret>",
        "UIPATH_ORG_NAME": "<org>",
        "UIPATH_TENANT_NAME": "<tenant>"
      }
    }
  }
}

Opción B (PAT)

{
  "mcpServers": {
    "uipath": {
      "command": "/home/tu_usuario/.local/bin/uipath-mcp",
      "env": {
        "AUTH_MODE": "pat",
        "UIPATH_PAT": "<personal_access_token>",
        "UIPATH_ORG_NAME": "<org>",
        "UIPATH_TENANT_NAME": "<tenant>",
        "UIPATH_BASE_URL": "https://cloud.uipath.com/<org>/<tenant>/orchestrator_"
      }
    }
  }
}

3) Errores típicos y solución rápida

Error: spawn uipath-mcp ENOENT

Causa: Cursor no tiene en PATH el binario de uv.

Solución: usar ruta absoluta en command.

Error: 403 You are not authorized!

Causa: faltan permisos de app/usuario o acceso al folder.

Checklist:

• scopes de Orchestrator habilitados,
• acceso de la cuenta/app al folder correcto,
• rol mínimo de lectura para jobs/queues/folders.

Error: 401 o URL mal formada

Causa: UIPATH_BASE_URL incompleto en modo PAT.

Solución: usa la URL completa del Orchestrator (org + tenant + orchestrator_).

4) Buenas prácticas de seguridad (importante)

• Nunca subas tokens o secrets al repo.
• Guarda credenciales solo en variables de entorno.
• Usa PAT con expiración corta y rotación periódica.
• Aplica principio de mínimo privilegio: solo scopes/roles necesarios.
• Si compartes capturas o logs, redacta IDs, tokens y URLs privadas.

5) Qué puedes automatizar después

Una vez conectado MCP:

1. comprobar jobs en fallo automáticamente,
2. detectar queue items atascados,
3. validar robots offline,
4. generar informes diarios de salud operativa.

---

Conclusión

La integración UiPath MCP + Cursor funciona muy bien cuando se configura con método: binario correcto, auth clara y permisos de folder bien asignados.

Si quieres, en un siguiente artículo puedo publicar un playbook de troubleshooting con casos reales (timeout, colas atascadas, jobs faulted y remediación segura).