RUXI MCP / FACTURACIÓN CON IA

Tu asistente de IA,
conectado a
tu facturación.

Consulta tus comprobantes y prepara emisiones al SRI desde Codex, Claude Code y otros asistentes compatibles con Ruxi.

Tu cuenta Ruxi. Tu empresa. Los permisos que tú eliges.

ELIGE CON QUÉ
QUIERES TRABAJAR

01 / MIRA CÓMO FUNCIONA

De lo que preguntas
a lo que necesitas.

Explora un ejemplo paso a paso.
Datos ficticios; no se emiten comprobantes.

Tu asistente + RuxiEJEMPLO INTERACTIVO · PRUEBAS

Muéstrame mis facturas pendientes.

PASO 1 / 2

Primero, tu empresa

Voy a consultar los comprobantes de Negocio Ejemplo en el ambiente de pruebas.

ruxi.contexto
RUXI / EJEMPLO
CONTEXTO

Negocio Ejemplo

Ambiente de pruebas · Permiso de consulta

Factura de ejemplo 041En proceso
Factura de ejemplo 042En proceso
Datos ficticios · Sin validez tributaria

PASO 2 / 2

Encuentra lo pendiente

Estos comprobantes siguen en proceso. Puedo consultar su estado actualizado; todavía no están autorizados.

ruxi.listar-comprobantes
RUXI / EJEMPLO
EN PROCESO

2 facturas pendientes

Consulta los estados antes de entregar el XML o el RIDE.

Factura de ejemplo 041En proceso
Factura de ejemplo 042En proceso
Datos ficticios · Sin validez tributaria

Ayúdame a preparar una factura por un servicio de $100.

PASO 1 / 4

Completa los datos

Necesito los datos del comprador, el establecimiento y los impuestos aplicables. No voy a inventarlos.

ruxi.contexto
RUXI / EJEMPLO
PREPARACIÓN

Los datos, antes de emitir

Cliente Ejemplo · Un servicio · Cantidad 1

Servicio · 1 unidad$100.00
IVA ilustrativo · 15%$15.00
Total del ejemplo$115.00
Datos ficticios · Sin validez tributaria

PASO 2 / 4

Revisa y confirma

En este ejemplo el servicio tiene IVA del 15%. El total es $115. Revisa empresa, comprador, ambiente e importes antes de confirmar.

Revisión del usuario
RUXI / EJEMPLO
POR CONFIRMAR

Revisa tu factura

El siguiente paso representa tu confirmación.

Servicio · 1 unidad$100.00
IVA ilustrativo · 15%$15.00
Total del ejemplo$115.00
Datos ficticios · Sin validez tributaria

PASO 3 / 4

Solicitud recibida

La solicitud está en proceso. Conservaré la referencia para consultar el resultado. Recibida todavía no significa autorizada.

ruxi.emitir-factura-simple
RUXI / EJEMPLO
PENDIENTE_ENVIO

En camino al SRI

La autorización se consulta por separado.

Servicio · 1 unidad$100.00
IVA ilustrativo · 15%$15.00
Total del ejemplo$115.00
Datos ficticios · Sin validez tributaria

PASO 4 / 4

Comprueba el resultado

La consulta de este ejemplo devuelve AUTORIZADO. Ahora puedes obtener el XML y el RIDE. En una operación real, el resultado depende del SRI.

ruxi.consultar-comprobante
RUXI / EJEMPLO
AUTORIZADO

XML y RIDE disponibles

El documento autorizado ya puede descargarse en XML o RIDE.

Servicio · 1 unidad$100.00
IVA ilustrativo · 15%$15.00
Total del ejemplo$115.00
Datos ficticios · Sin validez tributaria

Consulta si mi factura está autorizada y obtén su XML y su RIDE.

PASO 1 / 3

Localiza el comprobante

Consultaré el comprobante que indicaste. Debe pertenecer a la empresa y ambiente de tu clave.

ruxi.consultar-comprobante
RUXI / EJEMPLO
CONSULTA

Factura de ejemplo

La consulta comprueba el estado actualizado.

comprobante.xmlVerificando disponibilidad
Datos ficticios · Sin validez tributaria

PASO 2 / 3

Confirma la autorización

El estado del ejemplo es AUTORIZADO. Ya puedo obtener el XML y el RIDE de este comprobante.

ruxi.consultar-comprobante
RUXI / EJEMPLO
AUTORIZADO

Autorización comprobada

XML y RIDE disponibles

comprobante.xmlXML autorizado · Ejemplo
Datos ficticios · Sin validez tributaria

PASO 3 / 3

Obtén tu documento

El MCP devuelve el XML y el RIDE en PDF del comprobante autorizado.

ruxi.descargar-comprobante
RUXI / EJEMPLO
XML Y RIDE

Tus archivos autorizados

Descarga ilustrativa. No contiene datos fiscales reales.

comprobante.xmlXML autorizado · Ejemplo
comprobante-ride.pdfRIDE autorizado · Ejemplo
Datos ficticios · Sin validez tributaria

Tú revisas y confirmas. Ruxi valida los permisos y conserva la identidad del comprobante.

02 / CONEXIÓN Y CONTEXTO

Las herramientas de Ruxi.
En tu asistente.

Model Context Protocol, o MCP, permite que tu asistente utilice herramientas externas con los permisos que le asignas.

MCP / LA CONEXIÓN

Accede a tus comprobantes.

Conecta el asistente con tu empresa y ambiente. Ruxi comprueba los permisos de la clave en cada operación.

SKILL / LAS INSTRUCCIONES

Guía cada paso.

La skill Ruxi orienta al asistente para revisar datos, pedir tu confirmación y consultar el resultado. Puedes instalarla en Codex y Claude Code.

Consulta y encuentra

Lista comprobantes de tu empresa y revisa sus estados con permisos de consulta.

Prepara y confirma

Facturas, notas, retenciones, liquidaciones y guías. Revisa los datos antes de confirmar la emisión.

Corrige y sigue el proceso

Corrige o reenvía cuando el estado y tus permisos lo permitan. Consulta el resultado del mismo expediente.

Obtén el XML y el RIDE

Descarga por MCP el XML autorizado y el RIDE en PDF de los comprobantes autorizados.

03 / CONECTA TU ASISTENTE

Elige tu asistente.
Sigue los pasos.

La configuración se hace una vez por empresa, ambiente e integración. Tu clave se guarda en tu equipo.

1 Accede a tu cuenta Ruxi

Verifica tu correo para continuar. Si ya tienes cuenta, ingresa con tus datos.

Crear mi cuenta ↗Ingresar ↗
2 Configura tu empresa

Registra tu empresa y firma electrónica vigente. Elige pruebas o producción y configura el ambiente cuando decidas, sin aprobación de Ruxi. La emisión necesita capacidad de tu plan o saldo.

Ver requisitos en mi cuenta ↗
3 Crea una clave con permisos

Elige empresa, ambiente y permisos en Claves API. Para empezar consultando, utiliza solo lectura. Guarda tu clave: se muestra una sola vez.

No pegues claves en la conversación ni las subas a repositorios. Puedes revocarlas desde tu cuenta.

Ir a Claves API ↗
4 Conecta y comprueba

Aplica las instrucciones de tu asistente. Después pide: «Consulta mi empresa y ambiente en Ruxi». Comprueba los datos antes de operar.

Abrir la guía de mi cuenta ↗

Paso 1 de 4: accede a tu cuenta.

Ruxi es vendedor y distribuidor de FirmaSeguraEC, respaldada y acreditada por ARCOTEL.

CONFIGURACIÓN / CODEX

Conectar Codex · OpenAI

Añade este bloque a la configuración de Codex. Define RUXI_API_KEY en el entorno desde el que abres Codex y reinicia el cliente para que la lea.

Ver configuración

En macOS/Linux, define la clave en la terminal desde la que abrirás Codex: export RUXI_API_KEY="<TU_CLAVE_API>". En Windows, crea la variable de entorno de usuario y reinicia Codex. Después añade este bloque al archivo indicado.

~/.codex/config.toml
[mcp_servers.ruxi]
url = "https://mcp.ruxi.ec/mcp"
bearer_token_env_var = "RUXI_API_KEY"
Añadir la skill Ruxi

Conecta MCP primero. Después ejecuta este comando en tu equipo para instalar las instrucciones de Ruxi.

Terminal · ~/.agents/skills/ruxi-mcp
mkdir -p ~/.agents/skills/ruxi-mcp && curl -fsSL https://ruxi.ec/skills/ruxi-mcp/SKILL.md -o ~/.agents/skills/ruxi-mcp/SKILL.md
Leer la skill antes de instalarla ↗

La integración de OpenAI se realiza mediante Codex. Esta configuración no conecta directamente el chat de ChatGPT.

CONFIGURACIÓN / CLAUDE

Conectar Claude Code

Con Claude Code instalado, ejecuta este comando en tu terminal. Sustituye <TU_CLAVE_API> por tu clave únicamente en tu equipo.

Ver configuración
Terminal de tu equipo
claude mcp add --transport http ruxi https://mcp.ruxi.ec/mcp \
  --header "Authorization: Bearer <TU_CLAVE_API>"
Añadir la skill Ruxi

Conecta MCP primero. Después ejecuta este comando en tu equipo para instalar las instrucciones de Ruxi.

Terminal · ~/.claude/skills/ruxi-mcp
mkdir -p ~/.claude/skills/ruxi-mcp && curl -fsSL https://ruxi.ec/skills/ruxi-mcp/SKILL.md -o ~/.claude/skills/ruxi-mcp/SKILL.md
Leer la skill antes de instalarla ↗
¿Usas Claude Desktop?

La alternativa actual requiere Node.js y el puente local mcp-remote. Encuentra la configuración específica en la guía de tu cuenta.

Ver alternativa para Claude Desktop ↗

CONFIGURACIÓN / CURSOR

Conectar Cursor

Añade Ruxi a mcpServers en la configuración local de Cursor. Sustituye <TU_CLAVE_API> en tu equipo y protege este archivo.

Ver configuración
~/.cursor/mcp.json
{
    "mcpServers": {
        "ruxi": {
            "url": "https://mcp.ruxi.ec/mcp",
            "headers": {
                "Authorization": "Bearer <TU_CLAVE_API>"
            }
        }
    }
}

También puedes leer las instrucciones de la skill Ruxi ↗ para conocer los flujos y sus límites.

CONFIGURACIÓN / VSCODE

Conectar VS Code

Configura el servidor MCP para el chat de VS Code. El cliente te pedirá la clave como dato protegido al iniciar la conexión.

Ver configuración
.vscode/mcp.json
{
    "servers": {
        "ruxi": {
            "type": "http",
            "url": "https://mcp.ruxi.ec/mcp",
            "headers": {
                "Authorization": "Bearer ${input:ruxiApiKey}"
            }
        }
    },
    "inputs": [
        {
            "type": "promptString",
            "id": "ruxiApiKey",
            "description": "Clave API de Ruxi",
            "password": true
        }
    ]
}

También puedes leer las instrucciones de la skill Ruxi ↗ para conocer los flujos y sus límites.

04 / TU CAPACIDAD DE FACTURACIÓN

Usa tu plan.
O tu saldo.

MCP comparte la capacidad de tu cuenta API. Las consultas no descuentan documentos; se mantienen los límites técnicos.

PAGO POR USO

$0.04 por documento + IVA

Saldo sin vencimiento. Recarga desde $10.00; total $11.50 con IVA.

Los documentos en proceso reservan saldo; se descuenta al autorizarse en producción.

Calcular mi recarga ↗

Tu asistente puede tener sus propios costos. Las condiciones particulares de tu cuenta se muestran al ingresar. Necesitas firma electrónica vigente y configurar producción con capacidad disponible. WooCommerce conserva su licencia independiente.

ANTES DE CONECTAR

Lo que necesitas
saber.

¿Qué es Ruxi MCP?

Es la conexión entre un asistente de IA compatible y las herramientas de facturación de tu cuenta Ruxi. MCP significa Model Context Protocol. El asistente opera con los permisos de una clave vinculada a tu empresa y ambiente.

¿Puedo usarlo con ChatGPT?

La conexión que explicamos para OpenAI se realiza mediante Codex, con MCP y la skill Ruxi. Esta guía no configura una conexión directa desde el chat de ChatGPT. También incluye Claude Code, Cursor y VS Code; Claude Desktop requiere un puente local adicional.

¿Para qué sirve la skill Ruxi?

La skill contiene instrucciones para elegir herramientas, revisar datos, solicitar confirmación y seguir el estado del comprobante. MCP aporta la conexión. Los permisos y las validaciones se comprueban en Ruxi, independientemente de la skill.

¿Qué necesito para empezar?

Una cuenta Ruxi, empresa configurada y clave API con permisos. Para emitir necesitas RUC, firma electrónica vigente y capacidad disponible. Puedes elegir pruebas o producción desde el alta, sin aprobación de Ruxi. El asistente elegido puede tener sus propios requisitos o costos.

¿Puedo descargar XML y PDF?

MCP permite obtener el XML y el RIDE en PDF de comprobantes autorizados. Un envío pendiente todavía no es una autorización del SRI.

¿Tiene un precio separado?

MCP utiliza la capacidad de facturación de tu cuenta API: plan o saldo prepago cuando esté habilitado. Las consultas no descuentan cupo de documentos, aunque tienen límites técnicos. Consulta las modalidades y condiciones vigentes en la página de la API.

¿Qué puede hacer mi asistente?

Según los permisos asignados, puede consultar, emitir, corregir y reenviar comprobantes. La guía pide tu confirmación antes de emitir, corregir o reenviar. Una clave limita el acceso a su empresa y ambiente; puedes revocarla desde el portal.

TU PRIMERA CONSULTA

«Consulta mi empresa
y ambiente en Ruxi».

Conecta tu asistente y comprueba que todo esté listo.

Conectar mi asistente
Detalle del producto

Captura de ejemplo: aquí no se pueden editar datos. Cierra esta vista para continuar en Ruxi. Sin validez tributaria.

¿Te ayudamos?Hablemos por WhatsApp