---
title: "Trouver pourquoi un site ou une API ne se connecte pas · Recettes Kilobat"
url: "https://kilobat.app/fr/guides/recipes/why-cant-it-connect.html"
description: "Vérifiez un site web, une API ou un hôte couche par couche depuis votre Mac : réseau, VPN et proxy, DNS, règles de Kilobat, IPv4 et IPv6, TLS et réponse du serveur."
---

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 CLI · Vérifié le 29 octobre 2026

## Dans l’app

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

## Avec la CLI

1. 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é.
2. 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
   ```
3. 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
   ```
4. Indiquez à Kilobat quand le code tourne dans un conteneur, une VM ou sur une machine distante.

   ```
   kilobat why db.internal --context container
   ```
5. 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](https://kilobat.app/fr/docs.html#agents). 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

- [Documentation Kilobat : Quand quelque chose ne se connecte pas](https://kilobat.app/fr/docs.html#why)
- [Skill Kilobat : mac-network-troubleshooting](https://github.com/seifip/kilobat-skills/tree/main/skills/mac-network-troubleshooting)
- [llms.txt de Kilobat : référence de la CLI et du MCP](https://kilobat.app/llms.txt)

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.

## Guides associés

- [Un site web fonctionne sur votre téléphone mais pas sur votre Mac](https://kilobat.app/fr/guides/site-works-on-phone-not-mac.html): Quand un site s’ouvre sur votre téléphone mais pas sur votre Mac, le problème vient généralement du Mac.
- [Des réglages de proxy empêchent les apps de se connecter sur un Mac](https://kilobat.app/fr/guides/proxy-settings-breaking-apps.html): Un réglage de proxy fait passer le trafic par un autre serveur.
- [Problèmes IPv6 sur un Mac](https://kilobat.app/fr/guides/ipv6-problems-mac.html): La plupart des réseaux attribuent au Mac une adresse IPv4 et une adresse IPv6.
- [Un conteneur ne peut pas joindre localhost sur le Mac](https://kilobat.app/fr/guides/localhost-from-container.html): Chaque conteneur a sa propre pile réseau.