Facturar con inteligencia artificial: el conector MCP de Facturaencr

Respuesta corta: MCP (Model Context Protocol) es un estándar abierto para conectar asistentes de inteligencia artificial con otros sistemas. Facturaencr tiene un servidor MCP en https://api.facturaencr.com/v2/efactura/mcp: lo conectás a un asistente compatible, iniciás sesión con tu cuenta y le pedís, en tus palabras, una factura o un tiquete. El asistente prepara el comprobante, te muestra el resumen y solo lo emite si confirmás.

Esta guía explica qué es, cómo se conecta, qué puede hacer y qué salvaguardas tiene.

Qué es MCP, en simple

Un asistente de IA sabe conversar, pero no tiene acceso a tu facturación. MCP es la forma estándar de darle herramientas: buscar un CAByS, consultar un comprobante, preparar una factura. El asistente decide qué herramienta usar según lo que le pedís, y cada herramienta llama a la misma API de Facturaencr que usan el portal y las integraciones.

Qué le podés pedir

«Haceme una factura a Comercial Ejemplo S.A., cédula 3101000000, por dos horas de consultoría a ₡25.000 + IVA cada una, pagada por transferencia.»

«¿Qué facturas emití esta semana y cuáles rechazó Hacienda?»

«Anulá la factura de ayer a Juan Ejemplo.»

(Los nombres y la cédula son ficticios.)

Las herramientas

Para	Herramientas
Consultar	Listar emisores, buscar CAByS, buscar productos y clientes guardados, consultar un contribuyente en Hacienda, consultar y listar comprobantes, ver el consumo del conector
Preparar	Preparar factura, preparar tiquete, preparar anulación, preparar un lote
Emitir	Emitir comprobante, emitir lote, consultar un lote

Preparar, confirmar, emitir

El conector nunca emite en un solo paso:

1. Preparar. El asistente arma un borrador con tus datos y lo valida con las mismas reglas de la API. Si la cédula del cliente no está en el padrón de Hacienda, la factura no se prepara.
2. Confirmar. El asistente te muestra el resumen tal cual —emisor, ambiente, receptor, líneas y totales— y espera tu sí.
3. Emitir. Solo con un borrador preparado. En producción exige además una confirmación explícita de que el comprobante es real, porque un comprobante emitido no se borra: se anula con una nota de crédito.

Dos detalles más:

• El borrador vence a los 30 minutos. Si pasó más tiempo, se prepara de nuevo.
• Reintentar no duplica. Emitir dos veces el mismo borrador devuelve el mismo comprobante. Ver idempotencia.

Cómo se conecta

1. En tu asistente de IA, agregá un conector personalizado (MCP remoto) con la URL https://api.facturaencr.com/v2/efactura/mcp.
2. El asistente te lleva a Facturaencr a iniciar sesión y autorizar la conexión (OAuth). La pantalla te dice a qué aplicación le estás dando acceso.
3. Decidís si le das permiso para emitir comprobantes o solo para consultar. Sin el permiso de emitir, el asistente no ve las herramientas de emisión.

La autorización no le entrega tu contraseña ni tu certificado al asistente: le da un acceso limitado a tu cuenta, que funciona con la misma API, los mismos registros de auditoría y los mismos límites.

Si sos desarrollador, también podés conectarlo con tu API key, con las mismas cabeceras de la API.

Probalo primero en pruebas

Con una llave de pruebas, todo lo que emite el asistente va al ambiente de pruebas de Hacienda y no tiene valor fiscal. Es la mejor forma de ver cómo se comporta antes de usarlo con comprobantes reales. Ver sandbox de Hacienda.

Para qué sirve y para qué no

Sirve para:

• Facturar desde una conversación, sin abrir el portal.
• Consultar rápido qué emitiste, qué se rechazó y por qué.
• Encontrar el CAByS de un producto describiéndolo.
• Preparar lotes de comprobantes parecidos.

No reemplaza:

• Tu revisión. El asistente puede entender mal un precio o un cliente; por eso el resumen se confirma antes de emitir. Leelo.
• Tu contador. Para decidir el tratamiento fiscal de una operación, consultá a un profesional.
• El punto de venta. En un mostrador con cola, una pantalla de caja es más rápida que una conversación. Ver punto de venta.

Seguridad

• Datos que no se inventan. Las reglas del conector le piden al asistente preguntar si falta el medio de pago, la cédula o el precio, y preguntar cuál CAByS cuando hay varios parecidos.
• Producción con doble confirmación. Sin la confirmación explícita, no se emite un comprobante real.
• Acceso limitado a los permisos que elegiste al autorizar, con credenciales que vencen y se renuevan, nunca tu contraseña.

Las buenas prácticas para guardar las credenciales de tu cuenta están en custodia del certificado .p12.

Preguntas frecuentes

¿Qué es un servidor MCP?

Un servicio que le ofrece herramientas a un asistente de IA mediante el Model Context Protocol, un estándar abierto. El de Facturaencr ofrece herramientas para consultar, preparar y emitir comprobantes.

¿El asistente puede emitir facturas sin que yo lo sepa?

No. Siempre prepara primero y emite solo con un borrador que confirmaste; en producción pide además una confirmación explícita.

¿Qué asistentes de IA lo pueden usar?

Los que admiten conectores MCP remotos con OAuth.

¿Los comprobantes emitidos por IA son válidos?

Sí. Son los mismos comprobantes de la API, firmados con tu certificado y aceptados por Hacienda.

El conector MCP usa la misma API de Facturaencr que el portal y las integraciones. Probalo con una llave de pruebas y mirá los detalles en la documentación; si preferís facturar sin IA, el portal hace lo mismo desde el navegador.