Conector de IA (MCP) de B2Brouter

El Conector de IA permite que tu asistente de inteligencia artificial habitual pueda consultar directamente tu cuenta de B2Brouter y la documentación oficial del producto, de manera que responda a tus preguntas con datos reales, y no con lo que la IA pueda imaginarse.

En lugar de entrar en la aplicación web para buscar, filtrar y cruzar información, puedes preguntar:

«¿Por qué la autoridad fiscal me ha rechazado la factura 2026/0142?» «¿Qué tengo pendiente de cobrar? ¿Qué está vencido?» «Este cliente nuevo, ¿por qué canal recibe las facturas?» «¿Cómo creo una factura por API y la envío por Peppol?»

Y el asistente busca la respuesta en tu cuenta y en las guías oficiales de B2Brouter, y te la explica.

¿Por qué esto es diferente de preguntarle a la IA directamente?

Un asistente de IA sin conector responde de memoria: sabe cosas generales sobre facturación electrónica, pero no conoce tu cuenta y puede equivocarse con detalles normativos (códigos de error, campos obligatorios, requisitos de cada autoridad fiscal). El conector le aporta dos cosas:

Tus datos: tus facturas, tus informes fiscales, tus cifras, las mismas que ves en la aplicación web, en tiempo real.
El conocimiento oficial: la documentación completa de B2Brouter: guía de usuario, guías para desarrolladores y guías de las autoridades fiscales (AEAT/Verifactu/TicketBAI, DGFiP, KSeF, SDI, ZATCA, LHDN, Peppol…).

Y una instrucción clave para la IA: si la respuesta no está en la documentación, el asistente debe admitir que no lo sabe en lugar de inventársela.

¿Qué puede hacer?

Puede hacer seis cosas, todas de consulta (la sección 03 las desarrolla con ejemplos):

Buscar y listar tus facturas por estado (con error, rechazadas, impagadas…), por número o por periodo.
Examinar y validar una factura: el contenido completo y los errores de validación exactos, explicados.
Seguir tus informes fiscales, el estado ante la autoridad y, si hay rechazo, el mensaje literal y qué significa.
Darte las cifras del negocio: ingresos, gastos, pendientes y vencidos, evolución mensual, principales clientes y proveedores.
Decirte cómo hacer llegar documentos a una empresa, es decir, indicar por qué canal recibe (Peppol, FACe, Chorus Pro, SDI…) y qué códigos necesitas.
Responder preguntas con la documentación oficial de usuario y de desarrollador, incluidas las guías de cada autoridad fiscal.

¿Qué no puede hacer? (y por qué)

El conector no puede crear, modificar, enviar ni borrar nada. Es solo de lectura, de manera deliberada: la IA te ayuda a entender y decidir; las acciones —corregir una factura, enviarla o reclamar un cobro— las haces tú, en la aplicación web de B2Brouter o por la API, como siempre.

Esto no es una limitación provisional ni una carencia: es el diseño de seguridad.

A quién le sirve

A cualquiera que trabaje con B2Brouter, sea cual sea su perfil:

Si llevas la facturación, para desbloquear facturas rechazadas y saber cómo facturar a un cliente nuevo.
Si eres asesor o gestoría, para revisar el estado fiscal de las cuentas de tus clientes y traducir los rechazos de las autoridades.
Si eres desarrollador, para que tu agente de código tenga la documentación canónica de la API y pueda diagnosticar tus facturas de prueba sin salir del editor.
Si eres gerente o responsable financiero, para tener las cifras del negocio desde el chat, sin entrar en la aplicación web.

Esta guía no separa estos recorridos: todo lo que describe está al alcance de todos los perfiles, con los permisos que cada usuario ya tiene.

Conectar tu asistente a B2Brouter

Requisitos

Una cuenta de B2Brouter con suscripción de pago activa. Con el plan gratuito el conector no está disponible. Las funciones sobre facturas, informes fiscales y resumen financiero requieren, además, el plan Professional o superior en la cuenta consultada.
Tu usuario y contraseña de B2Brouter. La conexión se hace con tu usuario personal, no hace falta ninguna clave de API ni ninguna configuración técnica.
Un asistente de IA compatible con conectores MCP: Claude (web y aplicación), Claude Code, y otros asistentes a medida que cada plataforma apruebe el conector.

Conectarlo desde un asistente de chat

Este es el camino para la mayoría de usuarios (Claude web, aplicación de móvil o escritorio):

En tu asistente, busca B2Brouter en el directorio de conectores, o añádelo por URL: https://app.b2brouter.net/mcp.
Se abrirá una ventana de B2Brouter pidiéndote iniciar sesión (si no la tienes abierta) y autorizar el acceso del asistente.
Revisa qué autorizas y acéptalo. Volverás al asistente, ya conectado.

Esto se hace una sola vez por asistente. A partir de aquí, pregunta con naturalidad: el asistente decide solo cuándo necesita consultar B2Brouter, y tú lo ves porque te lo indica en la conversación.

Conectarlo desde un agente de código

Si trabajas con un agente de código (Claude Code, o cualquier editor/IDE compatible con MCP), el conector se registra como un servidor MCP remoto más:

URL del servidor: https://app.b2brouter.net/mcp
Al añadirlo, el flujo de autorización se abre en el navegador: inicias sesión en B2Brouter y autorizas, como en el caso anterior.

El principio que lo gobierna todo: el asistente eres tú

El asistente actúa con tu identidad y tus permisos, ni más ni menos:

Solo ve las cuentas donde tu usuario es miembro.
Dentro de cada cuenta, solo ve las secciones que tú tienes permitidas. Si en la cuenta de la empresa solo tienes acceso a facturas recibidas, el asistente tampoco verá las emitidas.
Cada persona de la empresa conecta su propio usuario: no se comparten accesos ni permisos.

La sección 04 explica cómo funciona este modelo por dentro.

Desconectarlo

Desde tu perfil de B2Brouter → Aplicaciones autorizadas, puedes revocar el acceso del asistente cuando quieras. El efecto es inmediato. También puedes eliminar el conector desde el propio asistente.

Ver qué ha hecho el asistente

Cada consulta que el asistente hace a tu cuenta queda registrada: en tu perfil de B2Brouter → Actividad MCP verás qué se ha consultado y cuándo, con qué función y desde qué aplicación. Transparencia completa sobre la actividad de la IA con tus datos; también es útil, si eres gestoría, como trazabilidad de cara a tus clientes.

Si la conexión no funciona

Síntoma	Causa probable	Solución
«An account with an active subscription is required»	Tu usuario no tiene acceso a ninguna cuenta con suscripción de pago activa	Activa o renueva una suscripción, o pide que te añadan a una cuenta de pago
La autorización no termina / no vuelve al asistente	Bloqueo de ventanas emergentes o sesión caducada a mitad del flujo	Permite la ventana de B2Brouter, inicia sesión y repite la conexión
El asistente no ofrece B2Brouter	La plataforma aún no tiene el conector aprobado en su directorio	Añádelo manualmente por URL (`https://app.b2brouter.net/mcp`) si el asistente lo permite

Qué puedes hacer

No hace falta memorizar nada: pregunta con tus propias palabras y en tu idioma: el asistente traduce tu duda a las consultas que hagan falta.

Un buen primer paso, sobre todo si tienes acceso a más de una cuenta (grupo, filiales, o una cartera de clientes si eres gestoría):

«¿Qué cuentas de B2Brouter tengo?»

El asistente lista las cuentas donde tu usuario es miembro, con nombre e identificadores fiscales. A partir de aquí, puedes referirte a ellas con naturalidad («la cuenta de Cliente SA»).

1. Buscar y listar facturas

Este es el punto de partida de la mayoría de consultas: qué facturas cumplen una condición.

«¿Qué facturas tengo con errores?» «¿Qué facturas tengo rechazadas esta semana?» «Lístame las facturas vencidas, de mayor a menor» «Busca la factura FC-2026/0089 y dime en qué estado está»

El asistente lista las facturas que encajan, por estado (con error, rechazada, impagada…), por número o serie, por periodo, y desde la lista puedes pedir el detalle de cualquiera.

2. Examinar y validar una factura

Del resumen al detalle completo:

«Enséñame la factura 2026/0142»

El asistente devuelve el contenido completo: partes, líneas, importes, impuestos, condiciones de pago. Y la pregunta clave cuando algo falla:

«¿Por qué ha fallado la 2026/0142?» «¿Esta factura pasará la validación antes de enviarla?»

El asistente obtiene los errores de validación exactos y te los explica con la documentación oficial: qué significa cada error, qué campo afecta y qué hay que cambiar. La corrección la haces en la aplicación web (el conector no toca nada) y después puedes volver a verificar: «¿ya está bien?».

El cuerpo de la factura se devuelve en el formato exacto de la respuesta de la API REST, y la validación es la misma batería que el endpoint de validación: XSD + Schematron + reglas de modelo. Esto significa que tu agente de código puede cruzar el error directamente con el JSON que envía tu integrador y proponer la corrección a tu payload. El ciclo de trabajo recomendado para integraciones: (1) pregunta al agente cómo hacer las cosas, consulta las guías oficiales («¿cómo creo una factura por API y la envío por Peppol?», «¿cómo funciona el sandbox?»); (2) crea las facturas de prueba por API (el conector no crea nada); (3) diagnostica por el conector sin salir del editor («¿qué facturas del lote de pruebas han quedado en error?», «la factura 123 no valida, ¿qué tengo que cambiar en mi JSON?»); (4) para mapear formatos, las guías de mapping son consultables por el agente: JSON→Facturae, FatturaPA, UBL BIS3, CII, KSeF FA-3.

3. Seguir los informes fiscales

Si tu país tiene declaración o registro electrónico de facturas (Verifactu, SII o TicketBAI en España, DGFiP en Francia, KSeF en Polonia, ZATCA en Arabia Saudí, MyInvois en Malasia…), cada factura genera un informe fiscal con su propio ciclo de vida ante la autoridad. El conector lo sigue:

«¿Qué informes fiscales tengo en error o rechazados?» «¿Qué ha rechazado la autoridad fiscal de la cuenta de Cliente SA esta semana?» «¿El report de la factura FC-0089 ha quedado registrado correctamente?»

Y para cada rechazo, el diagnóstico completo:

«Detállame el primero» → estado, importes y el mensaje de rechazo literal de la autoridad. «¿Qué significa este error y cómo se corrige?» → el asistente cruza el código con las guías oficiales de B2Brouter de cada autoridad y te indica el campo afectado y la corrección.

Funciona para cualquiera de las autoridades soportadas, y puedes preguntar códigos sueltos: «¿qué significa este error 1210 de Verifactu?», «este código de rechazo del KSeF, ¿qué significa?».

4. Las cifras del negocio

Son las mismas cifras que el dashboard de B2Brouter; no hay dos verdades:

«¿Cómo hemos ido este trimestre?» → ingresos, gastos y resultado neto del periodo. «¿Qué tenemos pendiente de cobrar? ¿Cuánto está vencido?» → pendientes de cobro y pago, separados entre al día y vencidos, con número de facturas e importe. «¿Quiénes son nuestros principales clientes este año? ¿Y los proveedores?» → ranking por volumen facturado. «¿Cómo ha evolucionado la caja mes a mes?» → ingresos, gastos, diferencia y acumulado por mes.

Y la composición libre:

«Hazme un resumen para la reunión con el banco: facturación del año, evolución mensual, pendientes y vencidos destacados»

Detalles prácticos:

Periodos: este mes/trimestre/año, los anteriores, o cualquier intervalo concreto («del 1 de enero al 15 de marzo»).
Impuestos: pide las cifras con o sin IVA, según prefieras.
Monedas: cada resumen es de una sola moneda (por defecto, la de la cuenta). Si facturáis en más de una, pídelas por separado («y ahora en dólares»).

5. Cómo hacer llegar documentos a una empresa

Un cliente nuevo te pide factura electrónica y no sabes por dónde empezar. Dale al asistente el identificador fiscal del cliente (el NIF en España, el SIRET en Francia, la Partita IVA en Italia, el NIP en Polonia, el VAT number en el resto de la UE):

«¿Puedo enviar facturas electrónicas al NIF B51115943? ¿Cómo?» «¿Cómo envío facturas al SIRET 13002526500013?» «Este cliente alemán con VAT DE811907980, ¿recibe por Peppol?»

El asistente consulta el directorio de B2Brouter y te dice por qué canal recibe documentos esta empresa (Peppol, FACe, Chorus Pro, SDI…), qué tipos de documento acepta y qué códigos necesitarás: los códigos DIR3 para una administración pública española, el SIRET y el código de servicio para Chorus Pro, el Codice Destinatario para el SDI italiano, el identificador Peppol para clientes internacionales…

Si la empresa está en la red Peppol, pero los datos aún se están sincronizando, el asistente te lo dirá y lo reintentará.
Si no hay ninguna manera de enviarle documentos electrónicamente, te lo dirá claramente — y te puede explicar las alternativas.

El directorio tiene un límite de 50 búsquedas al día por usuario. La búsqueda es por identificador fiscal exacto; buscar por nombre aproximado no está disponible (está en estudio).

6. Preguntas sobre cómo funciona B2Brouter (y la facturación electrónica)

El asistente tiene acceso a la documentación oficial completa de B2Brouter. Pregunta como lo harías a soporte:

«¿Cómo creo una factura rectificativa?»
«¿Cómo configuro el TicketBAI?» · «¿Qué tengo que hacer para cumplir con la facturación electrónica francesa?» · «¿Cómo funciona el KSeF?»
«¿Qué es el código DIR3 y dónde lo pongo?» · «¿Qué es el identificador Peppol?»

Si la respuesta no está en la documentación, el asistente te lo dirá en lugar de inventársela. En ese caso, el canal de soporte de siempre sigue siendo el camino.

Encadenarlo todo

El valor del conector es que estas seis piezas se combinan de manera natural dentro de una conversación. Algunos flujos completos:

Desbloquear el trabajo del día: «¿qué facturas tengo con errores?» → «¿por qué ha fallado la primera?» → «¿qué significa este error?» → corriges en el panel → «¿ya está bien?».
La revisión fiscal de la mañana (gestorías): «¿qué ha rechazado la AEAT de la cuenta de Cliente SA esta semana?» → detalle del rechazo → traducción con la guía de la autoridad. Para revisar toda la cartera: «revisa todas mis cuentas y dime cuáles tienen informes rechazados» — funciona, pero con muchas decenas de clientes es lento (una consulta por cuenta); para el día a día suele ser más ágil por cliente concreto.
De lo global al detalle: «¿qué tenemos vencido?» → «lístamelas por importe» → «enséñame la más grande».
Integración (developers): guía de la API → crear por API en el sandbox → diagnosticar errores por el conector → corregir el payload.

Recuerda: el asistente solo lee. Crear, corregir, enviar y cobrar se hace en el panel o por API, como siempre. El trabajo que te ahorra es el de buscar, cruzar y entender.

Cómo funciona por dentro

No hace falta leer esta sección 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:

Tu asistente de IA (Claude, o el que uses): entiende la pregunta y decide qué información necesita.
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».
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 (ver «Auditoría», más abajo).

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.

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.

De dónde sale el conocimiento (y por qué no se inventa respuestas)

Cuando preguntas «¿cómo configuro el TicketBAI?», el asistente no responde de memoria: consulta la base de conocimiento oficial de B2Brouter: la guía de usuario completa, la documentación de developers y las guías de cada autoridad fiscal, la misma que publica B2Brouter y versionada con el producto.

Y lleva una instrucción explícita: si ningún documento cubre la pregunta, debe decir que no tiene la información, nunca inventar. Es la respuesta directa al riesgo más serio de usar IA en un dominio fiscal: una respuesta inventada pero convincente. Ningún asistente es infalible, pero el conector está construido para minimizar este riesgo y 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.

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 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.

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
Conocimiento oficial	Respuestas basadas en la documentación de B2Brouter, con un «no lo sé» explícito
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

Límites, seguridad y preguntas frecuentes

Qué NO hace el conector (por diseño)

No hace	Qué hacer en su lugar
Crear, modificar, enviar o borrar facturas y documentos	Panel de B2Brouter o API REST
Reclamar cobros, enviar recordatorios	Panel (el asistente te explica cómo)
Acciones sobre la suscripción o la configuración de la cuenta	Panel
Decirte automáticamente si tu cuenta «está lista» para una autoridad (Verifactu, DGFiP, KSeF…)	Pregúntaselo a la documentación («¿qué necesito para activar Verifactu?») y revisa la configuración en el panel
Buscar empresas en el directorio por nombre aproximado	Búsqueda por identificador fiscal exacto (NIF, SIRET, Partita IVA, NIP, VAT number…); la búsqueda por nombre está en estudio
Un resumen agregado de todas tus cuentas de una vez	Pídelo cuenta a cuenta, o deja que el asistente las recorra (lento con carteras grandes)

Límites de uso

Límite	Detalle
Directorio	50 búsquedas al día por usuario; el resto de funciones no tienen límite específico
Resumen financiero	Una moneda por resumen; cuentas multi-moneda, por separado
Plan	Cuenta de pago activa para conectar; Professional o superior para facturas, informes y finanzas

Seguridad y privacidad

La sección 04 explica el funcionamiento con detalle; este es el resumen de garantías:

El conector actúa con tu identidad. Solo tus cuentas, solo tus secciones (las mismas reglas que la web), comprobadas en cada consulta. Ni el asistente ni el proveedor de IA tienen credenciales propias sobre tu cuenta.
Consentimiento explícito y revocable. La autorización la apruebas tú (OAuth) y la puedes revocar en cualquier momento desde Aplicaciones autorizadas, con efecto inmediato. Si la suscripción caduca, el acceso se detiene solo.
Auditoría completa. Cada consulta queda registrada y es consultable en Actividad MCP.
Sin filtraciones entre cuentas. Un identificador inexistente y uno de otra cuenta dan el mismo error.
Protección ante contenido malicioso. El texto escrito por terceros (facturas recibidas, directorio) viaja marcado como datos, no instrucciones.
A dónde van tus datos. Las respuestas del conector las procesa el proveedor de IA que has conectado (Anthropic, 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.

Si algo no funciona

Síntoma	Causa probable	Solución
«An account with an active subscription is required»	Tu usuario no tiene acceso a ninguna cuenta con suscripción de pago activa	Activa o renueva una suscripción, o pide que te añadan a una cuenta de pago
«Not found or not authorized» al consultar una factura o informe	El identificador no existe o no tienes permiso para verlo (el mensaje es el mismo a propósito)	Comprueba el identificador y que tu usuario tiene acceso a esa sección de la cuenta; si es una cuenta de cliente, puede que su plan no incluya el conector
El asistente dice que no tiene la información	La pregunta queda fuera de la documentación de B2Brouter: el conector está diseñado para admitirlo en lugar de inventar	Contacta con el soporte de B2Brouter por el canal habitual
«Rate limit reached» en el directorio	Has superado las 50 búsquedas diarias	Espera al día siguiente o consulta el directorio desde el panel

Preguntas frecuentes

¿Necesito una clave de API?

No. La conexión se hace con tu usuario de B2Brouter, con una autorización que apruebas en el navegador.

¿Necesito saber programar?

No. Conectarlo son tres pasos en tu asistente de chat, y desde entonces solo conversas. El detalle técnico de este manual es opcional.

¿Lo puede usar todo el mundo de la empresa?

Cada persona conecta su propio usuario y tiene su propio alcance. No se comparten accesos ni permisos.

¿Hay límite de cuentas?

No: el asistente ve todas las cuentas donde eres miembro.

¿Las cifras del resumen financiero son fiables?

Salen del mismo motor que el dashboard del panel — son las mismas. Para decisiones fiscales o contables críticas, verifica siempre en la fuente primaria.

¿El asistente puede inventarse respuestas sobre normativa?

El conector está diseñado para que responda solo con la documentación oficial de B2Brouter y admita cuando no tiene la respuesta. Aun así, ningún asistente de IA es infalible: ante una decisión con consecuencias fiscales, confirma con tu asesor o con soporte.

¿Por qué no puede corregir la factura si ya ve qué está mal?

Decisión deliberada de seguridad de esta primera versión: todo es solo de lectura. Las capacidades de escritura se estudiarán más adelante, con su propio análisis de riesgos.

¿Por qué me dice «Not found or not authorized» si la factura existe?

Porque tu usuario no tiene acceso a ella (sección, cuenta o plan). El mensaje no distingue «no existe» de «no autorizado», por seguridad.

¿Puedo usarlo desde mi editor de código?

Sí — cualquier agente de código compatible con MCP (Claude Code, IDEs compatibles) se conecta con la misma URL y el mismo flujo de autorización. Ver la sección 02.

¿En qué idiomas funciona?

Pregunta en el idioma que quieras — el asistente traduce. La documentación que consulta es la oficial de B2Brouter.