Folyo MCP
MCP de facturación electrónica: tu operación tributaria desde un asistente
Folyo expone un servidor MCP (Model Context Protocol) para que el asistente que ya usa tu equipo consulte tus documentos, folios e IVA en lenguaje natural y, si lo habilitas, emita facturas con tu confirmación.
Actualizado el
Qué es un MCP de facturación electrónica
MCP (Model Context Protocol) es un estándar abierto que permite que un asistente o agente se conecte a herramientas externas de forma controlada. En vez de copiar datos a mano entre el asistente y tu sistema de facturación, el asistente llama a herramientas definidas por el servidor, recibe respuestas estructuradas y responde con ellas. Un MCP de facturación electrónica es, entonces, un servidor que pone tu cuenta de facturación al alcance del asistente, con herramientas acotadas y permisos claros.
Con el MCP de Folyo, conectar la facturación electrónica a un asistente significa que puedes pedir cosas como estas, en lenguaje natural: emitir una factura a un RUT con tres líneas y mostrarla antes de enviarla; ver si el SII aceptó la factura 1042; revisar cuántos folios de factura quedan disponibles; listar las facturas recibidas del mes y cuáles están por vencer su plazo de reclamo; o pedir el resumen de IVA del período para preparar el F29.
Cada pregunta se traduce en una llamada a una herramienta del servidor, que consulta la API de Folyo con la credencial de tu cuenta. El asistente no accede a bases de datos ni a paneles internos: solo ve lo que esa credencial ve, y toda emisión pasa por las mismas validaciones y el mismo motor que la API y la plataforma.
El MCP es un canal adicional, no un reemplazo. El panel y la API siguen disponibles; el asistente se suma para quien prefiere preguntar en vez de navegar, para contadores que revisan varias cuentas y para equipos técnicos que integran la API y quieren que su asistente lea la documentación oficial desde la conversación.
Cómo conectar la facturación electrónica con tu asistente
El servidor remoto vive en https://mcp.folyo.cl/mcp. La conexión toma minutos y no requiere instalar nada en tu servidor; la guía de conexión tiene los ejemplos completos por cliente.
- 01
Crea tu cuenta en Folyo
El plan gratuito incluye el MCP en modo de lectura y la preparación de borradores. Registra tu empresa y, si quieres probar sin efectos tributarios, déjala en el ambiente de certificación del SII.
- 02
Genera una API key
Desde Configuración, API keys, crea una clave asociada a la empresa que quieres conectar. Trátala como una contraseña: no la pegues en conversaciones ni la compartas. Puedes darle fecha de expiración y revocarla cuando quieras.
- 03
Configura tu cliente MCP
Agrega el servidor en el cliente que uses. La guía trae ejemplos para Claude Code, Cursor y Claude Desktop; los clientes que no soportan encabezados en conectores remotos pueden usar el puente mcp-remote. La clave viaja en el encabezado Authorization de cada petición.
- 04
Prueba en certificación
Con la empresa en certificación, el asistente puede consultar documentos, folios y contribuyentes, y validar borradores de emisión sin quemar folios. En ese ambiente la emisión queda bloqueada por diseño: es el espacio para probar.
- 05
Pasa a producción y activa la emisión
Cuando tu empresa esté autorizada por el SII y en producción, la emisión desde asistentes se activa en la configuración de la empresa. Es una autorización aparte: conectar el MCP no la habilita por sí sola, y viene desactivada.
Configuración del cliente MCP
Ejemplo tomado de la guía de conexión para Cursor, en el archivo .cursor/mcp.json del proyecto o global. Reemplaza strib_live_TU_KEY por tu API key.
{
"mcpServers": {
"folyo": {
"url": "https://mcp.folyo.cl/mcp",
"headers": {
"Authorization": "Bearer strib_live_TU_KEY"
}
}
}
}Qué puedes hacer con el MCP de Folyo
El servidor expone 23 herramientas y tres flujos guiados. Todas las de consulta se declaran de solo lectura según el protocolo; la emisión es la única que escribe.
Operación diaria
Tus últimos documentos emitidos con su estado en el SII, el estado de un DTE puntual, el PDF y el XML firmado de un documento, los folios disponibles por tipo, las empresas de tu cuenta y tu directorio de clientes. También el estado de una emisión en curso.
Ventas, compras e IVA
Documentos emitidos y recibidos de un período según el registro del SII, las compras del RCV por sección tributaria y el resumen de IVA del mes: débito, crédito e IVA a pagar, la foto para el F29.
Acuses de recibo
Facturas recibidas que aún puedes aceptar o reclamar, ordenadas por urgencia dentro del plazo de 8 días, y el acuse de las facturas que emitiste: si tu cliente las recibió, aceptó o reclamó.
Guías de despacho
Guías emitidas con su estado de facturación y cuáles siguen pendientes de factura. El asistente puede armar el borrador de la factura que cubre una o varias guías, con sus referencias, sin emitir ni consumir folio.
Emisión asistida
Validación del borrador completo sin efectos (receptor, folios, montos, dependencias del tipo) y emisión real solo cuando confirmas el total exacto. Disponible en los planes de pago, con la empresa en producción y activada por el titular.
SII, documentación y feedback
Datos de cualquier RUT en el SII (razón social, giros, si es emisor electrónico), situación tributaria pública, búsqueda y lectura de la documentación oficial de la API para integrarla desde la conversación, y un canal para enviar comentarios al equipo de Folyo.
Controles y límites del asistente
El MCP actúa con la credencial de tu cuenta y hereda exactamente sus permisos. Cada API key queda ligada a una empresa: el asistente opera sobre esa empresa y no ve otras cuentas ni otras empresas. No tiene acceso a base de datos, endpoints de administración ni datos de terceros. Si revocas la clave, la conexión deja de funcionar en el momento.
La emisión tiene cuatro condiciones que se verifican en cada llamada, no una vez: la empresa debe estar en producción; el plan de la cuenta debe incluir la emisión desde asistentes (disponible desde el primer plan de pago); el titular debe haberla activado para esa empresa en la configuración; y el asistente debe enviar la confirmación con el total exacto que devolvió la validación. Si falta cualquiera, la herramienta responde con el motivo y no emite. La emisión además viaja con una clave de idempotencia determinista, así un reintento del mismo documento no consume un segundo folio.
Las cuotas son las de tu plan. Las consultas que van al SII en vivo (contribuyente, situación tributaria, emitidos y recibidos por período, estado de un DTE) descuentan de la cuota mensual igual que si las hicieras por la API. Las lecturas locales (documentos, folios, PDF, XML, documentación) no consumen cuota, aunque las descargas de PDF y XML tienen un límite de ráfaga propio. El servidor MCP aplica también un límite de peticiones por clave y, al superarlo, indica cuánto esperar.
Lo que el asistente no puede hacer: emitir sin que confirmes, emitir en certificación o en planes gratuitos, cambiar la configuración de tu empresa, administrar usuarios o claves, ni consultar datos de una empresa distinta a la de su credencial. Las decisiones tributarias siguen siendo tuyas: el asistente muestra la información y prepara el documento, pero no lo envía sin tu visto bueno.
Preguntas frecuentes sobre el MCP de facturación electrónica
¿Con qué asistentes funciona?
¿Es seguro darle acceso a mi facturación?
¿Puede emitir sin que yo confirme?
¿Sirve para boletas?
¿Necesito saber programar?
¿Tiene costo adicional?
¿Qué pasa si mi empresa está en certificación?
Tu primer documento está a una decisión de distancia.
Parte gratis, valida tu operación y escala cuando el volumen lo pida.