Introducción
Root reúne los runtimes de agentes de tu equipo, los conecta a un MCP propio con OAuth 2.1 y aplica permisos por rol en cada acción, empresa por empresa. Parte de una regla: un agente con acceso a tu organización no debería tener más poder que la persona que lo conectó.
Runtimes
Claude Code, Codex, OpenCode y más.
MCP
Una sola URL con OAuth 2.1.
Roles
Permisos por empresa.
Principios
Nadie alcanza más que quien autoriza
Cada tool que invoca un agente actúa con los permisos de la persona que lo autorizó, resueltos en cada llamada.
Todo ocurre dentro de una empresa
Agentes, políticas y MCP pertenecen a una empresa. Una persona puede estar en varias, con un rol distinto en cada una.
Tus CLI se quedan en tu equipo
Un companion emparejado detecta y ejecuta los CLI en tu máquina. Root los gobierna sin instalarlos en ningún servidor.
Datos leídos, no estimados
El consumo de cuota sale de lo que el propio CLI escribió en disco. Si un CLI no lo publica, Root lo dice con su motivo.
Primeros pasos
De cero a agentes gobernados en cuatro pasos:
- 1Crea tu empresa. Tras iniciar sesión creas una empresa, en la que quedas como owner, o aceptas una invitación.
- 2Empareja tu equipo. Ejecutas el companion en tu máquina y lo emparejas con la empresa: detecta los CLI instalados.
- 3Conecta tus runtimes. Desde Runtimes, «Conectar» registra el MCP de Root en Claude Code, Codex u OpenCode con un clic.
- 4Autoriza y gobierna. El CLI inicia sesión por OAuth 2.1 la primera vez; tú decides qué ve cada agente y lo revocas cuando quieras.
Companion y runtimes
El companion corre en el equipo de cada persona y hace lo que un servidor en la nube no puede: detectar los CLI, ejecutarlos y leer su disco. Es un binario autocontenido con los trabajos de todos los módulos, y cada runtime pertenece al equipo que lo detectó.
# Emparejar el companion con tu empresa
bun run companion pair <url>Root encuentra en el PATH los CLI instalados (Claude Code, Codex, Gemini, OpenCode, Copilot y más) y prueba los proveedores locales (Ollama, llama.cpp y LM Studio). El dashboard enseña cuáles están disponibles y conectados al MCP. El modo read-only es el predeterminado: dar escritura es una decisión consciente.
Conectar el MCP
Todos los CLI registran la misma URL, que no contiene secretos. La primera vez abren el navegador para iniciar sesión en Root por OAuth 2.1 y elegir la empresa en la que trabajarán. Estos son los comandos que Root ejecuta al pulsar «Conectar»:
# Claude Code
claude mcp add --transport http --scope user root https://onroot.dev/api/mcp
# Codex
codex mcp add root --url https://onroot.dev/api/mcp- Audiencia agente u operador: nadie invoca lo que no puede ver.
- Revocar un agente corta su acceso en la siguiente petición.
- Si tu CLI no tiene conexión asistida, Root te da la URL de su MCP para registrarla a mano.
Gobernanza
Una política es un prompt con nombre dividido en secciones: arquitectura, stack, guía de diseño. Los agentes la piden con get_governancey, si algo no cuadra, proponen la corrección.
- Sugerencias de los agentes con el texto actual y el corregido, lado a lado.
- Cada cambio sube la versión y queda en el historial.
- Cuántas veces la pidió cada agente y cuándo fue la última.
Diseño
Agrupa las pantallas de cada producto en proyectos y recórrelas en un lienzo navegable con zoom y desplazamiento. Doble clic para bajar de nivel y ver el id de cada nodo. Los agentes piden las pantallas por MCP para construir la interfaz sin adivinar, y el rol Diseñador permite crear y editar sin tocar el resto.
Empresas y roles
Cada empresa es un espacio aislado con sus miembros, agentes y políticas. Los permisos se conceden por rol dentro de la empresa activa y se vuelven a comprobar en cada petición. Las invitaciones son de un solo uso, atadas al correo invitado y caducan a los 7 días; la empresa conserva siempre al menos un owner.
| Rol | Permisos |
|---|---|
| Owner | Todo dentro de la empresa, incluido conceder o retirar el rol owner. |
| Admin | Todo dentro de la empresa salvo gestionar owners. |
| Designer | Lo de un member y, además, crear y editar las pantallas de diseño. |
| Member | Lectura de la empresa y conexión de sus propios agentes al MCP. |
Consumo de cuota
El dashboard muestra cuánto lleva gastado cada runtime de su ventana de cuota, incluido lo que consumiste fuera de Root. Se lee del disco, así que no ejecuta agentes ni gasta cuota; una ventana ya reiniciada no enseña un porcentaje viejo, y la relectura se programa en segundo plano.
Compatibilidad
| CLI / proveedor | Soporte |
|---|---|
| Claude Code | Conexión asistida |
| Codex | Conexión asistida y cuota |
| OpenCode | Conexión asistida |
| Gemini | Detección |
| Copilot | Detección |
| Ollama · llama.cpp · LM Studio | Proveedores locales |
Seguridad
La URL que registras en un CLI no contiene credenciales. El CLI guarda sus tokens en su propio almacén; en Root solo vive su hash, y cada concesión se revoca de un clic.
- Tokens de sesión, de OAuth e invitaciones guardados solo como hash SHA-256.
- Contraseñas con Argon2id y cambio obligatorio de la temporal inicial.
- OAuth 2.1 con PKCE S256 obligatorio y refresh rotativo que revoca ante reutilización.
- Token de acceso de 1 h válido solo para el agente y la empresa de su URL.
- Inicio de sesión con Google, restringible a dominios de Workspace.
- Nada que emita o gestione accesos se publica como tool MCP.
¿Necesitas ayuda para empezar?
Nuestro equipo te acompaña en la puesta en marcha de Root en tu organización.