Servidor MCP / Documentación

Niutax · Servidor MCP

Tu asistente de IA, ahora experto en tu contabilidad

¿Usas Claude u otro asistente de IA? Aquí te mostramos cómo conectarlo con Niutax para que responda con datos reales en vez de suposiciones. La conexión usa MCP (Model Context Protocol), un estándar abierto — no necesitas entenderlo: basta copiar y pegar lo que te indicamos, y toma menos de un minuto.

Conecta tu asistente

gratis, sin registro

Busca tu aplicación de IA en la lista y sigue su paso. El resultado es el mismo en todas: tu asistente queda con las herramientas gratuitas de Niutax listas para usar en la conversación.

En claude.ai (web o aplicación de escritorio): entra a Ajustes → Conectores, presiona «Agregar conector personalizado» y pega esta dirección:

https://fin.niu.tax/mcp

En Claude Code (la herramienta para desarrolladores), un solo comando:

claude mcp add --transport http niutax https://fin.niu.tax/mcp

En Cursor u otra aplicación compatible con MCP, pega esta configuración en sus ajustes:

{
    "mcpServers": {
        "niutax": {
            "type": "http",
            "url": "https://fin.niu.tax/mcp"
        }
    }
}

No pide cuenta ni contraseña. Límite de 60 consultas por minuto. No almacenamos lo que consultas.

Herramientas gratuitas

Una vez conectado, tu asistente puede usar estas utilidades del día a día tributario chileno — tú solo preguntas en lenguaje natural («¿está bien este RUT?», «¿a cuánto está la UF hoy?») y él elige la herramienta:

  • validar-rut

    Valida un RUT chileno (dígito verificador módulo 11). Acepta el RUT con o sin puntos y guion, y lo devuelve normalizado y formateado. No almacena el RUT consultado.

  • indicadores-economicos

    Entrega el valor de los indicadores económicos chilenos — UF, UTM, dólar observado y euro — a una fecha dada (por defecto, hoy). Valores en pesos chilenos (CLP). En fines de semana y festivos se entrega el último valor publicado.

  • retencion-honorarios

    Entrega la tasa de retención de boletas de honorarios en Chile para un año dado (escala gradual de la Ley 21.133) y, si se indica un monto bruto, calcula la retención y el monto líquido en pesos.

  • calculo-iva

    Calcula el desglose de IVA chileno (19%) a partir de un monto: si el monto es neto agrega el IVA, si es bruto (IVA incluido) lo desglosa. Montos en pesos chilenos, redondeados al peso.

  • calendario-tributario

    Lista los vencimientos tributarios habituales en Chile para un mes dado (F29, F50, declaraciones juradas, renta anual F22, patente municipal). Guía general: los plazos en día inhábil se corren y las fechas de DJ/Renta varían por año.

Tu contabilidad, por IA

clientes Niutax

Si tu empresa usa Niutax, puedes conversar con tus datos reales: balances, estados de resultados (financiero y de gestión), flujo de caja histórico, cuentas por cobrar y por pagar, plan de cuentas, libros de ventas y compras, auxiliares y presupuestos. Y siempre con control: si le pides que proponga un asiento contable, queda pendiente de aprobación humana en el panel — nada se contabiliza solo; y si le pides que cargue tu presupuesto anual, primero te lo muestra y solo lo guarda cuando tú lo apruebas en la conversación (después puedes editarlo o borrarlo en el panel, como cualquier presupuesto).

Por ejemplo, pídele a tu asistente:

  • «¿Cómo cerró junio? Compárame el estado de resultados con mayo.»
  • «¿Quién me debe plata y hace cuánto está vencida?»
  • «Muéstrame el flujo de caja del año y en qué mes estuvimos más apretados.»
  • «Revisa la cuadratura del libro diario de este año.»
  • «Prepárame el borrador del asiento de la factura de arriendo.»
  • «Toma el estado de resultados del año pasado y ármame el presupuesto de este año con 10% más de ventas y 2% menos de gastos.»

El servidor incluye además el prompt analisis-mensual: un análisis financiero completo del mes con resumen ejecutivo en español.

Hay dos formas de conectarse. Si eres una persona usando su asistente, conéctate con tu cuenta de Niutax — es la vía recomendada y no requiere nada técnico. El token de empresa es para casos avanzados (sistemas automáticos sin una persona detrás); si no sabes qué es, no lo necesitas.

Conecta con tu cuenta

recomendada

Funciona igual que los botones «Iniciar sesión con Google»: agregas la dirección del servidor en tu aplicación de IA, se abre el navegador, inicias sesión en Niutax y presionas «Autorizar». Listo — no copias claves, verás solo las empresas y módulos que tu cuenta ya puede ver en el panel, y puedes cortar el acceso cuando quieras.

En claude.ai (web o aplicación de escritorio): Ajustes → Conectores → «Agregar conector personalizado» y pega esta dirección:

https://fin.niu.tax/mcp/empresa

En Claude Code:

claude mcp add --transport http niutax-empresa https://fin.niu.tax/mcp/empresa

En otras aplicaciones compatibles con MCP:

{
    "mcpServers": {
        "niutax-empresa": {
            "type": "http",
            "url": "https://fin.niu.tax/mcp/empresa"
        }
    }
}

¿Trabajas con varias empresas? Solo dile a tu asistente con cuál quieres trabajar («muéstrame el balance de Comercial XYZ»); si tiene dudas, él mismo consulta tu lista de empresas y te pregunta.

Token de empresa

uso avanzado

¿Necesitas esto? Si ya te conectaste con tu cuenta (sección anterior), no. El token de empresa sirve para conexiones que funcionan solas, sin una persona que inicie sesión: por ejemplo, un sistema interno o un proceso automático que consulta los datos de una misma empresa todos los días.

Un token es una clave secreta (un texto largo) que representa a una sola empresa y solo permite hacer lo que marcaste al crearlo. Trátalo como una contraseña: no lo compartas ni lo publiques.

  1. Crea el token en el panel de Niutax: Configuración → Integraciones. Al crearlo eliges qué puede hacer: cada casilla es un permiso — por ejemplo, reportes:read significa «leer reportes» y comprobantes:write «proponer asientos». Marca solo lo que tu conexión va a usar; en el catálogo de herramientas aparece el permiso que pide cada una.
  2. Copia el token (se muestra una sola vez) y reemplaza TU_TOKEN_AQUI en esta configuración, que se pega en los ajustes MCP de la aplicación que vas a conectar:
{
    "mcpServers": {
        "niutax-empresa": {
            "type": "http",
            "url": "https://fin.niu.tax/mcp/empresa",
            "headers": {
                "Authorization": "Bearer TU_TOKEN_AQUI"
            }
        }
    }
}

Si un token se filtra o deja de usarse, elimínalo en la misma página del panel: deja de funcionar al instante. Los tokens antiguos con acceso total (*) no sirven para esta conexión — crea uno nuevo marcando permisos.

Herramientas de empresa

Todo lo que tu asistente puede hacer una vez conectado. Casi todas son de consulta (etiqueta verde: solo leen, no cambian nada); las de etiqueta ámbar son las únicas que escriben, y cada una con su resguardo. La etiqueta indica además el permiso que pide un token de empresa — si te conectaste con tu cuenta, puedes ignorarla: aplican tus permisos del panel.

  • listar-mis-empresas

    sin permiso (descubrimiento)

    Lista las empresas a las que tiene acceso esta conexión, con el id que las demás tools reciben como empresa_id, y búsqueda opcional por nombre o RUT. Úsala primero si el usuario pertenece a más de una empresa; si tiene muchas, acota con "busqueda". El empresa_id es un identificador técnico interno: no lo muestres al usuario, refiérete a las empresas por nombre o RUT.

  • balance-ocho-columnas

    reportes:read

    Balance de 8 columnas (sumas, saldos, inventario y resultado) de la empresa autenticada, acumulado al año/mes indicado. Usa el máximo nivel de detalle: cada cuenta trae su código, nombre, código SII estándar y código de subtipo, para dar el mayor contexto posible al clasificar o asociar documentos. Montos en pesos chilenos.

  • balance-clasificado

    reportes:read

    Balance clasificado (activos/pasivos corrientes y no corrientes, patrimonio) de la empresa autenticada al año/mes indicado, opcionalmente comparado con el período anterior. Montos en pesos chilenos.

  • estado-resultados

    reportes:read

    Estado de resultados (EERR financiero) de la empresa autenticada al año/mes indicado, opcionalmente comparado con el período anterior. Montos en pesos chilenos.

  • estado-resultados-gestion

    reportes:read

    Estado de resultados gerencial (Informes de Gestión) de la empresa autenticada: ingresos, costos, gastos y no operacionales por cuenta, con margen, EBITDA, resultado líquido y rentabilidades. Tipos: mensual (enero al mes indicado, columna por mes), anual, comparativo (año vs año anterior), entre-fechas y proyectado (real + presupuesto). Permite filtrar por centro de costo o desglosar las columnas por centro de costo. Montos en pesos chilenos.

  • flujo-de-caja-historico

    reportes:read

    Flujo de caja histórico de la empresa autenticada para un año: ingresos y egresos efectivos mes a mes por cuenta contable (contrapartidas de los movimientos de caja/banco), con saldo inicial y final de cada mes. Permite filtrar por centro de costo. Montos en pesos chilenos.

  • cuentas-por-cobrar

    tesoreria:read

    Cuentas por cobrar de la empresa autenticada: documentos de clientes pendientes de cobro con saldo, antigüedad (días vencidos) y KPIs (total, vencido, por vencer, top deudores, distribución por tramo). Filtros opcionales por tramo de antigüedad, RUT del cliente y rango de fecha de documento. Montos en pesos chilenos.

  • cuentas-por-pagar

    tesoreria:read

    Cuentas por pagar de la empresa autenticada: documentos de proveedores pendientes de pago con saldo, antigüedad (días vencidos) y KPIs (total, vencido, por vencer, top acreedores, distribución por tramo). Filtros opcionales por tramo de antigüedad, RUT del proveedor y rango de fecha de documento. Montos en pesos chilenos.

  • movimientos-por-conciliar

    conciliacion:read

    Movimientos de la cartola bancaria que aún están pendientes de conciliar (sin asiento contable asociado) para un mes dado. Puede acotarse a una cuenta bancaria específica (por banco, número de cuenta o código contable) o, si se omite, devuelve el pendiente de todas las cuentas del mes. Cada movimiento trae su id, fecha, glosa, tipo (cargo/abono) y monto. Es el insumo para conciliar: úsalo para revisar qué movimientos bancarios faltan por reconocer. Montos en pesos chilenos (salvo cuentas en otra moneda).

  • plan-de-cuentas

    plan-cuentas:read

    Plan de cuentas de la empresa autenticada: código, nombre, clasificación (tipo y subtipo) y si la cuenta opera como cuenta por cobrar o por pagar. Acepta búsqueda por código o nombre. Úsalo para conocer las cuentas contables disponibles antes de analizar informes o proponer un comprobante.

  • totales-libro-diario

    reportes:read

    Totales del libro diario (debe/haber) de la empresa autenticada para un año o un mes específico. Útil para verificar cuadratura del período. Montos en pesos chilenos.

  • resumen-libro-ventas

    libros:read

    Resumen del libro de ventas de la empresa autenticada para un mes: totales y resúmenes por tipo de documento (sin el detalle documento a documento). Montos en pesos chilenos.

  • resumen-libro-compras

    libros:read

    Resumen del libro de compras de la empresa autenticada para un mes: totales y resúmenes por tipo de documento (sin el detalle documento a documento). Montos en pesos chilenos.

  • listar-auxiliares

    auxiliares:read

    Lista los auxiliares (clientes/proveedores/terceros) de la empresa autenticada, con búsqueda opcional por nombre o RUT. Devuelve hasta 50 resultados.

  • consultar-presupuesto

    presupuestos:read

    Consulta el presupuesto contable cargado de un año en la empresa autenticada: por cuenta y centro de costo, con los 12 montos mensuales y el total anual. Útil antes de proponer o sobrescribir un presupuesto con cargar-presupuesto, y para comparar presupuesto vs real. Montos en pesos chilenos.

  • cargar-presupuesto

    presupuestos:write escritura · con tu aprobación en el chat

    Carga el presupuesto contable anual de la empresa autenticada: por cada cuenta (identificada por su código del plan de cuentas), 12 montos mensuales de enero a diciembre, opcionalmente por centro de costo. La carga es INMEDIATA (no es un borrador): pide siempre confirmación explícita al usuario antes de llamar esta herramienta. Si alguna cuenta ya tiene presupuesto para el mismo año y centro de costo, la carga completa se rechaza informando cuáles; con sobrescribir=true se reemplazan (pide confirmación adicional). Montos en pesos chilenos.

  • crear-comprobante-borrador

    comprobantes:write escritura · queda en borrador

    Crea un comprobante contable BORRADOR en la empresa autenticada. Queda pendiente de aprobación humana en el panel de Niutax: nada se contabiliza automáticamente. Requiere mínimo 2 líneas y cuadratura (suma debe = suma haber). Usa idempotency_key para que los reintentos no dupliquen.

Permisos y seguridad

  • Consultar no cambia nada. Las herramientas de consulta son de solo lectura. Las dos que escriben tienen resguardo: los asientos propuestos quedan en borrador hasta que una persona los aprueba en el panel, y el presupuesto solo se carga cuando tú lo confirmas en la conversación (y puedes editarlo o eliminarlo en el panel).
  • Al conectar con tu cuenta aplican tus permisos del panel. El asistente ve exactamente lo mismo que tú: tus empresas habilitadas y los módulos que tu rol y plan te conceden — ni uno más. Puedes revocar la autorización cuando quieras.
  • El token de empresa representa a UNA sola empresa y solo puede usar las herramientas cuyos permisos marcaste al crearlo; los tokens con acceso total se rechazan. Eliminarlo en el panel corta el acceso al instante.
  • Tus datos no dan órdenes. El servidor instruye a los asistentes a tratar los nombres de terceros y las glosas contables como simples datos, nunca como instrucciones — una protección estándar contra manipulaciones.

Preguntas frecuentes

¿La IA puede modificar mi contabilidad?
No por sí sola. Las consultas no cambian nada. Si le pides un asiento, queda en borrador hasta que un usuario lo aprueba en el panel. Si le pides cargar un presupuesto, solo se guarda cuando tú lo confirmas en la conversación — y siempre puedes editarlo o borrarlo en el panel.
¿Conecto con mi cuenta o con un token de empresa?
Si eres una persona conversando con su asistente (Claude, Cursor…), con tu cuenta: es más simple y más seguro. El token de empresa es solo para conexiones automáticas donde no hay una persona que inicie sesión — un sistema interno, un proceso programado. Si tienes dudas, usa tu cuenta.
¿Cómo le quito el acceso a un asistente?
Si conectaste con tu cuenta, elimina el conector en tu aplicación de IA o revoca la autorización desde Niutax. Si usaste un token de empresa, elimínalo en Configuración → Integraciones: deja de funcionar al instante.
¿Qué aplicaciones de IA funcionan?
Cualquiera compatible con MCP: Claude (web, escritorio y Claude Code), Cursor, y la lista crece mes a mes.
¿Qué es Niutax?
Software chileno de contabilidad y gestión tributaria conectado al SII. Conoce más en niutax.cl.