B1Bridge

Troubleshooting

Errores comunes y cómo resolverlos. Si lo tuyo no está acá, escribinos a support@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, abrí Terminal y corré:

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"

Click en "Más información" → "Ejecutar de todos modos". Cuando vendamos producción con cert EV, este warning desaparece.

Pairing code rechazado

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

Connection failed: SQL Server

  • "Login failed for user" → user/password incorrectos, o el user no tiene permiso a la database. Verificá en SSMS que podés 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, habilitá 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, chequeá manualmente que el archivo ~/Library/Application Support/Claude/claude_desktop_config.json contenga una entrada mcpServers.b1bridge-*. Si no está, repará desde el wizard.

Después de cambiar el config, reiniciá Claude Desktop (cerrá completamente; no alcanza con cerrar la ventana).

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. Andá a /app/settings y revisá las allowed tables. Si está OK, probá la misma query en SSMS para descartar problema del lado de SAP.