Claude escribe el código y Tupana lo conecta. Con las especificaciones que mantiene Tupana (documentación, OpenAPI y servidor MCP), tu asistente de IA no genera solo el request: arma el flujo completo de tu producto, con formularios, validaciones, estados de carga, errores, pantallas de éxito y el manejo de webhooks. Funciona para emitir DTE al SII, leer el registro de compras y ventas, buscar empresas por RUT, cobrar con link de pago y leer bancos.
Authorization: Api-Key.En la terminal, dentro de tu proyecto, agrega el servidor y autentícate con /mcp:
claude mcp add --transport http tupana https://mcp.tupana.ai/mcp
Agrega el servidor en ~/.codex/config.toml, reinicia Codex y aprueba el acceso en el navegador:
[mcp_servers.tupana]
url = "https://mcp.tupana.ai/mcp"
En Ajustes, Conectores, elige Añadir conector personalizado, pega la URL y aprueba el acceso con tu cuenta Tupana.
https://mcp.tupana.ai/mcp
En Configuración, Conectores, elige Crear conector personalizado (requiere un plan con conectores) y pega la URL.
https://mcp.tupana.ai/mcp
Agrega el servidor en .cursor/mcp.json de tu proyecto:
{ "mcpServers": { "tupana": { "url": "https://mcp.tupana.ai/mcp" } } }
Guía completa en docs.tupana.ai/user-guide/mcp. En sandbox los documentos no llegan al SII; emitir o cobrar en producción siempre pasa por tu cuenta Tupana.
Emite facturas, boletas, notas de crédito y boletas de honorarios al SII, con XML, PDF y estados. API: POST /v2/documents/batch/ y GET /v2/documents/{document_id}/states/. Webhooks: document.issued, document.rejected, document.issue_failed.
Lee el registro de compras y ventas y las boletas de honorarios emitidas y recibidas de cada empresa conectada. API: GET /v2/documents/?document_type=received. Webhooks: document.updated, credential.validated, credential.invalid.
Busca cualquier empresa de Chile por RUT y precarga razón social, actividades y direcciones. Gratis y sin credenciales. API: GET /v2/master-entities/?rut=.
Cobra con un link de pago integrado a Transbank y recibe un webhook cuando llega el dinero. API: POST /v2/payment-requests/. Webhooks: payment_request.paid, payment_request.document_issued, payment_request.expired.
Cada cliente conecta su banco en Tupana Link y lees sus abonos y cargos, sincronizados cada hora. API: GET /v2/documents/?dte_type__code__in=100,101. Webhooks: connection.active, connection.requires_action, document.paid.
Bancos y SII en la misma integración: API bancaria, API del SII y la comparación con otras opciones de Chile.
Cada producto tiene un prompt para Claude o Codex que apunta a las fuentes oficiales (llms-full.txt y OpenAPI v2) en vez de inventar campos. El de facturación, por ejemplo, pide implementar el enrolamiento de la empresa, el formulario de factura con validación, la emisión unitaria y en lote, el estado por webhook, la descarga del PDF y el XML, y las notas de crédito que referencian el documento original, todo partiendo en sandbox.
Si tu agente corre dentro de tu SaaS, estas son tres herramientas típicas. La API key vive en tu backend como variable de entorno (TUPANA_API_KEY), nunca en el modelo ni en el navegador.
[
{
"name": "buscar_empresa_por_rut",
"description": "Datos de una empresa chilena desde su RUT (GET /v2/master-entities/?rut=).",
"input_schema": { "type": "object", "properties": { "rut": { "type": "string" } }, "required": ["rut"] }
},
{
"name": "emitir_documentos",
"description": "Emite DTE al SII en lote (POST /v2/documents/batch/). Solo después de que la persona confirme la vista previa.",
"input_schema": { "type": "object", "properties": { "documents": { "type": "array" } }, "required": ["documents"] }
},
{
"name": "estado_documento",
"description": "Estado de un documento en el SII (GET /v2/documents/{document_id}/states/).",
"input_schema": { "type": "object", "properties": { "document_id": { "type": "string" } }, "required": ["document_id"] }
}
]
Tupana publica SDKs oficiales de código abierto (MIT) para Node.js y Python, con reintentos, Idempotency-Key automático, errores tipados y verificación de webhooks. Con la key de sandbox puedes emitir facturas de prueba: nada llega al SII.
npm install tupana
import Tupana from "tupana";
const tupana = new Tupana({ apiKey: process.env.TUPANA_API_KEY }); // key de sandbox
const batch = await tupana.documents.createBatch({ documents: [{
dte_type: { code: "33" },
document_issuer: { rut: "76543210-3" },
document_receiver: { rut: "77777777-7" },
details: [{ item_name: "Asesoría contable", quantity: 1, unit_price: 150000 }],
}] }, { useDefaults: true });
const result = await tupana.documents.waitForBatch(batch.batch_id);
pip install tupana
from tupana import Tupana
tupana = Tupana() # lee TUPANA_API_KEY (tu key de sandbox)
batch = tupana.documents.create_batch([{
"dte_type": {"code": "33"},
"document_issuer": {"rut": "76543210-3"},
"document_receiver": {"rut": "77777777-7"},
"details": [{"item_name": "Asesoría contable", "quantity": 1, "unit_price": 150000}],
}], use_defaults=True)
result = tupana.documents.wait_for_batch(batch["batch_id"])
Ejemplos completos (emisión masiva, webhooks, agente con confirmación humana) en https://github.com/tupana-ai/tupana-examples.
La regla es la misma con MCP o con tool calling: el agente prepara el documento y una persona lo confirma antes de emitirlo al SII. Un DTE emitido no se borra, solo se anula con una nota de crédito.
Más patrones en Agentes de IA que facturan, cobran y concilian.
En producción, Facturación cuesta 0,5 UF al mes por empresa enrolada, sin mínimo; el sandbox es gratis. Tabla completa en precios de la API.
Empieza en el sandbox gratis, prueba el flujo de conexión en Tupana Link o busca empresas en la nómina gratuita.
Un asistente que hable MCP (Claude Code, Codex, Cursor, ChatGPT o Claude) conectado a https://mcp.tupana.ai/mcp, y una API key de sandbox de www.tupana.ai (consola de developers). El asistente lee el contrato de facturación (pasos, reglas del SII, estados y manejo asíncrono) y escribe el código contra tu base.
El MCP sirve para que tu asistente de código construya la integración y para operar tu cuenta con OAuth. Tool calling sirve cuando el agente vive dentro de tu producto: declaras los endpoints de la API REST v2 como herramientas y llamas con tu API key desde tu backend.
Puede preparar y validar el documento, pero una persona confirma antes de emitir al SII. Un DTE emitido no se borra: solo se anula con una nota de crédito. Por eso toda escritura del MCP pide confirmación y queda auditada.
Construir es gratis: el sandbox no tiene costo ni plazo. En producción, Facturación cuesta 0,5 UF al mes por empresa enrolada, lectura del SII 0,2 UF por empresa, bancos 0,35 UF por banco y recaudación 2% + IVA.