---
title: "1つのサイトやAPIに接続できない原因を見つける · Kilobatレシピ"
url: "https://kilobat.app/ja/guides/recipes/why-cant-it-connect.html"
description: "1つのWebサイト、API、ホストへの接続を、Macから層ごとにチェックします。ネットワーク、VPNとプロキシ、DNS、Kilobatのルール、IPv4とIPv6、TLS、サーバの応答を順に調べます。"
---

レシピ

# 1つのサイトやAPIに接続できない原因を見つける

インターネットは使えるのに1つのアドレスだけ失敗するとき、Kilobatは各層を順にチェックします。失敗した層と、次にすべきことを示します。

アプリとCLIで無料 · 確認日：2026年10月29日

## アプリで

1. ダッシュボードを開き、「ヘルス」タブをクリックします。
2. 「接続できない理由は？」を探します。
3. 失敗するアドレスをそのままフィールドに貼り付けます。たとえば`github.com`や完全なURLです。
4. 問題が1つのアプリだけで起きている場合は、そのアプリを選びます。Kilobatは、そのアプリ独自のプロキシと開いている接続もチェックします。
5. 「チェック」をクリックします。失敗した層と次の手順を確認します。

## CLIで

1. 1つのホストをチェックします。

   ```
   kilobat why api.example.com
   ```

   出力各層の結果（ok、warning、failed、skipped）、判定、次の手順。失敗した層がある場合、コマンドは終了コード1で終わります。
2. 1つのアプリが使っている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. コードがコンテナ、仮想マシン、リモートマシンで動いている場合は、そのことを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/ja/docs.html#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/ja/docs.html#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日に確認しました。manページはmacOSに付属のものです。「ターミナル」で`man <name>`を実行すると開けます。

## 関連ガイド

- [スマートフォンでは開けるWebサイトがMacで開けない](https://kilobat.app/ja/guides/site-works-on-phone-not-mac.html): スマートフォンでは開けるのにMacでは開けない場合、たいてい問題はMacの側にあります。
- [Macでプロキシ設定のせいでアプリが接続できない](https://kilobat.app/ja/guides/proxy-settings-breaking-apps.html): プロキシ設定は、通信を別のサーバ経由で送ります。
- [MacでのIPv6の問題](https://kilobat.app/ja/guides/ipv6-problems-mac.html): ほとんどのネットワークは、MacにIPv4とIPv6の両方のアドレスを割り当てます。
- [コンテナからMacのlocalhostに接続できない](https://kilobat.app/ja/guides/localhost-from-container.html): コンテナはそれぞれ独自のネットワークスタックを持っています。