El bridge no conecta en Snap/Flatpak Linux

En resumen: un Thunderbird en entorno aislado (Snap o Flatpak) no puede lanzar el helper de atbridge.ai, por lo que el complemento no conecta. Ejecute el helper como servicio en segundo plano (atbridge bridge service install && atbridge bridge service start) y vincule el complemento por loopback con el token de atbridge bridge pair — o reinstale Thunderbird desde thunderbird.net.

En Linux, si atbridge.ai “funcionaba y dejó de funcionar”, el complemento @bridge no puede conectar, o la activación falla con un error genérico (y ~/.atbridge no tiene license.json), la causa casi siempre es cómo está instalado Thunderbird — no su licencia.

Por qué ocurre esto

atbridge.ai se comunica con Thunderbird a través de un pequeño helper local (un host de mensajería nativa). Normalmente Thunderbird lanza ese helper por su cuenta. Snap y Flatpak ejecutan Thunderbird dentro de un entorno aislado de seguridad que le impide lanzar programas externos — de modo que el helper nunca arranca y el complemento no puede conectar. Esto afecta especialmente a los usuarios de Ubuntu: el Centro de aplicaciones de Ubuntu instala Thunderbird como Snap de forma predeterminada.

Buena noticia: no es necesario reinstalar Thunderbird. Un Thunderbird en entorno aislado sí puede realizar conexiones de red locales, por lo que atbridge.ai incluye un fallback por loopback — usted ejecuta el helper como un pequeño servicio en segundo plano, y el complemento se conecta a él a través de 127.0.0.1. Solo hay que configurarlo una vez; la configuración persiste.

Consejo

Esta página es la solución oficial para Thunderbird en Snap/Flatpak. En Windows, macOS y Thunderbird en Linux sin entorno aislado, la configuración predeterminada no necesita nada de esto — funciona sin más.

Paso 1 — Comprobar cómo está instalado Thunderbird

1. Ejecute esto en un terminal:

   snap list 2>/dev/null | grep -i thunderbird
   flatpak list 2>/dev/null | grep -i thunder
   which thunderbird

2. Si Thunderbird aparece bajo snap o flatpak, use el fallback por loopback que se describe a continuación. (Una ruta normal como /usr/bin/thunderbird procedente de un paquete de su distribución o del tarball de Mozilla no requiere nada de esto.)

Nota

atbridge bridge tb-check también detecta un Thunderbird Snap/Flatpak e imprime estos mismos pasos.

Paso 2 — Ejecutar el bridge como servicio en segundo plano

Esto ejecuta el helper de forma autónoma (un servicio systemd --user) para que el Thunderbird en entorno aislado pueda alcanzarlo por loopback en lugar de tener que lanzarlo.

1. Instale e inicie el servicio:

   atbridge bridge service install
   atbridge bridge service start

2. Compruebe que está activo:

   atbridge bridge service status

   Debe mostrar active. (También se inicia automáticamente al iniciar sesión.)

Paso 3 — Vincular el complemento con el servicio

Como el complemento no puede leer archivos de su equipo, se le proporciona un token de un solo uso para que solo él pueda comunicarse con el servicio (ninguna página web aleatoria puede hacerlo).

1. Genere el token:

   atbridge bridge pair

   Copie el valor token que muestra.

2. En Thunderbird, abra atbridge.ai → Ajustes → Avanzado → Bridge local (Snap/Flatpak). Pegue el token, marque Activar fallback por loopback y haga clic en Guardar. (Deje el puerto en 45678 salvo que lo haya cambiado.)

Verificar

atbridge bridge ping
atbridge connect status

Una respuesta de bridge ping indica que Thunderbird y atbridge.ai se están comunicando por loopback. A continuación, active su plan si aún no lo ha hecho.

Consejo

No es necesario reinstalar Thunderbird. El bridge por loopback es una configuración oficial y compatible — puede mantener su Thunderbird Snap/Flatpak. (Si prefiere omitir la configuración del servicio, un Thunderbird estándar de thunderbird.net o un paquete de su distribución usa el bridge nativo predeterminado sin nada de lo anterior — pero es completamente opcional.)

Qué hacer a continuación

• Cuando la activación falla
• Cuando la IA dice “no hay herramientas”
• Cuando tu IA no encuentra nada