Servicio y almacenamiento
konsolity serve atiende las solicitudes del conector Claude de la cuenta como lo haría la app de escritorio, pero sin interfaz: Claude puede actuar en tus servidores incluso con tu ordenador apagado, dentro de los límites del alcance y de las reglas de la máquina. Requiere el ámbito mcp y la integración con Claude del plan Studio, y el conector Claude ya debe estar añadido en Claude.
Probar en primer plano
konsolity serve
El comando se queda en primer plano y muestra cada solicitud atendida o rechazada. Ctrl+C lo detiene. Para un servidor de verdad, instálalo como servicio.
Linux: systemd
sudo konsolity service install
El comando:
- crea el usuario del sistema
konsolity, sin shell ni contraseña; - instala la unidad
konsolity.servicecon reinicio automático (Restart=always) y el aislamiento de systemd (ProtectSystem=strict,NoNewPrivileges=yes); - guarda la configuración en
/etc/konsolity/y el estado en/var/lib/konsolity/; - cifra los secretos con
systemd-creds(consulta más abajo); - copia el binario en
/usr/local/bin/konsolity(el entorno aislado oculta/homeal servicio); - instala el temporizador
konsolity-update.timer, que comprueba la versión firmada dos veces al día, actualiza el binario y reinicia el servicio; - habilita e inicia el servicio.
El servicio se inicia con el sistema y se reinicia solo tras un error o un corte de red. Sus registros:
journalctl -u konsolity
journalctl -u konsolity -f
Varios servidores: relé principal y de reserva
Active Konsolity CLI en dos o más servidores, cada uno con service install. Un solo relé atiende cada solicitud de Claude: el de mayor prioridad (Ajustes › Claude › Relés de Claude). Los demás quedan en reserva, sin app ni Mac encendido.
Si el relé principal se detiene correctamente, el siguiente toma el relevo en un segundo. Si cae sin avisar, el siguiente toma una solicitud sin respuesta a los 6 segundos, el tercero a los 12 segundos. Una solicitud nunca se ejecuta dos veces. El registro muestra el papel de cada máquina: «Relé activo» o «En reserva».
Para que un relé de reserva tome también los comandos, sus reglas deben permitir comandos (Ajustes › Máquinas CLI › la máquina › Reglas). Si no, solo toma las lecturas (hosts, snippets, sesiones).
macOS: launchd
sudo konsolity service install
Instala el servicio launchd com.konsolity.cli, que se relanza automáticamente (KeepAlive). Los secretos se guardan en el llavero. Los registros están en la app Consola.
Windows: tarea programada
En un PowerShell de administrador:
konsolity service install
Crea una tarea programada que lanza konsolity serve al iniciar Windows y lo relanza tras un error.
Comprobar
konsolity status
status indica si la máquina está accesible, la antigüedad del token, el alcance y el número de hosts accesibles. La máquina aparece en línea en la lista de máquinas CLI mientras haya dado señales de vida en el último minuto.
Carpetas
| Ruta | Contenido |
|---|---|
~/.config/konsolity/ |
Linux y macOS, uso sin servicio: config.json y secretos |
%APPDATA%\Konsolity\cli\ |
Windows: config.json y credentials.bin |
/etc/konsolity/ |
Servicio de Linux: configuración |
/var/lib/konsolity/ |
Servicio de Linux: secretos cifrados y estado |
config.json (dirección del servidor, identificador y nombre de la máquina, alcance mostrado) tiene permisos 0600. No contiene ningún secreto.
Almacenamiento de los secretos
Los secretos de la máquina son su token y su clave de máquina. Se guardan según el sistema:
| Sistema | Almacenamiento |
|---|---|
| macOS | Llavero (elemento com.konsolity.cli) |
| Linux, como servicio | systemd-creds encrypt, con el TPM cuando la máquina tiene uno y, si no, con la clave del equipo |
Linux, sin systemd-creds |
archivo credentials.bin con permisos 0600 |
| Windows | DPAPI (usuario actual) en credentials.bin, acceso reservado a esa cuenta |
En todos los casos, el contenido se cifra primero con una clave derivada del identificador de la máquina: copiado en otro ordenador, es ilegible. Los secretos nunca aparecen en un registro, en un argumento de línea de comandos ni en una variable de entorno, salvo KONSOLITY_TOKEN, que tú decides proporcionar para un token de larga duración.
Rotación automática del token
El token de una máquina se renueva automáticamente cada 24 horas, sin interrupción: el token anterior se sigue aceptando hasta la primera llamada hecha con el nuevo, 10 minutos como máximo. Para forzar una rotación (tras restaurar una copia de seguridad o tras la intervención de un tercero):
konsolity rotate
Los tokens de larga duración (setup-token) no tienen rotación automática; caducan como muy tarde al cabo de un año.
Quitar el servicio
sudo konsolity service uninstall
El servicio se detiene y se elimina. La máquina sigue activada en tu cuenta: para cortarla también, ejecuta konsolity logout o revócala desde la lista de máquinas CLI.