Recette

Trouver pourquoi un site ou une API ne se connecte pas

Quand Internet fonctionne mais qu’une adresse échoue, Kilobat vérifie chaque couche tour à tour. Il désigne la couche en échec et la marche à suivre.

Gratuit dans l’app et la CLIVérifié le 29 octobre 2026

Dans l’app

Ouvrez le tableau de bord et cliquez sur l’onglet État.
Repérez « Pourquoi ça ne se connecte pas ? ».
Collez dans le champ l’adresse exacte qui échoue, par exemple github.com ou une URL complète.
Choisissez l’app, si le problème touche une seule app. Kilobat vérifie alors aussi son propre proxy et ses connexions ouvertes.
Cliquez sur Vérifier. Lisez la couche en échec et l’étape suivante.

Avec la CLI

Vérifiez un hôte.
```
kilobat why api.example.com
```
Sortie Chaque couche avec ok, warning, failed ou skipped, puis un verdict et l’étape suivante. La commande se termine avec le code 1 quand une couche a échoué.
Vérifiez l’URL exacte qu’utilise une app. La sortie masque les valeurs de la requête.
```
kilobat why https://example.com/file.zip --app com.example.App
```
Testez via l’adresse de proxy que l’app définit dans ses propres réglages.
```
kilobat why https://huggingface.co --proxy http://127.0.0.1:7890
```
Indiquez à Kilobat quand le code tourne dans un conteneur, une VM ou sur une machine distante.
```
kilobat why db.internal --context container
```
Notez l’heure de l’échec de l’app à côté de l’heure de la vérification.
```
kilobat why api.example.com --failed-at 14:05
```

Via MCP

Connectez une fois le serveur MCP avec claude mcp add kilobat -- kilobat mcp. Pour les autres clients, voir la documentation. Un agent peut ensuite appeler ces outils. Les outils qui modifient des réglages indiquent à l’agent de vous demander d’abord.

Outil et arguments	Ce qu’il fait
`diagnose_connection` `{"target": "https://api.example.com/v1/models", "app": "process:node"}`	Renvoie `verdict`, `next` et les `steps`, chacune avec `layer`, `status` et `detail`.

Bon à savoir

La vérification s’exécute dans Kilobat, pas via curl. Un profil Kilobat strict ne peut pas bloquer la vérification elle-même.
Elle teste IPv4 et IPv6 séparément. Un chemin IPv6 défaillant obtient son propre verdict.
Une vérification réussie signifie que cette requête fonctionne en ce moment depuis ce Mac par ce chemin. Elle ne voit pas un transfert déjà en cours.

Questions

À quoi sert --context provider ?

Utilisez-le quand un service hébergé envoie la requête depuis ses propres serveurs. Une adresse privée comme localhost fonctionne depuis votre Mac, mais ces serveurs ne peuvent pas l’atteindre.

Sources

Sources vérifiées le 29 octobre 2026. Les pages man sont celles installées avec macOS ; ouvrez-en une avec man <name> dans Terminal.