---
title: "특정 사이트 또는 API에 연결되지 않는 이유 찾기 · Kilobat 활용법"
url: "https://kilobat.app/ko/guides/recipes/why-cant-it-connect"
description: "Mac에서 웹사이트, API 또는 호스트 하나를 계층별로 확인합니다. 네트워크, VPN과 프록시, DNS, Kilobat 규칙, IPv4와 IPv6, TLS 및 서버 응답을 살펴봅니다."
---

레시피

# 한 사이트 또는 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 서버를 한 번 연결하세요. 다른 클라이언트는 [문서](https://kilobat.app/ko/docs/agents#agents)를 참고하세요. 그러면 에이전트가 이 도구를 호출할 수 있습니다. 설정을 변경하는 도구는 에이전트에게 먼저 확인하도록 안내합니다.

| 도구 및 인수 | 기능 |
|---|---|
| `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에서 작동하지만 해당 서버에서는 접근할 수 없습니다.

## 출처

- [Kilobat 문서: 연결되지 않을 때](https://kilobat.app/ko/docs/health#why)
- [Kilobat 스킬: mac-network-troubleshooting](https://github.com/seifip/kilobat-skills/tree/main/skills/mac-network-troubleshooting)
- [Kilobat llms.txt: CLI 및 MCP 참조](https://kilobat.app/llms.txt)

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

## 관련 가이드

- [웹사이트가 휴대전화에서는 작동하지만 Mac에서는 작동하지 않음](https://kilobat.app/ko/guides/site-works-on-phone-not-mac): 사이트가 휴대전화에서는 열리지만 Mac에서는 열리지 않으면 보통 Mac에 문제가 있습니다.
- [프록시 설정으로 인해 Mac에서 앱이 연결되지 않습니다](https://kilobat.app/ko/guides/proxy-settings-breaking-apps): 프록시 설정은 다른 서버를 통해 트래픽을 전송합니다.
- [Mac의 IPv6 문제](https://kilobat.app/ko/guides/ipv6-problems-mac): 대부분의 네트워크는 Mac에 IPv4와 IPv6 주소를 모두 제공합니다.
- [컨테이너에서 Mac의 localhost에 연결할 수 없음](https://kilobat.app/ko/guides/localhost-from-container): 각 컨테이너에는 자체 네트워크 스택이 있습니다.