Serviço e armazenamento
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.servicecom 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/homedo 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.