Conectar tu asistente de IA

Folyo tiene un servidor MCP (Model Context Protocol) para que tu asistente de IA trabaje directo con tu cuenta: le preguntas por tus documentos, folios o IVA en lenguaje natural y el asistente consulta Folyo por ti.

Dos cosas importantes antes de partir:

  • Consulta y también emite, si lo habilitas. El asistente lee tu facturación en lenguaje natural y, cuando activas la emisión desde asistentes (disponible en los planes de pago), puede emitir documentos por ti. Nunca emite solo: primero te muestra receptor, líneas y total, y recién emite cuando confirmas repitiendo el total exacto. En certificación no emite.
  • Solo ve tu cuenta. La conexión usa tu API key, y todo queda acotado a la empresa de esa key. No existe forma de ver datos de otros clientes.

Requisitos

Una API key de tu cuenta. La creas en el dashboard, en Configuración, API keys. Trátala como una contraseña: cualquiera con la key puede leer los datos de tu empresa.

Conexión

El servidor vive en:

code
https://mcp.folyo.cl/mcp

La autenticación va en el header de cada request, con tu API key:

code
Authorization: Bearer strib_live_...

Claude Code

bash
claude mcp add folyo -s user --transport http https://mcp.folyo.cl/mcp \
  --header "Authorization: Bearer strib_live_TU_KEY"

Verifica con claude mcp list: debe aparecer folyo conectado.

Cursor

En .cursor/mcp.json (del proyecto o global):

json
{
  "mcpServers": {
    "folyo": {
      "url": "https://mcp.folyo.cl/mcp",
      "headers": {
        "Authorization": "Bearer strib_live_TU_KEY"
      }
    }
  }
}

Claude Desktop y otros clientes stdio

Los clientes que no soportan headers en conectores remotos pueden usar el puente mcp-remote. En claude_desktop_config.json:

json
{
  "mcpServers": {
    "folyo": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.folyo.cl/mcp",
        "--header",
        "Authorization: Bearer strib_live_TU_KEY"
      ]
    }
  }
}

Qué puede hacer tu asistente

Tu operación

  • folyo_documentos: tus últimos documentos emitidos con su estado en el SII (aceptado, reclamado, anulado). Es la consulta rápida del día a día.
  • folyo_dte_pdf: el PDF de un documento emitido, listo para mostrar o reenviar.
  • folyo_dte_xml: el XML firmado tal como se envió al SII.
  • folyo_dte_emitidos: tus ventas de un período según el registro oficial del SII.
  • folyo_dte_recibidos: tus compras de un período según el registro del SII.
  • folyo_dte_estado: el estado de un DTE puntual en el SII.
  • folyo_folios: folios disponibles por tipo de documento.
  • folyo_empresas: las empresas de tu cuenta y su configuración.
  • folyo_clientes: tu directorio de clientes y receptores; con un RUT busca uno puntual.
  • folyo_emision_estado: el estado de una emisión en curso, por su job_id.

Emitir documentos

Si el titular de la cuenta lo habilita, tu asistente puede emitir DTE. La emisión tiene resguardos que no se pueden saltar:

  • folyo_emitir_validar: arma el borrador y lo revisa sin emitir nada. Resuelve el receptor desde tu libreta o el SII, y chequea folios, empresa y montos. No quema folio.
  • folyo_emitir_dte: emite de verdad. Solo funciona si la empresa está en producción, tu plan incluye la emisión desde asistentes y el titular la activó para la empresa (es una autorización aparte: conectar el MCP no alcanza). Antes de emitir, el asistente te muestra receptor, líneas y total, y solo continúa cuando confirmas repitiendo el total exacto. Emitir quema un folio y es irreversible.

La emisión desde asistentes está disponible en los planes de pago; el resto de las herramientas de consulta y la validación de borradores funcionan en todos los planes. Se activa en el dashboard, en la configuración de la empresa. Viene desactivada.

Tributario

  • folyo_resumen_iva: débito, crédito e IVA a pagar del período, la foto para el F29.
  • folyo_acuses_pendientes: facturas recibidas que aún puedes aceptar o reclamar, ordenadas por urgencia. El plazo legal es de 8 días.
  • folyo_acuse_estado: el acuse de una factura que emitiste, para saber si tu cliente la recibió, aceptó o reclamó.

Feedback

  • folyo_feedback: le manda al equipo de Folyo un comentario tuyo, con tus palabras: una idea, algo que no funciona o algo que te gustó. El asistente solo la usa cuando se lo pides. No es soporte: lo leemos y decidimos.

SII

  • folyo_contribuyente: datos de cualquier RUT en el SII (razón social, giros, si es emisor electrónico).
  • folyo_situacion_sii: situación tributaria pública de un RUT.

Documentación

  • folyo_docs_buscar y folyo_docs_leer: esta misma documentación, servida al asistente. Si le pides integrar la API de Folyo en tu sistema, puede leer las guías y la referencia completa sin salir de la conversación.

Comandos listos para usar

El servidor también trae flujos guiados que tu cliente MCP muestra como comandos:

  • cierre_de_mes: informe ejecutivo del período, con IVA, ventas, compras, alertas y folios.
  • facturas_por_reclamar: revisa lo recibido antes de que corra la aceptación tácita.
  • integrar_folyo: genera la integración con la API usando solo la documentación oficial.

Preguntas que puedes hacerle

  • ¿Cómo van mis facturas de esta semana? ¿Alguna rechazada o reclamada?
  • ¿Cuánto IVA voy a pagar este mes?
  • ¿Qué facturas me llegaron y cuáles debería revisar antes de que venza el plazo?
  • ¿Cuántos folios de factura me quedan?
  • Muéstrame el PDF de la factura 1234.
  • ¿El RUT 76.123.456-7 es emisor electrónico? ¿Qué giros tiene?
  • ¿A qué clientes les facturé más el mes pasado?
  • Prepara una factura para el cliente Comercial X por estos ítems y muéstramela antes de emitir.
  • Quiero integrar Folyo en mi backend en Python: guíame.

Cuotas

Las consultas que van al SII en vivo (contribuyente, situación tributaria, emitidos y recibidos por período, estado de DTE) descuentan de la cuota mensual de tu plan, igual que si las hicieras por la API. Las lecturas locales (documentos, folios, PDF, XML, documentación) no consumen cuota. El detalle está en Rate limits y cuotas.