---
title: "Averiguar por qué no se conecta una web o una API · Recetas de Kilobat"
url: "https://kilobat.app/es/guides/recipes/why-cant-it-connect.html"
description: "Comprueba una web, una API o un host capa por capa desde tu Mac: red, VPN y proxy, DNS, las reglas de Kilobat, IPv4 e IPv6, TLS y la respuesta del servidor."
---

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 CLI · Revisado: 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](https://kilobat.app/es/docs.html#agents). Así, un agente puede llamar a estas herramientas. Las herramientas que cambian ajustes indican al agente que te pregunte antes.

| Herramienta y argumentos | Qué 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

- [Documentación de Kilobat: Cuando algo no se conecta](https://kilobat.app/es/docs.html#why)
- [Skill de Kilobat: mac-network-troubleshooting](https://github.com/seifip/kilobat-skills/tree/main/skills/mac-network-troubleshooting)
- [llms.txt de Kilobat: referencia de la CLI y MCP](https://kilobat.app/llms.txt)

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.

## Guías relacionadas

- [Un sitio web funciona en tu teléfono pero no en tu Mac](https://kilobat.app/es/guides/site-works-on-phone-not-mac.html): Cuando un sitio se abre en tu teléfono pero no en tu Mac, el problema suele estar en el Mac.
- [Los ajustes de proxy impiden que las apps se conecten en un Mac](https://kilobat.app/es/guides/proxy-settings-breaking-apps.html): Un ajuste de proxy envía el tráfico a través de otro servidor.
- [Problemas de IPv6 en un Mac](https://kilobat.app/es/guides/ipv6-problems-mac.html): La mayoría de las redes dan a un Mac direcciones IPv4 e IPv6.
- [Un contenedor no puede acceder a localhost en el Mac](https://kilobat.app/es/guides/localhost-from-container.html): Cada contenedor tiene su propia pila de red.