Rezept

Herausfinden, warum eine Website oder API keine Verbindung bekommt

Wenn das Internet funktioniert, aber eine Adresse nicht, prüft Kilobat nacheinander jede Ebene. Es nennt die Ebene, die versagt hat, und den nächsten Schritt.

Kostenlos in der App und der CLIGeprüft: 29. Oktober 2026

In der App

Öffne das Dashboard und klicke auf den Tab „Zustand“.
Such „Warum keine Verbindung?“.
Füge genau die Adresse, die fehlschlägt, in das Feld ein, zum Beispiel github.com oder eine vollständige URL.
Wähle die App aus, wenn das Problem nur eine App betrifft. Kilobat prüft dann auch ihren eigenen Proxy und ihre offenen Verbindungen.
Klicke auf „Prüfen“. Lies, welche Ebene versagt hat und was der nächste Schritt ist.

Mit der CLI

Einen Host prüfen.
```
kilobat why api.example.com
```
Ausgabe Jede Ebene mit ok, warning, failed oder skipped, dann eine Einschätzung und der nächste Schritt. Der Befehl endet mit 1, wenn eine Ebene versagt hat.
Genau die URL prüfen, die eine App nutzt. Die Ausgabe verbirgt Query-Werte.
```
kilobat why https://example.com/file.zip --app com.example.App
```
Über die Proxy-Adresse testen, die die App in ihren eigenen Einstellungen festlegt.
```
kilobat why https://huggingface.co --proxy http://127.0.0.1:7890
```
Kilobat mitteilen, wenn der Code in einem Container, einer VM oder auf einem entfernten Rechner läuft.
```
kilobat why db.internal --context container
```
Neben dem Zeitpunkt der Prüfung festhalten, wann die App fehlschlug.
```
kilobat why api.example.com --failed-at 14:05
```

Über MCP

Verbinde den MCP-Server einmal mit claude mcp add kilobat -- kilobat mcp. Für andere Clients siehe die Dokumentation. Dann kann ein Agent diese Tools aufrufen. Tools, die Einstellungen ändern, weisen den Agent an, dich vorher zu fragen.

Tool und Argumente	Was es tut
`diagnose_connection` `{"target": "https://api.example.com/v1/models", "app": "process:node"}`	Gibt `verdict`, `next` und die Schritte (`steps`) zurück, jeweils mit `layer`, `status` und `detail`.

Gut zu wissen

Die Prüfung läuft in Kilobat, nicht über curl. Ein strenges Kilobat-Profil kann die Prüfung selbst nicht blockieren.
IPv4 und IPv6 werden getrennt getestet. Ein kaputter IPv6-Weg bekommt eine eigene Einschätzung.
Eine bestandene Prüfung bedeutet, dass diese Anfrage jetzt von diesem Mac über diesen Weg funktioniert. Eine bereits laufende Übertragung sieht sie nicht.

Fragen

Was bewirkt --context provider?

Nutze es, wenn ein gehosteter Dienst die Anfrage von seinen eigenen Servern stellt. Eine private Adresse wie localhost funktioniert von deinem Mac aus, aber diese Server erreichen sie nicht.

Quellen

Quellen geprüft am 29. Oktober 2026. Die Manpages sind die mit macOS installierten; öffne eine mit man <name> im Terminal.