> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# Solución de problemas

> Qué hacer cuando la app o la CLI no llegan a su host, un inicio de sesión ha caducado, un servidor MCP falla, un plugin está desactivado o no llegan las notificaciones.

Empieza por aquí:

```bash theme={null}
archetype --doctor          # config, model, keys and records, without calling a model
archetype daemon status     # whether the background service runs, for each folder
archetype --version
```

## La app no llega a su host

La app de escritorio ejecuta su propio host. Si el host se detiene después de estar listo, la app lo reinicia, hasta tres veces en cinco minutos. Si se detiene mientras arranca, la app dice por qué, con **Try Again** y **Show Log**.

* Reinícialo a mano con **Archivo → Reiniciar Archetype**.
* Si la app dice **El host se reinició. Vuelve a abrir Archetype para reconectar.**, cierra y abre la app.
* **Un host en un servidor:** la app se conecta con el `ssh` de tu sistema, que debe funcionar desde una terminal sin pedir contraseña. Usa **Reconectar** (en **Archivo** o en **Gestionar → Ajustes → Servidores**). A un servidor más antiguo se le ofrece **Actualizar y reconectar**. Si aun así no puede conectarse, **Usar este ordenador** abre el host local.
* **Un teléfono:** si dice **No se pudo llegar a** tu ordenador, comprueba que el ordenador está encendido y que la app o su host se ejecutan allí. Si Archetype dice que un puerto está ocupado, pon otro en `phones.port` en el archivo de configuración. Consulta [Dispositivos](https://docs.archetype.ing/es/use/devices.md).

## Los chats, las programaciones o los disparadores no reciben respuesta

Se ejecutan en el servicio en segundo plano, también con la app cerrada.

```bash theme={null}
archetype daemon status                # exits 0 only while it runs
archetype daemon logs -n 100 --follow  # its log
archetype daemon restart               # start it again with the config as it is now
archetype daemon install               # install it again if it is missing
```

Si la app dice **El servicio en segundo plano está instalado pero no se está ejecutando, así que los chats quedan sin respuesta.**, pulsa **Reiniciarlo**.

El servicio no recibe el entorno de tu shell. Pon las claves y los tokens en `~/.config/archetype/env`, un `NAME=value` por línea, que solo tú puedas leer (`chmod 600`): el servicio se niega a arrancar si otros pueden leerlo.

## Un inicio de sesión ha caducado

| Dónde | Qué ves | Qué hacer |
| - | - | - |
| Un modelo o un motor | **La sesión caducó. Vuelve a iniciar sesión.** | Vuelve a iniciar sesión donde indique. Consulta [Motores](https://docs.archetype.ing/es/use/engines.md). |
| Un equipo | **Inicia sesión en … para abrirlo** | Inicia sesión en la empresa desde la barra lateral. |
| Una app (Gmail, Notion, Linear…) | **Hay que volver a conectar** | **Gestionar → Conexiones → Apps** y vuelve a conectarla. |
| Una cuenta de mensajería | **Reconectar** | Púlsalo en esa cuenta. Consulta [Cuentas y claves](https://docs.archetype.ing/es/use/accounts.md). |

## Un servidor MCP falla

```bash theme={null}
archetype mcp list          # the servers, and the plugins' own
archetype mcp check NAME    # start it and list its tools
archetype mcp login NAME    # sign in, for a server that asks
```

Un servidor al que no se puede llegar en un turno se deja fuera de ese turno, y los demás siguen. Un servidor con `"disabled": true` no se ejecuta. Consulta [Servidores MCP](https://docs.archetype.ing/es/extend/mcp.md).

## Un plugin está desactivado o no aparece

* Revisa **Gestionar → Plugins**. **Borradores** y **Comidas** están desactivados hasta que los activas.
* Un plugin desactivado en `~/.config/archetype/config.json` (`"plugins": { "name": false }`) sigue desactivado.
* En el host de una empresa, un administrador elige qué roles ven un plugin y tienen sus herramientas. Si el tuyo no, pídeselo a un administrador. Consulta [Alojar una empresa](https://docs.archetype.ing/es/teams/hosting.md).
* **Música** solo funciona en un Mac y necesita que macOS permita a Archetype controlar la app. Consulta [Música](https://docs.archetype.ing/es/plugins/music.md).

## No llegan las notificaciones

* Abre **Gestionar → Mis ajustes → Ajustes de notificaciones**. Cada dispositivo indica si las recibe: **Desactivado en los ajustes del sistema**, **Desactivado en este navegador**, **Bloqueado por este navegador** o **No accesible** dicen por qué no.
* Actívalas para Archetype en los ajustes del sistema y vuelve a comprobarlo.
* Las **Horas de silencio** retienen los avisos, y las **Sesiones silenciadas** no reciben ninguno.
* No se muestra un aviso mientras su conversación está en pantalla en una ventana activa.
* Las menciones, respuestas y decisiones de un equipo siguen las preferencias propias de ese equipo.

## Dónde están los logs

| Qué | Dónde |
| - | - |
| El host de la app de escritorio | **Ayuda → Mostrar registro** o **Ayuda → Mostrar carpeta de registros** |
| El servicio en segundo plano | `archetype daemon logs`, o `daemon/daemon.log` en los registros de la carpeta |
| El host de una empresa que ejecutas tú | `docker compose logs -f archetype` |

Los logs no incluyen los tokens de acceso. Revisa un log por si tiene algo privado antes de enviarlo.

## Informar de un problema

Escribe a [help@archetype.ing](mailto:help@archetype.ing) con:

* qué hiciste, qué esperabas y qué pasó;
* el ordenador y el sistema, y `archetype --version`;
* la salida de `archetype --doctor` y las líneas del log alrededor del problema;
* en el caso de una app conectada o un plugin, su nombre.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.