Kilobat com qualquer cliente MCP

Instale a CLI

A CLI do Kilobat é gratuita, de código aberto e inclui o servidor MCP. Instale-a com o Homebrew:

Verifique 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.

1. Aponte seu cliente para este comando. Ele usa MCP por stdin e stdout.

   kilobat mcp

2. A maioria dos clientes lê um objeto mcpServers como este:

   {
     "mcpServers": {
       "kilobat": {
         "command": "kilobat",
         "args": [
           "mcp"
         ]
       }
     }
   }

3. O Grok Build CLI, por exemplo, o adiciona com um comando:

   grok mcp add kilobat -- kilobat mcp

Um app aberto pelo Dock nem sempre vê o PATH usado pelo seu shell. Se o servidor não iniciar, substitua kilobat pelo caminho completo que command -v kilobat imprime: /opt/homebrew/bin/kilobat no Apple silicon e /usr/local/bin/kilobat no Intel.

O servidor disponibiliza ferramentas com anotações completas (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) e retorna o mesmo JSON que a CLI. A documentação lista todas as ferramentas.

Adicione as skills

Nove Agent Skills ensinam o agente a ler as medições do Kilobat e a perguntar antes de alterar ajustes. Instale-as com skills.sh, que pergunta para quais agentes instalá-las:

npx skills add seifip/kilobat-skills

Para um cliente que o skills.sh não conhece, copie as pastas de github.com/seifip/kilobat-skills para onde ele lê skills. Cada skill é uma pasta com um SKILL.md.

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.

O que o agente 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_test para 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_path com public_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_awake com lid_closed). Um keep_awake simples 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_approval pode bloquear imediatamente, mas permitir abre a janela de aprovação do Kilobat para você confirmar.
• Alterar a visibilidade do AirDrop: set_airdrop_visibility abre 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.

Mantenha a confirmação do cliente ativada para ferramentas que fazem alterações; nunca as aprove automaticamente.

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

Um agente com hooks próprios pode informar ao Kilobat quando uma execução começa, está esperando por você ou termina chamando kilobat agent-event start|working|waiting|done|failed --agent <name> --session <id> --cwd <folder>. O comando não imprime nada e sempre retorna 0, então não interrompe o agente; adicione --verbose ao testá-lo manualmente. Há hooks prontos para Claude Code, Codex, Gemini CLI e Cline. Sem hooks, o Kilobat usa o tráfego e a CPU do agente.

Fontes

• Model Context Protocol
• Documentação da xAI: servidores MCP no Grok Build
• 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.

Outros agentes

Claude Code Dê ao Claude Code ferramentas para a rede do Mac: tráfego por app, Wi-Fi, DNS, diagnóstico de falhas de conexão com hosts e manutenção do Mac ativo. Configurar o Claude Code → Codex CLI O Codex pode verificar a rede antes de um download grande, descobrir por que sua própria solicitação trava e manter o Mac ativo durante uma tarefa longa. Configurar Codex CLI → Cursor Permita que o agente do Cursor veja por que um download de pacote trava, qual app usa a conexão e se a rede tem limite de dados antes de um grande pull. Configurar Cursor → Gemini CLI O Gemini CLI pode diagnosticar a rede do Mac, analisar o Wi-Fi e manter o Mac ativo enquanto trabalha. Configurar Gemini CLI → Claude Desktop Pergunte ao Claude por que o Wi-Fi está lento, o que consumiu os dados do acesso pessoal ou se a VPN transporta todo o tráfego, e ele lê a resposta do seu Mac. Configurar Claude Desktop → Windsurf O Cascade pode descobrir por que uma dependência não baixa, verificar o DNS e rastrear uma rota a partir do Mac usando o servidor MCP do Kilobat. Configurar Windsurf → Cline O Cline pode verificar a rede do Mac e mantê-lo ativo enquanto trabalha. Configurar Cline → Zed O agente do Zed pode medir a rede do Mac, rastrear uma rota e comparar resolvedores de DNS pelo servidor MCP do Kilobat. Configurar Zed → Hermes Agent Dê ao Hermes Agent acesso às medições de rede e ao diagnóstico de conexão do Mac e às ferramentas para mantê-lo ativo por meio de um servidor MCP local. Configurar Hermes Agent → OpenClaw Permita que o OpenClaw verifique a conexão e o uso de dados do Mac com ferramentas MCP locais e skills do Kilobat. Configurar OpenClaw → OpenCode O OpenCode pode inspecionar o tráfego do Mac, explicar conexões que falharam e manter o Mac ativo durante tarefas longas com o Kilobat. Configurar OpenCode → GitHub Copilot CLI O Copilot CLI pode verificar a largura de banda, o DNS e downloads malsucedidos no Mac usando o servidor MCP local do Kilobat. Configurar GitHub Copilot CLI →