Serviço e armazenamento

Atualizado em 10 de novembro de 2026

konsolity serve trata as solicitações do conector Claude da conta como faria o app de computador, mas sem interface: o Claude pode agir nos seus servidores mesmo quando o seu computador está desligado, dentro dos limites do escopo e das regras da máquina. Ele exige o domínio mcp e a integração Claude do plano Studio, e o conector Claude já precisa estar adicionado no Claude.

Testar em primeiro plano

konsolity serve

O comando fica em primeiro plano e exibe cada solicitação tratada ou recusada. Ctrl+C o interrompe. Para um servidor de verdade, instale-o como serviço.

Linux: systemd

sudo konsolity service install

O comando:

  • cria o usuário de sistema konsolity, sem shell nem senha;
  • instala a unidade konsolity.service com reinício automático (Restart=always) e a sandbox do systemd (ProtectSystem=strict, NoNewPrivileges=yes);
  • guarda a configuração em /etc/konsolity/ e o estado em /var/lib/konsolity/;
  • criptografa os segredos com systemd-creds (veja abaixo);
  • copia o binário para /usr/local/bin/konsolity (a sandbox esconde /home do serviço);
  • instala o temporizador konsolity-update.timer, que verifica a versão assinada duas vezes por dia, atualiza o binário e reinicia o serviço;
  • ativa e inicia o serviço.

O serviço inicia com o sistema e reinicia sozinho após um erro ou uma queda de rede. Os logs dele:

journalctl -u konsolity
journalctl -u konsolity -f

Vários servidores: relé principal e de reserva

Ative o Konsolity CLI em dois ou mais servidores, cada um com service install. Um único relé trata cada pedido do Claude: o de maior prioridade (Definições › Claude › Relés do Claude). Os outros ficam de reserva, sem app nem Mac ligado.

Se o relé principal parar corretamente, o seguinte assume em um segundo. Se cair sem aviso, o seguinte assume um pedido sem resposta após 6 segundos, o terceiro após 12 segundos. Um pedido nunca é executado duas vezes. O registo indica o papel de cada máquina: «Relé ativo» ou «Em reserva».

Para que um relé de reserva assuma também os comandos, as suas regras devem permitir comandos (Definições › Máquinas CLI › a máquina › Regras). Caso contrário, só assume as leituras (hosts, snippets, sessões).

macOS: launchd

sudo konsolity service install

Instala o serviço launchd com.konsolity.cli, reiniciado automaticamente (KeepAlive). Os segredos são guardados nas Chaves. Os logs ficam no app Console.

Windows: tarefa agendada

Num PowerShell de administrador:

konsolity service install

Cria uma tarefa agendada que inicia o konsolity serve na inicialização do Windows e o reinicia após um erro.

Verificar

konsolity status

O status informa se a máquina está acessível, a idade do token, o escopo e o número de hosts acessíveis. A máquina aparece online na lista de máquinas CLI enquanto tiver dado sinal de vida no último minuto.

Pastas

Caminho Conteúdo
~/.config/konsolity/ Linux e macOS, uso sem serviço: config.json e segredos
%APPDATA%\Konsolity\cli\ Windows: config.json e credentials.bin
/etc/konsolity/ Serviço Linux: configuração
/var/lib/konsolity/ Serviço Linux: segredos criptografados e estado

O config.json (endereço do servidor, identificador e nome da máquina, escopo exibido) fica com permissão 0600. Ele não contém nenhum segredo.

Armazenamento dos segredos

Os segredos da máquina são o seu token e a sua chave de máquina. Eles são guardados de acordo com o sistema:

Sistema Armazenamento
macOS Chaves (item com.konsolity.cli)
Linux, como serviço systemd-creds encrypt, com o TPM quando a máquina tem um, caso contrário com a chave do host
Linux, sem systemd-creds arquivo credentials.bin com permissão 0600
Windows DPAPI (usuário atual) em credentials.bin, acesso restrito à própria conta

Em todos os casos, o conteúdo é antes criptografado com uma chave derivada do identificador da máquina: copiado para outro computador, ele fica ilegível. Os segredos nunca aparecem num log, num argumento de linha de comando nem numa variável de ambiente, exceto o KONSOLITY_TOKEN que você decide fornecer para um token de longa duração.

Rotação automática do token

O token de uma máquina é renovado automaticamente a cada 24 horas, sem interrupção: o token antigo continua aceito até a primeira chamada feita com o novo, por no máximo 10 minutos. Para forçar uma rotação (após restaurar um backup, após a intervenção de terceiros na máquina):

konsolity rotate

Os tokens de longa duração (setup-token) não têm rotação automática; eles expiram no máximo após um ano.

Remover o serviço

sudo konsolity service uninstall

O serviço é parado e removido. A máquina continua ativada na sua conta: para desconectá-la também, execute konsolity logout ou revogue-a na lista de máquinas CLI.