Configuração do agente
Configure o Kilobat no Claude Code
Dê ao Claude Code ferramentas para acessar a rede do seu Mac: tráfego por app, Wi-Fi, DNS, por que um host falha e manter ativo. Seus hooks informam ao Kilobat quando uma execução trabalha, aguarda você ou termina.
Instale a CLI
A CLI do Kilobat é gratuita, de código aberto e inclui o servidor MCP. Instale-a com o Homebrew:
brew install seifip/kilobat/kilobatVerifique com kilobat --version. kilobat doctor informa se o app Kilobat está em execução, se o filtro de rede está ativado e se o Pro está ativo; as ferramentas funcionam sem o app, que acrescenta nomes de redes Wi-Fi, histórico e aplicação de regras. A CLI exige macOS 14 ou posterior.
Conecte o servidor MCP
Execute o backend do agente e o Kilobat no Mac que deseja verificar. Um executor na nuvem, servidor Linux ou contêiner não pode usar esse comando local para inspecionar seu Mac.
Adicione o servidor a todos os seus projetos. O
--separa as opções do Claude Code do comando que ele executa.claude mcp add --scope user kilobat -- kilobat mcpInicie uma nova sessão e execute
/mcp. O Kilobat aparece como conectado.
Sem --scope user, o servidor é adicionado apenas ao projeto atual, em ~/.claude.json. Com --scope project, ele é adicionado ao .mcp.json do projeto para compartilhar com sua equipe.
Adicione as skills
Nove Agent Skills ensinam o agente a ler as medições do Kilobat e a pedir autorização antes de alterar ajustes. Instale-as para todos os seus projetos com skills.sh:
npx skills add seifip/kilobat-skills -g -a claude-codeIsso as coloca em ~/.claude/skills/. Omita -g para instalá-las apenas no projeto atual ou omita as duas opções para escolher agentes em uma lista.
A skill kilobat é o ponto de entrada: ela contém as regras de configuração e segurança e encaminha o agente para a skill adequada, como mac-network-troubleshooting ou mac-agent-runs. Veja as nove skills.
Experimente estes prompts
Peça em linguagem comum. O agente escolhe as ferramentas; estas são as que cada solicitação costuma exigir.
| Perguntar | Ferramentas MCP |
|---|---|
| A internet parece lenta. Descubra por quê e diga o que devo corrigir primeiro. | diagnose_network, get_status |
| npm install fica travado em registry.npmjs.org. Descubra qual camada está falhando. | diagnose_connection |
| Vou baixar uma imagem Docker de 6 GB. Este é um bom momento ou estou em uma rede com limite de dados? | get_conditions |
| Mantenha o Mac ativo pelas próximas duas horas enquanto executa toda a suíte de testes e depois libere-o. | keep_awake, release_awake |
| As execuções dos meus agentes hoje terminaram ou alguma travou ou perdeu a conexão? | list_sessions |
| Algum app está enviando muitos dados. Qual é e quanto enviou na última hora? | get_status, get_app_bandwidth |
| Minhas videochamadas travam embora os testes de velocidade pareçam normais. Verifique se há picos de latência. | run_stutter_test, get_nearby_radios |
O que o Claude Code pode e não pode alterar
O servidor MCP do Kilobat marca cada ferramenta como somente leitura ou de alteração, e a descrição de cada ferramenta de alteração orienta o agente a pedir sua confirmação primeiro. A skill kilobat segue a mesma regra: ler livremente e perguntar antes de alterar.
Medições somente de leitura
- Meça a latência do Wi-Fi, do roteador, da internet e do DNS, além do tráfego por app:
diagnose_network,get_status,get_wifi,scan_wifi. - Encontre a camada que impede a conexão com um host, rastreie uma rota e compare resolvedores:
diagnose_connection,trace_route,benchmark_dns. - Consulte histórico, sessões, regras e aprovações:
get_usage_report,list_sessions,list_rules,list_approvals. - Verifique todos os hosts contatados pelo agente e pelos comandos que ele executou, com bytes e sinalizações:
agent_network_log. - Use
run_stutter_testpara verificar picos de latência; ele envia apenas pings.
Pergunta antes
- Um teste de velocidade, que usa até 80 MB (
run_speedtest; em uma rede com limite de dados, 10 MB ou menos), e um teste de LAN de cinco segundos (run_lan_test). - Consultar seu IP público com a Cloudflare (
get_exit_pathcompublic_ip). - Perfis, regras de apps, hosts bloqueados, modo para novos apps, orçamentos, cotas, custo de dados de uma rede e pausa de atualizadores (
set_profile,set_app_rule,block_destination,set_new_app_mode,set_budget,set_app_quota,set_network_cost,set_updater_pause). - Suspender o envio de outro app, como o Dropbox, até haver uma rede melhor (
hold_upload). - DNS, que o macOS também protege com uma solicitação de senha de administrador (
set_dns). - Manter o Mac funcionando com a tampa fechada, todas as vezes (
keep_awakecomlid_closed). Umkeep_awakesimples não altera ajustes e termina quando expira.
Não pode fazer
- Permitir que um app em espera se conecte por conta própria:
decide_approvalpode bloquear imediatamente, mas permitir abre a janela de aprovação do Kilobat para você confirmar. - Alterar a visibilidade do AirDrop:
set_airdrop_visibilityabre os Ajustes do Sistema para você. - Alterar os ajustes de repouso, os ajustes de outro app ou qualquer coisa fora do Kilobat. Ele nunca lê prompts ou respostas.
- Aplicar regras sem o app Kilobat e seu filtro de rede (Pro). Sem eles, as regras são salvas, mas não aplicadas, e o agente deve informar isso.
O Claude Code pergunta antes de chamar uma ferramenta MCP, a menos que uma regra de permissão permita. Para pular a confirmação apenas para leituras, permita ferramentas pelo nome, como mcp__kilobat__diagnose_network, e mantenha a confirmação para as ferramentas do Kilobat que fazem alterações.
Se o agente também puder executar comandos do shell, a CLI kilobat poderá fazer o que as ferramentas MCP fazem. As skills informam quais comandos ele pode executar livremente e sobre quais deve perguntar.
Acompanhe as execuções do agente
Adicione estes itens a ~/.claude/settings.json, integrando-os aos hooks que você já tem. Cada hook recebe no stdin um JSON com o ID da sessão e a pasta, que --stdin-json lê. Uma solicitação de permissão ou de entrada significa espera; Stop significa conclusão após o término das tarefas em segundo plano; um limite de frequência significa espera até sua redefinição.
{
"hooks": {
"SessionStart": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent claude --stdin-json" }] }],
"UserPromptSubmit": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent claude --stdin-json" }] }],
"Notification": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent claude --stdin-json" }] }],
"Stop": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent claude --stdin-json" }] }],
"StopFailure": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent claude --stdin-json" }] }],
"SessionEnd": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent claude --stdin-json" }] }]
}
}Fontes
- Documentação do Claude Code: conectar o Claude Code a ferramentas via MCP
- Documentação do Claude Code: referência de hooks
- Documentação do Kilobat: agentes de IA e MCP
- skills.sh: agentes compatíveis e suas pastas de skills
Verificado em 30 de outubro de 2026. Os agentes alteram seus ajustes com frequência; se uma etapa não corresponder mais, avise-nos pelo endereço de suporte.
