Servidor MCP · facturación electrónica con IA

Factura al SRI hablándole a tu asistente de IA

Conecta Claude, Cursor, VS Code, n8n o tu propio agente a AZUR en un minuto. Busca clientes y productos, consulta comprobantes e inventario y prepara facturas en lenguaje natural, con tu credencial y tus permisos.

URL: https://azur.com.ec/mcp Streamable HTTP · stdio
Asistente conectado a AZUR
Prepara una factura para Ferretería El Tornillo: 3 cajas de tornillos y 1 taladro.
buscar_clientes · buscar_productos · guardar_factura
Listo. Dejé el borrador 001-001-000000124 para FERRETERÍA EL TORNILLO S.A.: 3 × Tornillo 1/2" y 1 × Taladro, total $187,45 con IVA 15 %. Revísalo y envíalo al SRI desde AZUR cuando quieras.
¿Cuántos taladros me quedan?
Te quedan 7 en la bodega Principal (después de esta factura quedarán 6).
¿Qué es MCP?

El puente entre tu IA y tu facturación

MCP (Model Context Protocol) es el estándar abierto que usan los asistentes de IA para conectarse con otros sistemas. Con el servidor MCP de AZUR, tu asistente deja de solo «conversar» y pasa a trabajar con tus datos reales: tus clientes, tus productos, tu inventario y tus comprobantes.

Lenguaje natural

Pides lo que necesitas como se lo pedirías a un asistente humano. Sin pantallas, sin XML, sin copiar y pegar.

Funciona con tu IA

Claude, Cursor, VS Code, Windsurf, n8n, la API de Anthropic o la de OpenAI: cualquier cliente compatible con MCP.

Hecho para el SRI

Usa el mismo motor de AZUR: comprobantes firmados y autorizados por el SRI, con todas las validaciones de Ecuador.

Herramientas

21 herramientas listas para tu asistente

Salen directamente de la API de AZUR: cuando agregamos una, tu asistente la ve sola.

buscar_clientes

Busca clientes por texto. Sirve el nombre, la identificación o el correo: por ejemplo «Ferretería El Tornillo».

buscar_productos

Busca productos por texto. Sirve el nombre, la identificación, el código o la marca: por ejemplo «tornillos».

stock_producto

Cuántas unidades hay de un producto.

buscar_proveedores

Busca proveedores por texto. Sirve el nombre, la identificación: por ejemplo «Distribuidora del Pacífico».

contexto

Devuelve la empresa, el establecimiento, el punto de emisión y el ambiente de la credencial, más su régimen tributario y sus decimales.

plan

Cuántos comprobantes quedan.

resumen_ventas

Cuánto se ha facturado en un período, con el desglose por día y la comparación con el período anterior. Por defecto, el mes en curso.

guardar_factura

Crea un Factura en AZUR.

guardar_notaventa

Crea un Nota de venta en AZUR.

guardar_proforma

Crea un Proforma en AZUR.

ver_factura

Devuelve un Factura con sus líneas y formas de pago. Use el id que devolvió al guardarlo.

listar_factura

Lista los documentos de este tipo, del más reciente al más antiguo. Filtre por fechas o busque por número.

listar_comprobantes

Todos los comprobantes electrónicos juntos, del más reciente al más antiguo, con el tipo indicado en cada fila.

pdf_factura

Devuelve el PDF (RIDE) del documento. Solo existe una vez enviado al SRI: un borrador todavía no tiene clave de acceso.

existencias

Qué hay y dónde está.

bodegas

Las bodegas activas sobre las que se puede mover mercadería. Hace falta el id de una para cualquier movimiento.

kardex

Todo lo que entró y salió de un producto, en orden cronológico ascendente, con el saldo después de cada movimiento.

crear_cliente

Da de alta un cliente nuevo.

cuentas_contables

El plan de cuentas de la empresa.

centros_costo

Los centros de costo configurados.

listar_asientos

Los asientos de un período, del más reciente al más antiguo.

Integración en 3 pasos

Conéctalo en un minuto

1

Crea tu credencial

En AZUR, con la cuenta del dueño: menú de usuario → Credenciales API. Elige el punto de emisión y los permisos (para un asistente: consultar comprobantes, crear borradores y ver clientes y productos).

2

Pégala en tu asistente

Agrega el servidor https://azur.com.ec/mcp con la cabecera Authorization: Bearer y tu credencial. Abajo tienes la configuración de cada cliente.

3

Háblale

Pídele lo que necesites en lenguaje natural. Si algo no está claro, te preguntará antes de actuar.

Claude Code terminal
claude mcp add --transport http azur https://azur.com.ec/mcp \
  --header "Authorization: Bearer azur_live_…"
Cursor · VS Code · Windsurf mcp.json
{
    "mcpServers": {
        "azur": {
            "url": "https://azur.com.ec/mcp",
            "headers": {
                "Authorization": "Bearer azur_live_…"
            }
        }
    }
}
Claude Desktop (local, stdio) claude_desktop_config.json
{
    "mcpServers": {
        "azur": {
            "command": "npx",
            "args": [
                "-y",
                "@azur.com.ec/mcp"
            ],
            "env": {
                "AZUR_API_KEY": "azur_live_…"
            }
        }
    }
}
API de Anthropic (Python) python
client.beta.messages.create(
  model="claude-…",
  mcp_servers=[{
    "type": "url",
    "url": "https://azur.com.ec/mcp",
    "name": "azur",
    "authorization_token": "azur_live_…"
  }],
  messages=[{"role": "user", "content": "¿Cuánto le facturé a Ferretería El Tornillo este mes?"}],
  betas=["mcp-client-2025-04-04"],
)

¿Usas n8n? Tenemos nodos para n8n y SDK oficiales para PHP y JavaScript.

Ejemplos

Cosas que puedes pedirle

«Prepara una factura para Ferretería El Tornillo: 3 cajas de tornillos de 1/2" y 1 taladro, pago con transferencia.»

«¿Cuántas unidades de PR-001 me quedan en la bodega principal?»

«¿Cuánto vendí esta semana comparado con la anterior?»

«Registra como cliente a Juan Pérez, cédula 1712345678, correo juan@ejemplo.com.»

«Busca la factura 001-001-000000123 y dime si ya la autorizó el SRI; si sí, dame el PDF.»

«¿Cuántos comprobantes me quedan en el plan?»

Seguridad

La IA trabaja, tú tienes el control

Tu credencial, tus permisos

El asistente usa una credencial azur_live_ o azur_test_ que tú creas y revocas cuando quieras, con permisos por área (solo consultar, crear borradores, inventario…), IP autorizadas y fecha de vencimiento.

El envío al SRI lo decides tú

Por defecto el asistente prepara los comprobantes como borrador y una persona los revisa y envía desde AZUR. El envío directo solo existe si lo activas a propósito.

Pruebas sin riesgo

Con una credencial azur_test_ todo queda en el ambiente de pruebas del SRI: ideal para probar flujos antes de pasar a producción.

Tu firma no sale de AZUR

El certificado de firma electrónica se queda resguardado en AZUR. El asistente nunca lo ve ni lo necesita.

Sin duplicados

Si el asistente repite una orden por un corte de red, AZUR lo detecta y devuelve lo mismo en vez de crear dos facturas.

Pregunta antes de adivinar

Si hay dos clientes o productos parecidos, AZUR le avisa al asistente que debe preguntarte cuál es antes de facturar.

Preguntas frecuentes

Sobre el servidor MCP

Pon a tu asistente a facturar

Crea tu cuenta, genera una credencial de pruebas y conéctala en un minuto.