에이전트 설정
Windsurf에 Kilobat 설정하기
Cascade는 Kilobat MCP 서버를 통해 의존성이 다운로드되지 않는 이유를 찾고, DNS를 확인하고, Mac에서 경로를 추적할 수 있습니다.
CLI 설치
Kilobat CLI는 무료 오픈 소스이며 MCP 서버를 포함합니다. Homebrew로 설치하세요.
brew install seifip/kilobat/kilobatkilobat --version로 확인하세요. kilobat doctor는 Kilobat 앱이 실행 중인지, 네트워크 필터가 켜져 있는지, Pro가 활성화되어 있는지 알려줍니다. 도구는 앱 없이도 작동하며 앱을 사용하면 Wi-Fi 이름, 기록 및 규칙 적용 기능이 추가됩니다. CLI에는 macOS 14 이상이 필요합니다.
MCP 서버 연결
확인하려는 Mac에서 에이전트 백엔드와 Kilobat을 실행하세요. 클라우드 러너, Linux 서버 또는 컨테이너는 이 로컬 명령으로 Mac을 검사할 수 없습니다.
Cascade에서 MCP 메뉴를 열고 Open MCP config file을 선택합니다. 현재 빌드는
~/.config/devin/mcp_config.json에 저장하고 이전 Windsurf 빌드는~/.codeium/windsurf/mcp_config.json를 사용합니다.mcpServers아래에 Kilobat을 추가합니다.{ "mcpServers": { "kilobat": { "command": "kilobat", "args": [ "mcp" ] } } }MCP 메뉴에서 새로고침 버튼을 누릅니다. Cascade에 Kilobat 도구가 표시됩니다.
같은 앱의 최신 Devin Local 에이전트는 대신 Devin CLI의 구성을 읽습니다: devin mcp add -s user kilobat -- kilobat mcp.
Dock에서 연 앱은 셸에서 사용하는 PATH를 항상 볼 수 있는 것은 아닙니다. 서버가 시작되지 않으면 kilobat를 command -v kilobat이 출력하는 전체 경로로 바꾸세요. Apple silicon에서는 /opt/homebrew/bin/kilobat, Intel에서는 /usr/local/bin/kilobat입니다.
스킬 추가
9개의 Agent Skills는 에이전트가 Kilobat의 측정값을 읽고 설정을 변경하기 전에 묻도록 알려줍니다. skills.sh를 사용해 모든 프로젝트에 설치하세요.
npx skills add seifip/kilobat-skills -g -a windsurf이렇게 하면 ~/.codeium/windsurf/skills/에 설치됩니다. -g를 생략하면 현재 프로젝트에만 설치되며, 두 플래그를 모두 생략하면 목록에서 에이전트를 선택할 수 있습니다.
kilobat 스킬이 진입점입니다. 설정 및 안전 규칙을 담고 있으며 mac-network-troubleshooting 또는 mac-agent-runs처럼 적합한 스킬로 에이전트를 안내합니다. 9개 스킬 전체를 확인하세요.
이 프롬프트를 사용해 보세요
일상적인 말로 요청하세요. 에이전트가 도구를 선택합니다. 아래는 각 요청에 일반적으로 필요한 도구입니다.
| 묻기 | MCP 도구 |
|---|---|
| npm install이 registry.npmjs.org에서 멈춥니다. 문제가 발생한 계층을 찾아주세요. | diagnose_connection |
| 인터넷이 느린 것 같습니다. 이유를 찾아서 무엇부터 고쳐야 할지 알려주세요. | diagnose_network, get_status |
| 6 GB Docker 이미지를 다운로드하려고 합니다. 지금 해도 좋을까요, 아니면 데이터 제한 네트워크에 연결되어 있나요? | get_conditions |
| 페이지가 로드되기까지 오래 걸립니다. DNS 리졸버를 비교하고 전환하면 도움이 될지 알려 주세요. 아직 아무것도 변경하지 마세요. | benchmark_dns, diagnose_network |
| github.com까지 경로를 세 번 추적하고 지연이 시작되는 지점을 알려 주세요. | trace_route, get_route_history |
| 어떤 항목이 데이터를 많이 업로드하고 있습니다. 어떤 앱이며 지난 한 시간 동안 얼마나 전송했나요? | get_status, get_app_bandwidth |
Windsurf에서 변경할 수 있는 것과 없는 것
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의 변경 도구에 대한 Cascade의 도구 확인을 켜 두세요.
에이전트가 셸 명령도 실행할 수 있다면 kilobat CLI로 MCP 도구가 수행하는 작업을 할 수 있습니다. 스킬은 자유롭게 실행할 명령과 먼저 확인할 명령을 알려줍니다.
에이전트 실행 추적
Kilobat에는 아직 Windsurf 훅 설정이 없습니다. 훅이 없으면 Kilobat은 에이전트의 트래픽과 CPU를 기준으로 판단하므로 조용한 실행은 완료됐거나 사용자 입력을 기다리는 중일 수 있습니다. 자체 훅이 있는 에이전트는 kilobat agent-event start|working|waiting|done|failed --agent <name> --session <id> --cwd <folder>를 호출할 수 있습니다. 이 명령어는 아무것도 출력하지 않고 항상 0으로 종료됩니다. 직접 시도할 때 --verbose를 추가하면 결과를 볼 수 있습니다. 문서의 에이전트 연결을 참고하세요.
출처
2026년 10월 30일에 확인했습니다. 에이전트 설정은 자주 바뀝니다. 단계가 더 이상 일치하지 않으면 지원 주소로 알려주세요.
