에이전트 설정

모든 MCP 클라이언트에서 Kilobat 사용하기

Kilobat MCP 서버는 로컬 stdio 명령 kilobat mcp입니다. 로컬 서버를 시작하는 모든 클라이언트에서 API 키나 열린 포트 없이 사용할 수 있습니다.

무료 CLI 및 MCP 서버macOS 14 이상확인일: 2026년 10월 30일

CLI 설치

Kilobat CLI는 무료 오픈 소스이며 MCP 서버를 포함합니다. Homebrew로 설치하세요.

$ brew install seifip/kilobat/kilobat

kilobat --version로 확인하세요. kilobat doctor는 Kilobat 앱이 실행 중인지, 네트워크 필터가 켜져 있는지, Pro가 활성화되어 있는지 알려줍니다. 도구는 앱 없이도 작동하며 앱을 사용하면 Wi-Fi 이름, 기록 및 규칙 적용 기능이 추가됩니다. CLI에는 macOS 14 이상이 필요합니다.

MCP 서버 연결

확인하려는 Mac에서 에이전트 백엔드와 Kilobat을 실행하세요. 클라우드 러너, Linux 서버 또는 컨테이너는 이 로컬 명령으로 Mac을 검사할 수 없습니다.

클라이언트가 이 명령을 사용하도록 지정하세요. stdin과 stdout을 통해 MCP로 통신합니다.
```
kilobat mcp
```

대부분의 클라이언트는 다음과 같은 mcpServers 객체를 읽습니다:

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

예를 들어 Grok Build CLI에서는 명령 하나로 추가합니다:
```
grok mcp add kilobat -- kilobat mcp
```

Dock에서 연 앱은 셸에서 사용하는 PATH를 항상 볼 수 있는 것은 아닙니다. 서버가 시작되지 않으면 kilobat를 command -v kilobat이 출력하는 전체 경로로 바꾸세요. Apple silicon에서는 /opt/homebrew/bin/kilobat, Intel에서는 /usr/local/bin/kilobat입니다.

서버는 전체 주석(readOnlyHint, destructiveHint, idempotentHint, openWorldHint)이 달린 도구를 제공하고 CLI와 동일한 JSON을 반환합니다. 문서에 모든 도구가 나열되어 있습니다.

스킬 추가

9개의 Agent Skills는 Kilobat의 측정값을 읽고 설정을 변경하기 전에 확인하도록 에이전트에 알려 줍니다. skills.sh로 설치하면 설치할 에이전트를 선택할 수 있습니다:

npx skills add seifip/kilobat-skills

skills.sh가 모르는 클라이언트의 경우 github.com/seifip/kilobat-skills에서 스킬을 읽는 위치로 폴더를 복사하세요. 각 스킬은 SKILL.md이 있는 폴더입니다.

kilobat 스킬이 진입점입니다. 설정 및 안전 규칙을 담고 있으며 mac-network-troubleshooting 또는 mac-agent-runs처럼 적합한 스킬로 에이전트를 안내합니다. 9개 스킬 전체를 확인하세요.

이 프롬프트를 사용해 보세요

일상적인 말로 요청하세요. 에이전트가 도구를 선택합니다. 아래는 각 요청에 일반적으로 필요한 도구입니다.

묻기	MCP 도구
인터넷이 느린 것 같습니다. 이유를 찾아서 무엇부터 고쳐야 할지 알려주세요.	`diagnose_network`, `get_status`
이 방에서는 Wi-Fi 신호가 약합니다. 채널이 혼잡한가요? 라우터는 어떤 채널을 사용해야 하나요?	`get_wifi`, `scan_wifi`, `suggest_wifi_channel`
npm install이 registry.npmjs.org에서 멈춥니다. 문제가 발생한 계층을 찾아주세요.	`diagnose_connection`
오늘 핫스팟 데이터를 사용한 앱과 앱별 사용량은 얼마인가요?	`get_usage_report`, `get_status`
속도 테스트 결과는 괜찮은데 영상 통화가 끊깁니다. 지연 시간이 급증하는지 확인해 주세요.	`run_stutter_test`, `get_nearby_radios`
휴대폰 핫스팟을 사용 중입니다. Kilobat이 어떤 업데이트 프로그램을 일시 중지하며 이 기능을 켜야 할까요?	`get_conditions`, `get_updaters`, `set_updater_pause`
연결 승인을 기다리는 앱은 무엇이고 누가 서명했나요?	`list_approvals`

에이전트가 변경할 수 있는 것과 없는 것

Kilobat의 MCP 서버는 모든 도구를 읽기 전용 또는 변경 도구로 표시하며, 각 변경 도구의 설명에는 에이전트가 먼저 확인을 받도록 안내합니다. kilobat 스킬에도 같은 규칙이 있습니다. 읽기는 자유롭게 하고 변경 전에는 묻습니다.

읽기 전용 측정

Wi-Fi, 라우터, 인터넷 및 DNS 지연 시간과 앱별 트래픽 측정: diagnose_network, get_status, get_wifi, scan_wifi.
특정 호스트를 막는 계층을 찾고, 경로를 추적하고, 리졸버 비교: diagnose_connection, trace_route, benchmark_dns.
기록, 세션, 규칙 및 승인 읽기: get_usage_report, list_sessions, list_rules, list_approvals.
에이전트와 실행한 명령이 접속한 모든 호스트를 바이트 및 플래그와 함께 확인: agent_network_log.
run_stutter_test로 지연 시간 급증을 확인합니다. 이 도구는 ping만 전송합니다.

먼저 확인하는 작업

최대 80 MB를 사용하는 속도 테스트(run_speedtest, 데이터 제한 네트워크에서는 10 MB 이하)와 5초 LAN 테스트(run_lan_test).
Cloudflare로 공인 IP 조회(public_ip를 사용하는 get_exit_path).
프로필, 앱 규칙, 차단된 호스트, 새 앱 모드, 데이터 한도, 할당량, 네트워크의 데이터 비용 및 업데이터 일시 정지(set_profile, set_app_rule, block_destination, set_new_app_mode, set_budget, set_app_quota, set_network_cost, set_updater_pause).
더 좋은 네트워크에 연결할 때까지 Dropbox 같은 다른 앱의 업로드 보류(hold_upload).
DNS 변경. macOS에서도 관리자 암호를 요청하여 보호합니다(set_dns).
덮개를 닫은 상태에서 Mac을 계속 실행할 때마다 확인합니다(lid_closed를 사용하는 keep_awake). 일반 keep_awake는 설정을 변경하지 않으며 시간이 만료되면 종료됩니다.

할 수 없는 작업

대기 중인 앱이 자동으로 연결되도록 허용: decide_approval는 즉시 차단할 수 있지만 허용하려면 Kilobat의 승인 창이 열려 직접 확인해야 합니다.
AirDrop 공개 범위 변경: set_airdrop_visibility는 시스템 설정을 엽니다.
잠자기 설정, 다른 앱의 설정 또는 Kilobat 외부의 항목 변경. 프롬프트나 응답은 읽지 않습니다.
Kilobat 앱과 네트워크 필터(Pro) 없이 규칙 적용. 이들이 없으면 규칙은 저장되지만 적용되지 않으며 에이전트가 이를 알려야 합니다.

클라이언트에서 변경 도구의 확인을 켜 두고 자동 승인하지 마세요.

에이전트가 셸 명령도 실행할 수 있다면 kilobat CLI로 MCP 도구가 수행하는 작업을 할 수 있습니다. 스킬은 자유롭게 실행할 명령과 먼저 확인할 명령을 알려줍니다.

에이전트 실행 추적

자체 훅이 있는 에이전트는 kilobat agent-event start|working|waiting|done|failed --agent <name> --session <id> --cwd <folder>를 호출하여 실행 시작, 입력 대기 또는 완료를 Kilobat에 알릴 수 있습니다. 아무것도 출력하지 않고 항상 0으로 종료되므로 에이전트가 중단되지 않습니다. 직접 시도할 때는 --verbose를 추가하세요. Claude Code, Codex, Gemini CLI, Cline용 훅이 준비되어 있습니다. 훅이 없으면 Kilobat은 에이전트의 트래픽과 CPU를 기준으로 판단합니다.

출처

2026년 10월 30일에 확인했습니다. 에이전트 설정은 자주 바뀝니다. 단계가 더 이상 일치하지 않으면 지원 주소로 알려주세요.

다른 에이전트

Claude Code Claude Code에서 Mac의 네트워크를 도구로 사용하세요. 앱별 트래픽, Wi-Fi, DNS, 호스트 연결 실패 원인과 잠자기 방지를 이용할 수 있습니다. Claude Code 설정 → Codex CLI Codex는 대용량 다운로드 전에 네트워크를 확인하고, 자신의 요청이 멈추는 이유를 찾으며, 긴 작업 중 Mac의 잠자기를 방지할 수 있습니다. Codex CLI 설정 → Cursor Cursor 에이전트가 패키지 다운로드가 멈추는 이유와 연결을 사용 중인 앱을 파악하고, 대용량 다운로드 전에 네트워크의 데이터 제한 여부를 확인하도록 하세요. Cursor 설정 → Gemini CLI Gemini CLI는 Mac의 네트워크를 진단하고 Wi-Fi를 검색하며 작업 중 Mac의 잠자기를 방지할 수 있습니다. Gemini CLI 설정 → Claude Desktop Claude에게 Wi-Fi가 느린 이유, 핫스팟 데이터를 사용한 항목 또는 VPN이 모든 트래픽을 전달하는지 물어보세요. Mac에서 답을 읽어옵니다. Claude Desktop 설정 → Windsurf Cascade는 Kilobat의 MCP 서버를 통해 의존성이 다운로드되지 않는 이유를 찾고, DNS를 확인하고, Mac에서 경로를 추적할 수 있습니다. Windsurf 설정 → Cline Cline은 Mac의 네트워크를 확인하고 작업 중 잠자기를 방지할 수 있습니다. Cline 설정 → Zed Zed 에이전트는 Kilobat의 MCP 서버를 통해 Mac의 네트워크를 측정하고 경로를 추적하며 DNS 리졸버를 비교할 수 있습니다. Zed 설정 → Hermes Agent 로컬 MCP 서버를 통해 Hermes Agent에 Mac의 네트워크 측정, 연결 진단 및 잠자기 방지 도구를 제공하세요. Hermes Agent 설정 → OpenClaw 로컬 MCP 도구와 Kilobat 스킬로 OpenClaw가 Mac의 연결 및 데이터 사용량을 확인하도록 하세요. OpenClaw 설정 → OpenCode OpenCode는 Kilobat으로 Mac의 트래픽을 살펴보고 연결 실패를 설명하며 긴 작업 중 잠자기를 방지할 수 있습니다. OpenCode 설정 → GitHub Copilot CLI Copilot CLI는 Kilobat의 로컬 MCP 서버를 사용해 Mac의 대역폭, DNS 및 다운로드 실패를 확인할 수 있습니다. GitHub Copilot CLI 설정 →