Cómo funciona por dentro y seguridad

No hace falta leer esta página para usar el conector. Pero si quieres entender, o tienes que explicar a alguien, por qué es de fiar, aquí está el funcionamiento, primero en lenguaje llano y luego con el detalle técnico.

Las tres piezas

Cuando preguntas «¿por qué me han rechazado la factura 2026/0142?», intervienen tres piezas:

1. Tu asistente de IA (Claude, o el que uses): entiende la pregunta y decide qué información necesita.
2. El conector de B2Brouter: un conjunto de funciones de consulta que el asistente puede invocar, «lístame las facturas con error», «dame el detalle de este informe fiscal», «busca esta empresa en el directorio».
3. Tu cuenta de B2Brouter: de donde salen los datos, con los mismos permisos que tienes en el panel.

El asistente traduce tu pregunta en una o más consultas al conector, recibe los datos y compone la respuesta. Tú no ves esta mecánica, solo la conversación, pero queda toda registrada (consulta Auditoría, más abajo).

Para perfiles técnicos.

El conector es un servidor MCP remoto en https://app.b2brouter.net/mcp. Expone herramientas de consulta tipadas que el cliente MCP descubre al conectarse; todas son de solo lectura. Las herramientas de listado llevan paginación y filtros; las de detalle devuelven cuerpos equivalentes a los de la API REST. La lista completa está en la Referencia de herramientas.

Identidad: el asistente actúa en tu nombre

No existe ningún «usuario robot» ni ninguna clave especial para la IA. Cuando conectas el asistente, lo autorizas a actuar con tu usuario, y B2Brouter aplica a cada consulta exactamente las mismas reglas que cuando navegas por el panel:

• Miembro: solo las cuentas donde eres miembro.
• Sección: dentro de cada cuenta, solo las secciones que tienes permitidas (emitidas, recibidas, informes fiscales...).
• Plan: las funciones de facturas, informes y finanzas requieren que la cuenta tenga plan Professional o superior; todas requieren que llegues a alguna cuenta de pago.

La consecuencia práctica: el conector no abre ninguna puerta nueva. Todo lo que el asistente puede ver, tú ya lo podías ver. Y si mañana te sacan de una cuenta o te restringen una sección, el asistente lo pierde en el mismo instante. Cada persona de la empresa conecta su propio usuario: no se comparten accesos ni permisos.

Para perfiles técnicos.

La autorización es OAuth 2.1 (Authorization Code + PKCE) con registro dinámico de clientes; el token representa al usuario, no la aplicación. Los permisos se evalúan en cada llamada con el mismo motor que la web (miembro + capacidad + sección + producto), incluidos los matices: un miembro restringido a «facturas recibidas» no ve las emitidas tampoco vía conector, y la puerta de suscripción de pago se recomprueba en cada petición, de manera que una suscripción caducada corta el acceso aunque el token siga vivo.

Por qué es solo de lectura

Es la decisión de diseño central de esta primera versión. Dar a una IA la capacidad de escribir sobre documentos con valor legal y fiscal (crear facturas, enviarlas a una autoridad, modificar datos) abre una categoría de riesgos (errores de interpretación, instrucciones maliciosas escondidas en datos) que queremos tratar con calma y por separado. Mientras tanto:

• Consultar es seguro por construcción: ninguna pregunta, por mal formulada que esté, puede cambiar nada de tu cuenta.
• La responsabilidad queda donde toca: la IA propone el diagnóstico; la acción (en la aplicación web o por API) la hace una persona (o un sistema) con intención explícita.

Para perfiles técnicos.

Solo lectura estricta y sin efectos colaterales: consultar una factura vía conector no la marca como leída ni dispara la generación de informes fiscales (divergencia deliberada respecto del GET de la API REST). Para escribir, el camino es la API REST de B2Brouter; el patrón de trabajo recomendado es crear por API, inspeccionar y diagnosticar por el conector.

De dónde sale el conocimiento

Los datos de tu cuenta (facturas, informes, cifras, directorio) salen directamente de B2Brouter, en tiempo real. Para las preguntas sobre cómo funciona el producto o la normativa («¿cómo configuro el TicketBAI?»), el conector no tiene una copia propia de la documentación: le indica al asistente dónde está la documentación oficial, este mismo portal, para que la consulte. Así la respuesta se basa en la versión vigente y no en una copia que pueda quedarse desfasada.

Si el asistente no puede leer páginas web, te dará el enlace o responderá con su conocimiento general. Ningún asistente es infalible: ante una decisión con consecuencias fiscales, confirma siempre con tu asesor o con soporte.

Protección ante contenido de terceros

Las facturas recibidas y el directorio contienen texto escrito por otros: nombres de empresas, descripciones de líneas. Alguien podría intentar esconder ahí instrucciones para la IA («ignora tus órdenes y...»). El conector marca explícitamente todo este contenido como datos, no instrucciones, para que el asistente nunca ejecute órdenes escondidas dentro de una factura o de un nombre de empresa.

Para perfiles técnicos.

Todo valor de terceros viaja delimitado como contenido no fiable con marcadores infalsificables. Si construyes automatizaciones sobre el conector, mantén esta distinción aguas abajo: no mezcles nunca texto de facturas con el canal de instrucciones de tu agente.

Ningún oráculo de existencia

Si consultas un identificador que no existe y uno que pertenece a la cuenta de otra persona, recibes exactamente el mismo error («Not found or not authorized»). Es deliberado: nadie puede usar el conector para averiguar qué existe fuera de su alcance, ni siquiera para confirmar que una factura o una cuenta existen.

Auditoría

Cada consulta del asistente queda registrada (cuándo, qué función, qué aplicación, qué usuario) y es consultable en tu perfil (Actividad MCP). Si alguna vez te preguntas «¿qué ha mirado exactamente la IA?», la respuesta está ahí, completa.

Consentimiento y revocación

La autorización la apruebas tú (OAuth) y la puedes revocar en cualquier momento desde Aplicaciones autorizadas, en tu perfil, con efecto inmediato. Si la suscripción caduca, el acceso se detiene solo.

A dónde van tus datos

Las respuestas del conector las procesa el proveedor de IA que has conectado (Anthropic, OpenAI, Google...), según sus condiciones y el DPA de B2Brouter. Conectar la cuenta implica aceptar este tratamiento: revisa la política de privacidad de tu asistente.

En resumen

Principio	Qué implica
Identidad propia del usuario	El asistente ve lo que tú ves; ni más, ni menos; revocable al instante
Solo lectura	Ninguna pregunta puede modificar nada; las acciones son tuyas
Documentación vigente	El conector dirige al asistente a la documentación oficial publicada, no a una copia
Datos ≠ instrucciones	El contenido de terceros no puede dar órdenes a la IA
Errores indistinguibles	Ninguna filtración de existencia entre cuentas
Auditoría completa	Toda la actividad, registrada y consultable