Servidor MCP de Tupana: facturación electrónica, SII, cobranza y banco desde tu asistente de IA

El servidor MCP de Tupana conecta Claude, ChatGPT, Codex, Cursor o cualquier cliente compatible con Model Context Protocol a tu cuenta. Le pides en español que emita una factura, revise tus ventas, busque un documento o concilie un abono, y lo hace con tus datos reales. Nada irreversible se ejecuta sin tu confirmación.

Un puente entre tu IA y tu operación tributaria

Model Context Protocol (MCP) es un estándar abierto para que los asistentes de IA usen herramientas externas. El servidor de Tupana expone esas herramientas sobre tu cuenta: documentos tributarios, clientes, libros del SII, F29, cobranza, movimientos bancarios y contabilidad.

La diferencia con un facturador que solo emite es que Tupana también cobra, recauda y concilia. En la misma conversación puedes emitir una factura, mandarla por correo al cliente y después revisar si el pago llegó al banco.

  • Dirección del servidor: https://mcp.tupana.ai/mcp
  • Inicio de sesión con tu cuenta Tupana mediante OAuth 2.1, sin copiar contraseñas al asistente.
  • Permisos separados de lectura (tupana:read) y escritura (tupana:write).
  • Funciona con Claude Desktop, Claude Code, ChatGPT, Codex, Cursor y otros clientes MCP.

Cómo conectarlo en cinco minutos

Los pasos exactos para cada cliente están en la guía del servidor MCP. El flujo general es siempre el mismo:

  1. Agrega un conector: En tu cliente de IA, agrega un conector o servidor MCP remoto con la dirección https://mcp.tupana.ai/mcp. En Claude Code basta un comando en la terminal.
  2. Inicia sesión en Tupana: Se abre el navegador con la pantalla de Tupana. Entras con tu cuenta y apruebas el acceso del asistente.
  3. Elige la empresa: Si manejas varias empresas, indicas con cuál vas a trabajar. Puedes cambiar durante la conversación.
  4. Pide lo que necesitas: Escribe en español, por ejemplo: emite una factura a este RUT por la asesoría de octubre, o qué facturas vencen esta semana.
  5. Confirma las acciones: Antes de emitir o enviar, el asistente te muestra una vista previa. Solo se ejecuta cuando confirmas.

Qué puedes pedirle

El servidor agrupa sus herramientas por tema. Estas son las principales; la lista completa está en docs.tupana.ai.

Consultar documentos

Busca facturas, boletas y notas de crédito por folio, RUT, fecha, monto o estado, y obtén el link al PDF (search_documents, get_document_link).

Emitir

Facturas de venta, facturas de compra, facturas de exportación, notas de crédito y facturas programadas, siempre con vista previa antes de emitir (emit_document).

Clientes y proveedores

Busca clientes, completa sus datos desde el RUT con información del SII y revisa tus proveedores.

Reportes

Ventas por mes, principales clientes y productos, resumen de impuestos y gráficos listos para compartir.

SII

Libros de compra y venta y resumen del F29 del período.

Cobranza

Facturas pendientes de pago, cuentas por cobrar y por pagar, y reenvío de un documento por correo al cliente.

Banco

Movimientos bancarios, sugerencias de conciliación con puntaje y conciliación de un movimiento con su factura.

Contabilidad

Asientos, libro mayor, balance, estado de resultados y plan de cuentas, y creación de asientos contables.

Leer documentos

Extrae los datos de una orden de compra o un PDF para preparar la factura correspondiente.

Qué documentos se pueden emitir desde la conversación

El asistente usa las mismas reglas que la plataforma, así que valida el borrador antes de emitir: RUT del receptor, montos, impuestos, referencias y líneas de detalle.

DTE 33 · Factura electrónica

La factura afecta a IVA, la que más se emite.

DTE 34 · Factura exenta

Para ventas o servicios exentos de IVA.

DTE 46 · Factura de compra

Cuando compras a alguien que no factura, con retención de IVA.

DTE 61 · Nota de crédito

Para anular o corregir una factura ya emitida.

DTE 110 · Factura de exportación

Para ventas al extranjero.

Programadas · Facturas recurrentes

Deja agendada una factura mensual o con otra frecuencia y se emite sola.

Pedidos que puedes copiar y pegar

No necesitas aprender comandos. Estos son pedidos típicos; el asistente decide qué herramientas usar y te pregunta lo que falte, como el RUT del cliente o la fecha de vencimiento.

  • Emite una factura a 76.123.456-7 por 12 UF de asesoría de octubre, con vencimiento a 30 días.
  • Anula con nota de crédito la factura folio 1042 porque el cliente devolvió la mercadería.
  • Deja programada una factura mensual de 5 UF para este cliente desde el próximo mes.
  • ¿Cuánto vendí este trimestre comparado con el anterior? Hazme un gráfico.
  • ¿Quiénes son mis diez principales clientes del año y cuánto me deben hoy?
  • Muéstrame el libro de compras de septiembre y el resumen del F29.
  • ¿Qué abonos de esta semana no tienen factura asociada? Sugiéreme con cuál calzan.
  • Reenvíale por correo al cliente la factura folio 980.
  • Completa los datos de este cliente desde su RUT: razón social, giro y dirección.
  • Lee este PDF de orden de compra y prepárame la factura.

Consulta empresas chilenas a partir de su RUT

El servidor también da acceso a información pública de empresas registradas en el SII. Puedes pedirle los datos de una empresa por su RUT, revisar su historial o explorar empresas por rubro y tamaño, por ejemplo para preparar una cotización o conocer a un cliente nuevo antes de facturarle.

Al crear un cliente, el asistente usa esa misma información para completar razón social, giro y dirección, y así evitar los errores de digitación que después terminan en una nota de crédito.

La IA prepara, tú confirmas

Las acciones irreversibles, como emitir un documento al SII, siempre piden tu confirmación. Para emitir, el servidor exige generar primero una vista previa del documento: ves receptor, montos y detalle antes de que salga.

Además, el acceso es tuyo: inicias sesión con tu cuenta Tupana, apruebas los permisos de lectura y escritura por separado y trabajas sobre las empresas a las que tu usuario tiene acceso. Si trabajas en el ambiente de pruebas de developers.tupana.ai, los documentos no llegan al SII.

Funciona con el facturador de mercado y con el gratuito del SII

El asistente emite con el facturador que use tu empresa: el facturador de mercado de Tupana o el facturador gratuito del SII, al que Tupana se conecta con tu clave. Tú eliges, y el precio es el mismo.

Si usas el gratuito, considera sus límites: hasta 3 referencias y 10 líneas de detalle por documento, alrededor de $100 millones por factura y del orden de 600 a 700 facturas al mes. El facturador de mercado no tiene esos topes.

Conversaciones que reemplazan una mañana de trabajo

  1. Facturar desde una orden de compra: Le pasas el PDF de la orden de compra. El asistente extrae los datos, arma la factura con la referencia a la OC, te muestra la vista previa y, cuando confirmas, la emite y la envía por correo al cliente.
  2. Revisión de cobranza del lunes: Preguntas qué facturas están vencidas y quiénes deben más. El asistente lista los pendientes por cliente y te propone reenviar el documento a los que correspondan.
  3. Cuadrar el banco: Pides los abonos de la semana sin conciliar. El asistente trae las sugerencias de conciliación con su puntaje y concilia las que apruebes.
  4. Preparar la reunión de directorio: Pides las ventas de los últimos seis meses, los diez principales clientes y un gráfico. Lo tienes en segundos, con los datos reales de tu empresa.

También sirve para construir facturación en tu propio software

Además de operar, el servidor enseña a construir. Tiene herramientas que entregan el flujo completo de facturación chilena: pasos ordenados, reglas del SII para líneas y referencias, cómo buscar un cliente por RUT, vista previa, emisión y manejo de errores. Tu asistente de código (Claude Code, Codex o Cursor) las usa para escribir la integración con la API de facturación.

Para eso conviene trabajar con una llave del ambiente de pruebas: los documentos se numeran como SANDBOX y no llegan al SII. Documentación en docs.tupana.ai, especificación en OpenAPI v2 y ejemplos y recursos en GitHub.

Preguntas frecuentes

¿Qué es el servidor MCP de Tupana?

Un servidor oficial de Model Context Protocol que conecta tu cuenta Tupana con asistentes de IA como Claude, ChatGPT, Codex o Cursor, para que consultes y operes tu facturación, cobranza, banco y contabilidad conversando.

¿Cuál es la dirección para conectarlo?

https://mcp.tupana.ai/mcp. La agregas como conector o servidor MCP remoto en tu cliente de IA e inicias sesión con tu cuenta Tupana cuando se abra el navegador.

¿La IA puede emitir sin que yo lo apruebe?

No. Las acciones irreversibles, como emitir un documento, siempre piden tu confirmación, y para emitir el servidor exige una vista previa del documento antes.

¿Cómo se protege el acceso a mi cuenta?

Con OAuth 2.1: inicias sesión directamente en Tupana, sin entregarle tu contraseña al asistente, y apruebas por separado los permisos de lectura y escritura..

¿Con qué clientes funciona?

Con Claude Desktop, Claude Code, ChatGPT (en planes con conectores habilitados), Codex, Cursor y cualquier cliente compatible con MCP remoto.

¿Sirve para programar una integración?

Sí. El servidor incluye herramientas que explican el flujo completo de facturación chilena, para que Claude Code, Codex o Cursor escriban la integración con la API de Tupana usando el ambiente de pruebas.

Sigue leyendo