Receita

Descubra por que um site ou API não conecta

Quando a internet funciona, mas um endereço falha, o Kilobat verifica cada camada em sequência. Ele informa a camada que falhou e o próximo passo.

Grátis no app e na CLIVerificado: 29 de outubro de 2026

No app

Abra o painel e clique na aba Saúde.
Encontre Por que não conecta?.
Cole no campo o endereço exato que falha, por exemplo github.com ou uma URL completa.
Escolha o app se o problema ocorrer em apenas um. O Kilobat também verifica o proxy próprio e as conexões abertas dele.
Clique em Verificar. Leia a camada que falhou e o próximo passo.

Com a CLI

Verifique um host.
```
kilobat why api.example.com
```
Saída Cada camada com ok, warning, failed ou skipped, seguida de uma avaliação e do próximo passo. O comando termina com 1 quando uma camada falha.
Verifique a URL exata usada por um app. A saída oculta valores da consulta.
```
kilobat why https://example.com/file.zip --app com.example.App
```
Teste pelo endereço de proxy definido nos ajustes próprios do app.
```
kilobat why https://huggingface.co --proxy http://127.0.0.1:7890
```
Informe ao Kilobat quando o código é executado em um contêiner, VM ou máquina remota.
```
kilobat why db.internal --context container
```
Registre quando o app falhou ao lado do horário da verificação.
```
kilobat why api.example.com --failed-at 14:05
```

Pelo MCP

Conecte o servidor MCP uma vez com claude mcp add kilobat -- kilobat mcp. Para outros clientes, consulte a documentação. Depois, um agente pode chamar essas ferramentas. Ferramentas que alteram ajustes orientam o agente a pedir sua confirmação primeiro.

Ferramenta e argumentos	O que faz
`diagnose_connection` `{"target": "https://api.example.com/v1/models", "app": "process:node"}`	Retorna `verdict`, `next` e `steps`, cada um com `layer`, `status` e `detail`.

É bom saber

A verificação é executada dentro do Kilobat, não por curl. Um perfil restrito do Kilobat não pode bloquear a própria verificação.
Ela testa IPv4 e IPv6 separadamente. Um caminho IPv6 com problema recebe sua própria avaliação.
Uma verificação aprovada significa que essa solicitação funciona agora deste Mac por esse caminho. Ela não vê uma transferência já em andamento.

Perguntas

O que faz --context provider?

Use-o quando um serviço hospedado fizer a solicitação dos próprios servidores. Um endereço privado como localhost funciona no Mac, mas esses servidores não conseguem alcançá-lo.

Fontes

Verificado em 29 de outubro de 2026.