---
title: "Kilobat no Codex CLI: servidor MCP em config.toml e hook notify | Kilobat"
url: "https://kilobat.app/pt/agents/codex"
description: "Conecte o servidor MCP do Kilobat ao OpenAI Codex CLI com codex mcp add ou config.toml, adicione as skills e informe ao Kilobat quando um turno do Codex terminar."
---

Configuração do agente

# Configure o Kilobat no Codex CLI

O Codex pode verificar a rede antes de um download grande, descobrir por que sua própria solicitação fica travada e manter o Mac ativo durante uma tarefa longa. Uma linha em config.toml informa ao Kilobat quando um turno termina.

CLI e servidor MCP gratuitos · macOS 14 ou posterior · Verificado em: 30 de outubro 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 o servidor pelo Terminal:

   ```
   codex mcp add kilobat -- kilobat mcp
   ```
2. Ou adicione-o a `~/.codex/config.toml` por conta própria. Um tempo limite maior para ferramentas dá espaço para testes de velocidade e de interrupções.

   ```
   [mcp_servers.kilobat]
   command = "kilobat"
   args = ["mcp"]
   tool_timeout_sec = 120
   ```

Um `.codex/config.toml` em um projeto confiável adiciona o servidor apenas para esse projeto.

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

Isso as coloca em `~/.agents/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 |
|---|---|
| npm install fica travado em registry.npmjs.org. Descubra qual camada está falhando. | `diagnose_connection` |
| A internet parece lenta. Descubra por quê e diga o que devo corrigir primeiro. | `diagnose_network`, `get_status` |
| 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` |
| Rastreie a rota até github.com três vezes e diga onde começa a demora. | `trace_route`, `get_route_history` |
| As execuções dos meus agentes hoje terminaram ou alguma travou ou perdeu a conexão? | `list_sessions` |

## O que o Codex CLI 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 Codex mostra as ferramentas do Kilobat com suas anotações; mantenha os pedidos de aprovação ativos para as ferramentas 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

Mais simples: `notify` em `~/.codex/config.toml`. O Codex passa um argumento JSON após cada turno, que `--json-arg` lê. Ele só informa que terminou, e o Codex executa um único programa `notify`.

```
notify = ["kilobat", "agent-event", "done", "--agent", "codex", "--json-arg"]
```

Para informar espera também, use hooks do Codex em `~/.codex/hooks.json` e confie neles com `/hooks`:

```
{
  "hooks": {
    "SessionStart": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent codex --stdin-json" }] }],
    "UserPromptSubmit": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent codex --stdin-json" }] }],
    "PermissionRequest": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent codex --stdin-json" }] }],
    "Stop": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent codex --stdin-json" }] }]
  }
}
```

## Fontes

- [Documentação do OpenAI Codex: Model Context Protocol](https://developers.openai.com/codex/mcp)
- [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 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](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.
- [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.
- [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.