Receta

Averiguar por qué no conecta un sitio o una API

Cuando internet funciona pero una dirección falla, Kilobat comprueba cada capa por orden. Indica la capa que ha fallado y qué hacer a continuación.

Gratis en la app y en la CLIRevisado: 29 de octubre de 2026

En la app

  1. Abre el panel de control y haz clic en la pestaña Estado.

  2. Busca ¿Por qué no se conecta?.

  3. Pega en el campo la dirección exacta que falla, por ejemplo github.com o una URL completa.

  4. Elige la app, si el problema lo tiene una sola app. Así Kilobat comprueba también su propio proxy y sus conexiones abiertas.

  5. Haz clic en Comprobar. Mira la capa que ha fallado y el siguiente paso.

Con la CLI

  1. Comprueba un host.

    kilobat why api.example.com

    Salida Cada capa con ok, warning, failed o skipped y, después, un veredicto y el siguiente paso. El comando sale con 1 si ha fallado alguna capa.

  2. Comprueba la URL exacta que usa una app. La salida oculta los valores de la consulta.

    kilobat why https://example.com/file.zip --app com.example.App
  3. Prueba a través de la dirección del proxy que la app configura en sus propios ajustes.

    kilobat why https://huggingface.co --proxy http://127.0.0.1:7890
  4. Indica a Kilobat si el código se ejecuta en un contenedor, una máquina virtual o un equipo remoto.

    kilobat why db.internal --context container
  5. Anota cuándo falló la app junto a la hora de la comprobación.

    kilobat why api.example.com --failed-at 14:05

Por MCP

Conecta el servidor MCP una vez con claude mcp add kilobat -- kilobat mcp. Para otros clientes, consulta la documentación. Así, un agente puede llamar a estas herramientas. Las herramientas que cambian ajustes indican al agente que te pregunte antes.

Herramienta y argumentosQué hace
diagnose_connection
{"target": "https://api.example.com/v1/models", "app": "process:node"}
Devuelve verdict, next y los pasos (steps), cada uno con layer, status y detail.

Conviene saber

  • La comprobación se ejecuta dentro de Kilobat, no a través de curl. Un perfil estricto de Kilobat no puede bloquear la propia comprobación.
  • Prueba IPv4 e IPv6 por separado. Una ruta IPv6 averiada recibe su propio veredicto.
  • Una comprobación superada significa que esta solicitud funciona ahora desde este Mac por esa ruta. No puede ver una transferencia que ya esté en curso.

Preguntas

¿Qué hace --context provider?

Úsalo cuando un servicio alojado hace la solicitud desde sus propios servidores. Una dirección privada como localhost funciona desde tu Mac, pero esos servidores no pueden llegar a ella.

Fuentes

Fuentes revisadas el 29 de octubre de 2026. Las páginas man son las que se instalan con macOS; abre una con man <name> en Terminal.