Troubleshooting

Errores comunes y cómo resolverlos. Si lo tuyo no está acá, escríbenos a hello@b1bridge.com con un screenshot y el agent ID (visible en /app/workspace/pairing-keys).

macOS: "B1 Bridge no se puede abrir"

macOS Sequoia y posteriores bloquean apps no firmadas. Si tu installer es una build beta sin firmar, abre Terminal y corre:

xattr -dr com.apple.quarantine "/Applications/B1 Bridge.app"
codesign --force --deep --sign - "/Applications/B1 Bridge.app"

Windows: SmartScreen "Protegió tu PC"

Los instaladores actuales están firmados con certificado EV (editor verificado Flowing Rivers, S.A.), así que SmartScreen ya no avisa. Si ves este mensaje, estás corriendo un build viejo sin firmar — descarga el instalador más reciente y la advertencia desaparece.

Pairing code rechazado

• "Pairing code not found" → el código ya expiró (>30 min desde que se generó) o se usó. Genera uno nuevo en /app/workspace/pairing-keys.
• "Pairing code already used" → otro installer ya canjeó ese código. Genera uno nuevo.
• "Control plane error" sin que haya request a nuestros servidores → el preload del installer crasheó (módulo de sentry o similar). Mira los logs en ~/Library/Application Support/@b1bridge/installer/ y mándanos el último error.

Connection failed: SQL Server

• "Login failed for user" → user/password incorrectos, o el user no tiene permiso a la database. Verifica en SSMS que puedes loguearte con esas credenciales.
• "Cannot connect to host" → firewall, IP incorrecta, o SQL Server no escucha en TCP. Default port es 1433. En SQL Server Configuration Manager, habilita TCP/IP para la instancia.
• "Database not found" → el name está mal escrito (case-sensitive en algunos collations) o tu user no tiene permisos sobre ella.

El asistente de escritorio no ve B1 Bridge

Cierra la app de escritorio por completo y vuelve a abrirla. El instalador escribe la configuración MCP solo mientras esa app está cerrada. El sitio web de ChatGPT no es compatible. Si elegiste ChatGPT Desktop, la configuración está en ~/.codex/config.toml, en tu carpeta de usuario. Si elegiste Claude Desktop, confirma que exista una entrada mcpServers.b1bridge-*. En macOS revisa ~/Library/Application Support/Claude/claude_desktop_config.json. En Windows revisa %APPDATA%\Claude\claude_desktop_config.json y, si existe, %LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\claude_desktop_config.json. Si falta la entrada, repara desde el asistente de instalación.

Varias empresas: falta una en el asistente de escritorio

Cada empresa conectada es su propio conector. En Claude Desktop es una entrada mcpServers.b1bridge-* (las claves se ven como b1bridge-host-dbname). ChatGPT Desktop recibe las mismas empresas en su configuración MCP. Después de agregar o quitar empresas en Manage companies, cierra por completo la app de escritorio que uses. Si una empresa sigue sin aparecer, verifica que el login SQL de ese servidor tenga permiso de lectura (db_datareader) en esa base.

Varios SQL Servers: faltan conectores o el host es incorrecto

Desde la versión 2.0.15, Manage companies agrupa empresas por SQL Server y permite agregar otro host (hasta 8). Cada servidor mantiene sus propias credenciales. Después de Add SQL Server o Remove server, cierra por completo el asistente de escritorio que uses. Si queda un nombre de conector viejo, abre Manage companies y aplica de nuevo. Los servidores con autenticación Windows no se pueden redescubrir desde Manage companies; vuelve a correr el asistente de instalación para ese host si lo necesitas.

El agente va a "stale"

Si el agente pierde conexión al control plane por más de 5 minutos (firewall, máquina dormida, internet caído), su estado pasa a "stale". En cuanto recupera la red manda un heartbeat y vuelve a "active" solo.

Query devuelve 0 filas y esperaba resultados

Probable causa: la tabla no está en el allowlist de tu policy. Ve a /app/settings y revisa las allowed tables. Si está OK, prueba la misma query en SSMS para descartar problema del lado de SAP.