---
title: "Kilobat no Claude Desktop: extensão para desktop ou claude_desktop_config.json | Kilobat"
url: "https://kilobat.app/pt/agents/claude-desktop"
description: "Conecte o Kilobat ao app Claude para Mac usando a extensão .mcpb ou claude_desktop_config.json, adicione as skills e pergunte ao Claude por que seu Wi-Fi está lento."
---

Configuração do agente

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

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. A opção mais simples, quando uma versão incluir a extensão: baixe `kilobat-mcp-<version>.mcpb` na [versão mais recente da CLI](https://github.com/seifip/kilobat-cli/releases/latest) e clique duas vezes. O Claude Desktop mostra uma caixa de instalação. A extensão inclui sua própria cópia da CLI, portanto não precisa do Homebrew.
2. Caso contrário, instale a CLI com o Homebrew, conforme indicado acima, e abra Claude › Settings › Developer › Edit Config. Isso abre `~/Library/Application Support/Claude/claude_desktop_config.json`.
3. Adicione o Kilobat com o caminho completo da CLI, que `command -v kilobat` imprime. Em um Mac Intel, é `/usr/local/bin/kilobat`.

   ```
   {
     "mcpServers": {
       "kilobat": {
         "command": "/opt/homebrew/bin/kilobat",
         "args": [
           "mcp"
         ]
       }
     }
   }
   ```
4. Encerre o Claude Desktop completamente e abra-o novamente. O Kilobat aparece em Conectores no menu + da caixa de mensagem.

Se não conectar, leia `~/Library/Logs/Claude/mcp-server-kilobat.log`.

## Adicione as skills

O Claude Desktop não lê skills de uma pasta no disco. Baixe uma pasta de skill em [github.com/seifip/kilobat-skills](https://github.com/seifip/kilobat-skills), começando por `skills/kilobat`, compacte-a em ZIP e envie em Customize › Skills usando o botão +. As skills precisam de execução de código, disponível em Settings › Capabilities.

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` |
| O Wi-Fi está fraco neste cômodo. O canal está congestionado e qual canal o roteador deveria usar? | `get_wifi`, `scan_wifi`, `suggest_wifi_channel` |
| 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 usou os dados do meu acesso pessoal hoje, app por app? | `get_usage_report`, `get_status` |
| Minha operadora informa que usei 40 GB no mês passado. Compare isso com o que o Kilobat registrou. | `compare_usage` |
| Minha VPN transporta todo o meu tráfego ou apenas parte dele? | `get_exit_path` |
| Quais apps aguardam aprovação para conectar e quem os assinou? | `list_approvals` |

## O que o Claude Desktop 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 Claude Desktop pede confirmação antes de usar a ferramenta de um conector. Aprove uma por vez 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

O Claude Desktop não é um agente de programação, então não há execuções para o Kilobat acompanhar. Peça ao Claude para manter o Mac ativo por algum tempo com `keep_awake`; o Claude Code tem [hooks](https://kilobat.app/pt/agents/claude-code#hooks) para execuções de agentes.

## Fontes

- [Documentação do Model Context Protocol: conectar a servidores MCP locais](https://modelcontextprotocol.io/docs/develop/connect-local-servers)
- [Central de Ajuda do Claude: usar skills no Claude](https://support.claude.com/en/articles/12512180-using-skills-in-claude)
- [Versões da CLI do Kilobat](https://github.com/seifip/kilobat-cli/releases/latest)
- [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.
- [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.
- [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.