Claude Desktop에 Kilobat 설정하기

CLI 설치

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

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

MCP 서버 연결

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

1. 해당 파일이 포함된 릴리스가 나오면 가장 간단한 방법은 최신 CLI 릴리스에서 kilobat-mcp-<version>.mcpb를 다운로드하고 이중 클릭하는 것입니다. Claude Desktop에 설치 대화상자가 표시됩니다. 확장 프로그램에 CLI가 포함되어 있으므로 Homebrew가 필요하지 않습니다.

2. 그렇지 않으면 위와 같이 Homebrew로 CLI를 설치한 다음 Claude › Settings › Developer › Edit Config를 여세요. 그러면 ~/Library/Application Support/Claude/claude_desktop_config.json가 열립니다.

3. command -v kilobat가 출력하는 CLI의 전체 경로를 사용해 Kilobat을 추가하세요. Intel Mac에서는 /usr/local/bin/kilobat입니다.

   {
     "mcpServers": {
       "kilobat": {
         "command": "/opt/homebrew/bin/kilobat",
         "args": [
           "mcp"
         ]
       }
     }
   }

4. Claude Desktop을 완전히 종료한 다음 다시 여세요. Kilobat이 메시지 상자의 + 메뉴에서 Connectors 아래에 표시됩니다.

연결되지 않으면 ~/Library/Logs/Claude/mcp-server-kilobat.log를 읽어보세요.

스킬 추가

Claude Desktop은 디스크의 폴더에서 스킬을 읽지 않습니다. github.com/seifip/kilobat-skills에서 skills/kilobat부터 스킬 폴더를 다운로드하고 압축한 다음 Customize › Skills에서 + 버튼으로 업로드하세요. 스킬에는 코드 실행이 필요하며 Settings › Capabilities에서 설정할 수 있습니다.

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

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

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

Claude Desktop에서 변경할 수 있는 것과 없는 것

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) 없이 규칙 적용. 이들이 없으면 규칙은 저장되지만 적용되지 않으며 에이전트가 이를 알려야 합니다.

Claude Desktop은 커넥터 도구를 사용하기 전에 확인합니다. Kilobat의 변경 도구는 하나씩 승인하세요.

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

에이전트 실행 추적

Claude Desktop은 코딩 에이전트가 아니므로 Kilobat이 추적할 실행이 없습니다. keep_awake로 Claude에 잠시 Mac의 잠자기를 방지해 달라고 요청하세요. Claude Code에는 에이전트 실행을 위한 훅이 있습니다.

출처

• Model Context Protocol 문서: 로컬 MCP 서버에 연결
• Claude 도움말 센터: Claude에서 스킬 사용
• Kilobat CLI 릴리스
• Kilobat 문서: AI 에이전트와 MCP
• skills.sh: 지원되는 에이전트 및 스킬 폴더

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 설정 → 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 설정 → 모든 MCP 클라이언트 Kilobat의 MCP 서버는 로컬 stdio 명령인 kilobat mcp입니다. MCP 클라이언트 설정 →