레시피

한 사이트 또는 API에 연결되지 않는 이유 찾기

인터넷은 작동하지만 특정 주소가 실패하면 Kilobat이 각 계층을 차례로 확인합니다. 실패한 계층과 다음에 할 일을 알려줍니다.

앱과 CLI에서 무료확인일: 2026년 10월 29일

앱에서

  1. 대시보드를 열고 상태 탭을 클릭하세요.

  2. ‘연결되지 않는 이유는?’을 찾으세요.

  3. 실패하는 정확한 주소를 필드에 붙여 넣으세요. 예: github.com 또는 전체 URL.

  4. 한 앱에서만 문제가 있다면 해당 앱을 선택하세요. Kilobat이 앱 자체 프록시와 열린 연결도 확인합니다.

  5. 확인을 클릭하세요. 실패한 단계와 다음 단계를 확인하세요.

CLI로 사용

  1. 호스트 하나를 확인합니다.

    kilobat why api.example.com

    출력 각 계층의 정상, 경고, 실패 또는 건너뜀 상태와 판정 및 다음 단계. 계층이 실패하면 명령어가 1로 종료됩니다.

  2. 앱이 사용하는 정확한 URL을 확인합니다. 출력에서 쿼리 값은 숨겨집니다.

    kilobat why https://example.com/file.zip --app com.example.App

  3. 앱이 자체 설정에서 지정한 프록시 주소를 통해 테스트합니다.

    kilobat why https://huggingface.co --proxy http://127.0.0.1:7890

  4. 코드가 컨테이너, VM 또는 원격 컴퓨터에서 실행되는지 Kilobat에 알려주세요.

    kilobat why db.internal --context container

  5. 앱이 실패한 시점과 검사 시간을 나란히 기록하세요.

    kilobat why api.example.com --failed-at 14:05

MCP로 사용

claude mcp add kilobat -- kilobat mcp로 MCP 서버를 한 번 연결하세요. 다른 클라이언트는 문서를 참고하세요. 그러면 에이전트가 이 도구를 호출할 수 있습니다. 설정을 변경하는 도구는 에이전트에게 먼저 확인하도록 안내합니다.

도구 및 인수기능
diagnose_connection
{"target": "https://api.example.com/v1/models", "app": "process:node"}
verdict, next, steps를 반환하며 각각 layer, status, detail를 포함합니다.

알아두면 좋은 정보

  • 검사는 curl를 거치지 않고 Kilobat 내부에서 실행됩니다. 엄격한 Kilobat 프로필도 검사 자체를 차단할 수 없습니다.
  • IPv4와 IPv6를 별도로 테스트합니다. 문제가 있는 IPv6 경로에는 별도의 판정이 표시됩니다.
  • 확인을 통과하면 이 Mac에서 현재 해당 경로로 요청이 작동한다는 뜻입니다. 이미 진행 중인 전송은 확인할 수 없습니다.

질문

--context provider는 무엇을 하나요?

호스팅 서비스가 자체 서버에서 요청을 보낼 때 사용하세요. localhost 같은 사설 주소는 Mac에서 작동하지만 해당 서버에서는 접근할 수 없습니다.

출처

2026년 10월 29일 확인했습니다.