Integración con asistentes de IA (MCP): Claude, ChatGPT y otras IA

BitFactura es compatible con MCP (Model Context Protocol), un estándar que permite a los asistentes de IA (por ejemplo, Claude Desktop, ChatGPT Desktop y Codex) leer de forma segura los datos de tu cuenta y responder preguntas sobre facturas y clientes sin necesidad de copiar datos manualmente ni introducir tokens de API.

¿Qué puede hacer un asistente de IA?

Una vez conectado, el asistente de IA puede, en tu nombre realizar las siguientes funciones:

buscar facturas: por número de factura, nombre del comprador, cliente, estado (emitida/enviada/pagada/parcialmente pagada/rechazada), tipo de documento (factura IVA, factura proforma, corrección, factura simplificada, factura de anticipo/final) y rango de fechas, por separado para ventas y compras;
consultar información de clientes: datos de contacto, dirección, número de identificación fiscal(NIF), número de cuenta bancaria y número de facturas relacionadas (por ID del cliente);
consultar los pagos de los clientes: cuánto ha pagado el cliente y cuánto queda por pagar, desglosado por moneda y rango de fechas.
Ejemplos de preguntas que puedes hacer al asistente después de conectarlo: “¿Qué facturas emití a la empresa X este mes?”, “¿Cuánto nos debe todavía esta empresa?”, “Indícame el número de IVA y la dirección del cliente con ID 123”.

¡IMPORTANTE! La integración funciona únicamente en modo lectura unicamente; el asistente de IA no puede emitir, editar ni eliminar facturas, clientes ni ningún otro dato de la cuenta. Las normas de uso del servicio MCP se establecen en los Términos y condiciones del servicio MCP.

¿Qué se necesita para utilizar MCP?

Para utilizar BitFactura MCP, necesitas:

una cuenta en BitFactura y acceso a la cuenta que deseas conectar con el rol de administrador principal;
un cliente de IA compatible con servidores MCP remotos mediante HTTP y autorización OAuth 2.1 con PKCE;
la dirección de tu cuenta en BitFactura; esta es la dirección que utilizas para iniciar sesión en tu cuenta desde un navegador, por ejemplo, https://tu-cuenta-ejemplo.bitfacura.com. Esta dirección será necesaria para crear la dirección del servidor MCP.

¡IMPORTANTE! La conexión MCP solo puede ser establecida por un usuario con el rol de administrador principal.

¿Cómo conectar un asistente de IA a BitFactura?

Para conectar un asistente de IA a BitFactura:

En la configuración de tu cliente de IA (por ejemplo, Claude Desktop), añade un nuevo servidor MCP e introduce la dirección https://tu-nombre.bitfactura.com/mcp (sustituye tu-nombre por el prefijo de tu cuenta; es el mismo que aparece en la dirección del navegador cuando has iniciado sesión en BitFactura).
Al conectarte por primera vez, el cliente de IA abrirá la pantalla de inicio de sesión de BitFactura en tu navegador (si aún no has iniciado sesión), seguida de una pantalla de consentimiento. Verás el nombre de la aplicación de IA y una lista de las funciones a las que solicita acceso.
Haz clic en Permitir para autorizar el acceso, o en Denegar si no quieres conectar este asistente a tu cuenta.
A partir de ese momento, el asistente de IA podrá responder preguntas utilizando los datos de tu cuenta sin que tengas que volver a iniciar sesión (hasta que revoques el acceso).

¿Cómo conectar un asistente de IA a BitFactura — Claude Desktop?

Para integrar BitFactura con Claude Desktop:

Inicia sesión en Claude Desktop y abre la configuración de la aplicación: Settings > Connectors > Add custom connector,
Completa los campos:
- Nombre del conector: BitFactura (o cualquier otro nombre que quieras ver en la aplicación).
- URL del servidor MCP remoto: https://tu-cuenta-ejemplo.bitfacura.com/mcp, donde debes sustituir tu-cuenta- ejemplo por el prefijo de tu cuenta,
Haz clic en Add y, a continuación, en Connect. Se abrirá una ventana del navegador con BitFactura,
Si el sistema lo solicita, inicia sesión y, a continuación, aprueba el acceso en la pantalla de consentimiento.
Listo; el asistente de Claude Desktop tiene acceso de solo lectura a tu cuenta en BitFactura.

¿Cómo conectar un asistente de IA a BitFactura — Claude Code?

Añade el servidor (sustituye la dirección por la tuya):

claude mcp add BitFactura–transport http https://tu-cuenta-ejemplo.bitfacura.com/mcp

De forma predeterminada, el servidor se guarda para el proyecto actual (–scope local). Para que esté disponible en todos los proyectos, añade –scope user:

claude mcp add BitFactura–transport http –scope user https://acme.bitfactura.com/mcp

Inicia sesión (autorización OAuth). En Claude Code, ejecuta:

/mcp

Selecciona BitFactura y confirma el inicio de sesión. Se abrirá una ventana del navegador con BitFactura. Inicia sesión (si es necesario) y aprueba el acceso en la pantalla de consentimiento.

Listo. Ahora puedes preguntar, por ejemplo:

Muéstrame las 5 facturas impagadas más recientes

Como alternativa, en lugar de utilizar el comando, puedes añadir una entrada al archivo de configuración del cliente (por ejemplo, .mcp.json en el directorio del proyecto o claude_desktop_config.json en Claude Desktop):

{
  "mcpServers": {
    "BitFactura": {
      "type": "http",
      "url": "https://acme.bitfactura.com/mcp"
    }
  }
}

Después de añadir la entrada, debes completar igualmente la autorización OAuth a través de /mcp.

Cómo conectar el asistente de IA a BitFactura – Codex

Añade el servidor (sustituye la dirección por la tuya):

codex mcp add- url https://tu-cuenta.bitfactura.com/mcp Bitfactura

La entrada se guardará en ~/.codex/config.toml; no es necesario editar el archivo manualmente.

Inicia sesión (autorización OAuth):

codex mcp login BitFactura

Se abrirá una ventana del navegador con BitFactura. Inicia sesión y autoriza el acceso. Codex gestionará automáticamente el regreso (escucha en un puerto local).

Listo. Pregunta por tus datos.

Como alternativa, puedes añadir la entrada manualmente en ~/.codex/config.toml (Codex utiliza el formato TOML):

[mcp_servers.BitFactura]
url = "https://acme.bitfactura.com/mcp

y luego inicia sesión utilizando codex mcp login BitFactura.

Cómo conectar el asistente de IA a BitFactura – Otro cliente (cualquiera)

BitFactura MCP funciona con cualquier cliente compatible con un servidor MCP remoto mediante Streamable HTTP y OAuth 2.0. Simplemente introduce la dirección del servidor: https://tu-cuenta.bitfactura.com/mcp.

La mayoría de los clientes aceptan una entrada en formato JSON en su archivo de configuración:

 "mcpServers": {
    "BitFactura": {
      "type": "http",
      "url": "https://acme.bitfactura.com/mcp"
    }
  }
}

No es necesario crear ninguna aplicación ni copiar el client_id ni los secretos. El cliente se registra automáticamente (Dynamic Client Registration) y obtienes acceso iniciando sesión mediante OAuth en tu navegador.

¿Qué ocurre si tengo varias cuentas en BitFactura?

El acceso está vinculado a una cuenta específica (subdominio). Si quieres que el asistente de IA tenga acceso a varias de tus cuentas, añade una entrada independiente para cada cuenta en el cliente de IA, por ejemplo:
{
“mcpServers”: {
“BitFactura - Empresa A”: { “type”: “http”, “url”: “https://empresa-a.bitfactura.com/mcp” },
“BitFactura - Empresa B”: { “type”: “http”, “url”: “https://empresa-b.bitfactura.com/mcp” }
}
}

¿Cómo revocar el acceso de una aplicación de IA?

Puedes comprobar en cualquier momento qué aplicaciones de IA tienen acceso a tu cuenta y revocar dicho acceso:

En BitFactura, ve a Ajustes > Ajustes de cuenta > Integración.
En la sección Aplicaciones de IA, haz clic en Gestionar el acceso de las aplicaciones de IA.
Se mostrará una lista de las autorizaciones activas (nombre de la aplicación y fecha de autorización). Para cada una, estará disponible la opción Revocar acceso.

También puedes revocar el acceso directamente desde la configuración del propio cliente de IA.

Información importante sobre MCP

La autorización se realiza mediante el estándar OAuth 2.1 con PKCE; nunca es necesario introducir manualmente un token de API, simplemente inicia sesión normalmente a través de BitFactura.
El acceso siempre está vinculado a una cuenta específica; un token emitido para una cuenta no funcionará con otra cuenta.
Las consultas del asistente de IA funcionan en modo de solo lectura, con un límite de tiempo de ejecución; el asistente no puede modificar ni sobrecargar la base de datos.
El acceso es totalmente reversible y transparente; puedes ver quién tiene acceso en cualquier momento y revocarlo cuando lo desees.

Problemas más frecuentes y soluciones

❓ El navegador no se abrió o el proceso de inicio de sesión no se completa.
Inicia de nuevo el proceso de inicio de sesión (/mcp en Claude Code, codex mcp login en Codex). Asegúrate de haber iniciado sesión en la cuenta correcta de BitFactura en el mismo navegador.
❓ “Falta acceso a la cuenta” o aparece un error después de la confirmación.
El usuario que ha iniciado sesión debe tener acceso a la cuenta correspondiente a la dirección a la que te estás conectando. Comprueba que el prefijo de la dirección …/mcp corresponda a la empresa correcta.
❓ El asistente no puede ver las herramientas o el servidor aparece como “failed”.
Comprueba la dirección del servidor (debe terminar en /mcp) y la conexión. En Claude Code, puedes consultar el estado y volver a conectarte desde el panel /mcp.
❓ La respuesta está vacía o indica “no encontrado”.
Haz que tu consulta sea más específica (por ejemplo, rango de fechas, estado o moneda). Recuerda que los resultados están limitados a la cuenta conectada y a los datos a los que se puede acceder mediante las tres herramientas disponibles.

Fuentes