---
title: "Descobrir por que um site ou API não conecta · Receitas do Kilobat"
url: "https://kilobat.app/pt/guides/recipes/why-cant-it-connect"
description: "Verifique um site, API ou host camada por camada a partir do Mac: rede, VPN e proxy, DNS, regras do Kilobat, IPv4 e IPv6, TLS e resposta do servidor."
---

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 CLI · Verificado: 29 de outubro de 2026

## No app

1. Abra o painel e clique na aba Saúde.
2. Encontre Por que não conecta?.
3. Cole no campo o endereço exato que falha, por exemplo `github.com` ou uma URL completa.
4. 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.
5. Clique em Verificar. Leia a camada que falhou e o próximo passo.

## Com a CLI

1. 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.
2. 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
   ```
3. 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
   ```
4. Informe ao Kilobat quando o código é executado em um contêiner, VM ou máquina remota.

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

- [Documentação do Kilobat: quando algo não conecta](https://kilobat.app/pt/docs/health#why)
- [Kilobat skill: mac-network-troubleshooting](https://github.com/seifip/kilobat-skills/tree/main/skills/mac-network-troubleshooting)
- [Kilobat llms.txt: referência de CLI e MCP](https://kilobat.app/llms.txt)

Verificado em 29 de outubro de 2026.

## Guias relacionados

- [Um site funciona no celular, mas não no Mac](https://kilobat.app/pt/guides/site-works-on-phone-not-mac): Quando um site abre no celular, mas não no Mac, o problema geralmente está no Mac.
- [Ajustes de proxy impedem apps de se conectar no Mac](https://kilobat.app/pt/guides/proxy-settings-breaking-apps): Um ajuste de proxy envia tráfego por outro servidor.
- [Problemas de IPv6 no Mac](https://kilobat.app/pt/guides/ipv6-problems-mac): A maioria das redes fornece ao Mac endereços IPv4 e IPv6.
- [Um contêiner não consegue acessar localhost no Mac](https://kilobat.app/pt/guides/localhost-from-container): Cada contêiner tem sua própria pilha de rede.