---
title: "Kilobat no OpenCode: configuração MCP local e skills de agente | Kilobat"
url: "https://kilobat.app/pt/agents/opencode"
description: "Configure o Kilobat no OpenCode com um comando MCP local, confirmações de ferramentas e skills para diagnosticar problemas de rede no Mac."
---

Configuração do agente

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

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. Mescle isto em `opencode.json` do projeto ou em seu `~/.config/opencode/opencode.json` global.

   ```
   {
     "mcp": {
       "kilobat": {
         "type": "local",
         "command": ["kilobat", "mcp"],
         "enabled": true
       }
     },
     "permission": { "kilobat_*": "ask" }
   }
   ```
2. Confira o servidor configurado e inicie uma nova sessão do OpenCode.

   ```
   opencode mcp list
   ```

O exemplo segue a documentação estável atual do OpenCode. O OpenCode v2 usa `mcp.servers` e `disabled`; use a documentação da versão se for essa que você executa.

## 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 opencode
```

Isso as coloca em `~/.config/opencode/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` |
| Algum app está enviando muitos dados. Qual é e quanto enviou na última hora? | `get_status`, `get_app_bandwidth` |
| As páginas demoram para começar a carregar. Compare os resolvedores de DNS e diga se trocar ajudaria. Ainda não altere nada. | `benchmark_dns`, `diagnose_network` |

## O que o OpenCode 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.

O exemplo pede confirmação antes de cada ferramenta do Kilobat. Ao restringir essa política, mantenha a confirmação para alterações; anotações MCP, por si só, não são uma regra de permissão.

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 Kilobat reconhece o processo do OpenCode para acompanhar a atividade com base em tráfego e CPU. Um processo sem atividade pode estar aguardando ou ter terminado. O Kilobat não tem um adaptador de hook pronto para OpenCode; integrações personalizadas podem usar `kilobat agent-event`. Consulte [Conectar agentes](https://kilobat.app/pt/docs/agents#connect-agents).

## Fontes

- [OpenCode: servidores MCP](https://opencode.ai/docs/mcp-servers/)
- [OpenCode: permissões](https://opencode.ai/docs/permissions/)
- [OpenCode v2: servidores MCP](https://dev.opencode.ai/v2/docs/mcp-servers/)
- [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.
- [Hermes Agent](https://kilobat.app/pt/agents/hermes): 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.
- [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.
- [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.