---
title: "Kilobat no Hermes Agent: servidor MCP local e skills | Kilobat"
url: "https://kilobat.app/pt/agents/hermes"
description: "Conecte o Hermes Agent ao Kilobat no Mac: configuração MCP local, skills, verificações de conexão e acompanhamento explícito de execuções."
---

Configuração do agente

# Configure o Kilobat no 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.

CLI e servidor MCP gratuitos · macOS 14 ou posterior · Verificado: 1 de novembro de 2026

## 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/kilobat
```

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. Adicione esta entrada a `~/.hermes/config.yaml`, mantendo seus outros servidores.

   ```
   mcp_servers:
     kilobat:
       command: kilobat
       args: [mcp]
   ```
2. Verifique se o servidor inicia e lista suas ferramentas.

   ```
   hermes mcp test kilobat
   ```
3. Inicie uma nova sessão do Hermes ou execute `/reload-mcp` na sessão que deve usar o Kilobat.

## 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](https://skills.sh/seifip/kilobat-skills):

```
npx skills add seifip/kilobat-skills -g -a hermes-agent
```

Isso as coloca em `~/.hermes/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](https://kilobat.app/pt/docs/agents#network-troubleshooting-skill).

## 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` |
| 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` |
| Minha VPN transporta todo o meu tráfego ou apenas parte dele? | `get_exit_path` |
| O que usou os dados do meu acesso pessoal hoje, app por app? | `get_usage_report`, `get_status` |

## O que o Hermes Agent 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](https://github.com/seifip/kilobat-skills/tree/main/skills/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 ativada para alterações. O Hermes descobre as ferramentas do Kilobat, mas o agente ainda precisa pedir autorização antes de aplicar regras, alterar o DNS ou usar o modo com a tampa fechada.

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

O Hermes Agent ainda não tem um adaptador de execução do Kilobat pronto. Conectar o MCP não acompanha automaticamente seu estado de trabalho, espera ou conclusão. Um hook personalizado pode chamar `kilobat agent-event start|working|waiting|done|failed --agent hermes --session <id> --cwd <folder>`. Consulte [Conectar agentes](https://kilobat.app/pt/docs/agents#connect-agents).

## Fontes

- [Hermes Agent: configuração e teste do MCP](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp)
- [Hermes Agent: skills](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills)
- [Documentação do Kilobat: agentes de IA e MCP](https://kilobat.app/pt/docs/agents#agents)
- [skills.sh: agentes compatíveis e suas pastas de skills](https://github.com/vercel-labs/skills/blob/main/docs/agents.md)

Verificado em 1º de novembro de 2026. Os agentes mudam suas configurações com frequência; se alguma etapa não corresponder mais, avise-nos pelo endereço de suporte.

## Outros agentes

- [Claude Code](https://kilobat.app/pt/agents/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.
- [Codex CLI](https://kilobat.app/pt/agents/codex): 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.
- [Cursor](https://kilobat.app/pt/agents/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.
- [Gemini CLI](https://kilobat.app/pt/agents/gemini-cli): O Gemini CLI pode diagnosticar a rede do Mac, analisar o Wi-Fi e manter o Mac ativo enquanto trabalha.
- [Claude Desktop](https://kilobat.app/pt/agents/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.
- [Windsurf](https://kilobat.app/pt/agents/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.
- [Cline](https://kilobat.app/pt/agents/cline): O Cline pode verificar a rede do Mac e mantê-lo ativo enquanto trabalha.
- [Zed](https://kilobat.app/pt/agents/zed): O agente do Zed pode medir a rede do Mac, rastrear uma rota e comparar resolvedores de DNS pelo servidor MCP do Kilobat.
- [OpenClaw](https://kilobat.app/pt/agents/openclaw): Permita que o OpenClaw verifique a conexão e o uso de dados do Mac com ferramentas MCP locais e skills do Kilobat.
- [OpenCode](https://kilobat.app/pt/agents/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.
- [GitHub Copilot CLI](https://kilobat.app/pt/agents/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.
- [Qualquer cliente MCP](https://kilobat.app/pt/agents/mcp-client): O servidor MCP do Kilobat é um comando stdio local, kilobat mcp.