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"

Las builds de producción están firmadas con Developer ID + notarizadas, no requieren ningún comando.

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.

Claude Desktop no ve B1 Bridge

El agente registra el MCP server escribiendo en el config de Claude Desktop. Si después de parear no aparecen las tools, confirma que exista una entrada mcpServers.b1bridge-* en el config que Claude está leyendo. En macOS revisa ~/Library/Application Support/Claude/claude_desktop_config.json. En Windows revisa ambos: %APPDATA%\Claude\claude_desktop_config.json y (si existe) %LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\claude_desktop_config.json — algunas builds de Claude leen la copia LocalCache. Si la entrada falta, repara desde el wizard.

Después de cambiar el config, cierra Claude Desktop por completo y vuelve a abrirlo. Cerrar la ventana no alcanza: en Windows sal desde la bandeja del sistema; en macOS usa Quit desde el Dock (o Cmd+Q).

Varias empresas: falta una en Claude

Cada empresa conectada es su propia entry mcpServers.b1bridge-* en el config de Claude Desktop. Después de agregar o quitar empresas desde "Manage companies" en la app B1 Bridge, tienes que reiniciar Claude Desktop por completo (cierra la app del todo; no alcanza con cerrar la ventana). Si una empresa sigue sin aparecer, verifica que el login SQL tenga permiso de lectura (db_datareader) en esa base — el wizard reporta "sin permiso en la base X" por base.

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.