Quartup Cortex
Documentación técnica Claves Cortex Volver a Quartup Cortex
Agent-native

El ERP se diseña para agentes/
no se les conecta después.

Casi todo lo que hoy se llama «IA en el ERP» es una capa encima: un chat que consulta una copia de los datos y devuelve texto. Cortex invierte el orden. El ERP expone lo que sabe hacer como herramientas, y el agente razona sobre ellas y ejecuta. Cinco decisiones de diseño explican la diferencia.

01 · El cambio de paradigmaDe un ERP que informa a un ERP donde se actúa/

Hasta ahora el ERP guardaba el dato y una persona hacía el resto: lo consultaba, lo interpretaba, decidía y volvía a teclear. Con Cortex, la decisión y la acción pueden ocurrir dentro del propio sistema, y a la persona le queda el papel que solo ella puede hacer: encargar, validar y decidir hasta dónde.

Hasta ahora
ERP→Datos→BI→Persona decide→Persona ejecuta
Después
ERP→API→Aplicación externa→Persona
Con Cortex
ERP→Herramientas MCP→Agente→Decisión→Acción en el ERP

El ERP puede convertirse en el sistema operativo/ de la empresa agéntica.

  • No hay que importar el stock cada día
  • No hay que mantener una copia de los clientes
  • No hay que sincronizar pedidos
  • El agente consulta el sistema de verdad cuando lo necesita y actúa sobre él

02 · La arquitecturaCinco capas, con el protocolo MCP en el centro/

Una instrucción en lenguaje natural atraviesa cinco capas antes de convertirse en una transacción grabada. MCP es la tercera, y el sitio no es casual: es la única que no existía en el ERP de antes, y la que convierte todo lo demás en algo que un agente puede usar. Las personas son la capa de arriba —encargan, validan y deciden— y la base de conocimiento de la empresa acompaña a todas ellas.

  1. PersonasEncargan, validan y decidenUsuarios
  2. CortexOrquestación y agentesAgentes
  3. MCPHerramientas y contextoProtocolo
  4. OpenAPI / RESTAPI de QuartupContrato
  5. Quartup ERPDato real y permisosVerdad
Base de conocimiento
  • Personas — Quien encarga el trabajo, valida lo que hace falta validar y decide hasta dónde llega cada agente.
  • Cortex — Los agentes por área, su radio de acción y la conversación con las personas. Es quien razona y decide qué herramienta usar.
  • MCP — El protocolo estándar por el que un agente descubre y usa lo que el ERP sabe hacer. Es la pieza más estratégica: permite pensar en el ERP como un conjunto de herramientas que usa un agente, y no solo como una aplicación que usa una persona. Conecta tanto los agentes de Cortex como sistemas externos.
  • OpenAPI / REST — La interfaz pública del ERP, descrita de forma estructurada, con autenticación, validación y límites. Ninguna vía paralela.
  • Quartup ERP — El núcleo ejecuta: mismas transacciones, mismos permisos y misma auditoría que usa tu equipo. Una sola lógica de negocio.

Ejemplos conceptuales de lo que la capa MCP pone a mano. Cada herramienta es una operación estructurada del ERP, con sus permisos, y está declarada como lectura o como escritura.

buscar_cliente()Lee consultar_riesgo_cliente()Lee consultar_stock()Lee consultar_pedido()Lee consultar_facturas()Lee consultar_vencimientos()Lee crear_pedido()Escribe crear_orden_compra()Escribe registrar_cobro()Escribe
Sin SQL

El modelo no accede a la base de datos ni escribe SQL. Razona y usa las herramientas que el ERP expone —consultar_stock(), crear_pedido(), registrar_cobro()—, separadas entre las que leen y las que escriben. Así se aplican los permisos, se validan los datos y todo queda auditado.

03 · Autonomía graduadaCuatro niveles. La empresa decide hasta dónde/

Aquí está la diferencia entre la IA generativa como asistente y la automatización operativa con agentes. Subir de nivel es una decisión, no un efecto secundario.

A0

Sugiere

Analiza y propone. No toca nada.

Decide y ejecuta: la persona
A1

Prepara

Deja la operación lista para que una persona la revise y la lance.

Valida y lanza: la persona
A2

Ejecuta con condiciones

Ejecuta determinadas acciones dentro de política. Lo que queda fuera pasa a una persona.

Ejecuta: el agente, con límites
A3

Ejecuta y notifica

Hace el trabajo y avisa de lo que ha hecho.

Ejecuta: el agente; supervisa la persona
Regla Permisos heredados

El agente nunca puede hacer más de lo que puede hacer el usuario al que sirve.

Regla Todo auditado

Lecturas y escrituras quedan registradas.

Regla El piloto empieza abajo

Un piloto arranca como máximo en A1.

Regla Subidas documentadas

Pasar de un nivel a otro es una decisión explícita del cliente.

04 · Estándar y abiertoMCP y OpenAPI, no un formato propio

OpenAPI describe de forma estructurada lo que sabe hacer el ERP; MCP es el protocolo estándar para que un agente descubra y use esas capacidades. Los dos son estándares públicos, no un formato propio.

Sin ecosistema cerrado

La misma capa MCP que usan los agentes de Cortex está abierta a sistemas externos: un agente de Claude, de ChatGPT o desarrollado por el propio cliente puede trabajar sobre las capacidades del ERP, y Quartup puede combinarse con otras aplicaciones dentro de un mismo proceso. Cortex no es un ecosistema cerrado, y esa es también la respuesta al riesgo de dependencia: lo que se construye sobre la capa MCP no queda atrapado en ella.

05 · GobernanzaQuién responde cuando un agente se equivoca

Son las preguntas que deciden la compra, y las mismas que conviene hacerle a cualquier plataforma agéntica. Aquí están respondidas una a una, incluida la que todavía no está resuelta.

Lo que pregunta un comité de compras antes de firmar
CuestiónEstadoCómo lo resuelve Cortex
Permisos En producción El agente nunca puede hacer más de lo que puede hacer el usuario al que sirve. Hereda su rol, sus almacenes, sus series y sus límites de importe.
Acceso al dato En producción Siempre por la capa MCP y con los permisos del usuario, nunca directo a la base de datos. No hay una réplica que pueda quedar desfasada ni un segundo juego de credenciales que mantener.
Lectura frente a escritura En producción Las herramientas están separadas y declaradas: las que consultan y las que graban. Qué puede escribir cada agente se configura agente a agente, y un agente puede quedarse en solo lectura indefinidamente.
Transacciones y rollback En producción Cada escritura es una operación transaccional del ERP, no una secuencia de llamadas sueltas: o se graba entera o no se graba. Un proceso multiagente interrumpido no deja documentos a medio escribir.
Trazabilidad En producción Cada lectura y cada escritura quedan registradas, con el agente, el usuario al que servía y la herramienta usada. Es la misma auditoría del ERP, no un registro aparte.
Aprobación humana En producción El nivel de autonomía A0–A3 de cada agente decide qué hace solo, qué deja preparado y qué no puede tocar nunca.
Auditoría del razonamiento Hoja de ruta Hoy queda registrada la acción: qué herramienta se llamó, con qué datos y qué devolvió. El registro del razonamiento que lleva a esa acción, separado de la acción misma, está en desarrollo.
Residencia y certificación En producción Centros de datos en la Unión Europea, distribuidos en varios países, y certificación ISO 27001 vigente.
Arquitectura · por qué esto sí funciona

MCP desde los cimientos.
Sin capas superficiales/
una única fuente de verdad.

Cuando un agente decide algo, no pasa por un software intermedio ni por una copia de tus datos: habla con el mismo núcleo que usa tu equipo, con sus permisos y su auditoría. Cuatro capas, una sola cadena.

Capa 01

Agentes IA

Los agentes de Cortex y, si quieres, los tuyos o los de un tercero. Reciben una intención en lenguaje natural: «reabastece lo que baja de 14 días de cobertura».

Cortex · Claude · GPT · propios
Capa 02

Capa MCP

Traduce esa intención en operaciones concretas y las expone como herramientas descubribles. Es lo que permite conectar sistemas agénticos propios o externos.

MCP · herramientas · recursos
Capa 03

API REST

Toda operación pasa por la API de última generación de Quartup, estándar OpenAPI, con autenticación, límites de uso y validación. Ninguna vía paralela.

OpenAPI · JSON · OAuth 2.1
Capa 04

Quartup Core

Tu ERP de siempre ejecuta: inventario, facturación, CRM, contabilidad. Mismas transacciones, mismos permisos, misma auditoría. Sin lógica duplicada.

RBAC · auditoría · ACID
01

Cualquier IA se conecta.

Claude, GPT, LangGraph o tu propio agente. Si habla MCP, funciona — sin desarrollos a medida ni proyectos de integración.

02

Con los permisos de tu equipo.

Cada acción de un agente respeta roles y límites, y queda auditada. Nada se ejecuta por fuera del sistema.

03

Una sola lógica de negocio.

Los agentes usan las mismas transacciones que tu equipo — la fiabilidad de un kernel con 25 años en producción. Nada se duplica.

04

Tus datos, en la UE.

Centros de datos distribuidos en varios países de la Unión Europea, cifrado en reposo y en tránsito, backup continuo. RGPD de serie.

Arquitectura · de la intención a la transacción MCP nativo
01 Capa de agentes

El agente recibe una intención.

«Reabastece los SKUs con menos de 14 días de cobertura.» Cualquier consumidor MCP-compatible se integra sin modificaciones.

ClaudeGPTLangGraphSDK Cortex
02 Cortex MCP Server

Cortex la traduce a operaciones.

312 herramientas, 180+ recursos y 48 prompts listos. La intención de negocio se convierte en llamadas concretas — sin colas ni middleware.

MCP 1.0JSON-RPC 2.0SSE · WS
03 Kernel Quartup

Tu ERP de siempre ejecuta.

La lógica de negocio de 25 años: inventario, facturación, CRM, contabilidad. Mismas transacciones, mismos permisos, misma auditoría.

RBACEvent-sourcedACID
04 Infraestructura

Y todo vive en la UE.

Centros de datos distribuidos en varios países de la UE, aislamiento por tenant y backup continuo con RPO < 5 min.

Multi-región UEAES-256TLS 1.3
De la frase a la acción

Cómo un prompt se convierte en trabajo hecho

Una sola frase del usuario. Cuatro pasos de Cortex contra la operación real. Ningún dato tecleado por nadie.

Tú escribes

›Reabastece lo que baje de 14 días de cobertura

Cortex
  1. Paso 01

    Identifica

    Cruza el umbral que le has dado con la rotación real de cada referencia.

    GET /v3/articulos/cobertura
        ?dias=14
    →23 referencias por debajo
  2. Paso 02

    Enriquece · MCP

    Pide de cada una su proveedor habitual, plazo de entrega y condiciones pactadas.

    GET /v3/articulos/590
        /reposicion
    →plazo 5 días · precio de contrato · pedido mínimo 300 €
  3. Paso 03

    Razona

    Agrupa por proveedor para superar el mínimo de pedido y ajusta cantidades al plazo real.

    23 referencias
    → 4 proveedores
    →4 pedidos en vez de 23
  4. Paso 04

    Ejecuta

    Crea las órdenes de compra y las deja esperando tu aprobación.

    POST /v3/pedidos-compra →4 órdenes en borrador
Resultado

Cuatro órdenes de compra listas para aprobar

  • Agrupadas por proveedor, cada una por encima de su pedido mínimo.
  • Con el precio pactado en contrato, no con la tarifa de catálogo.
  • Con la cantidad ajustada al plazo de entrega real de cada proveedor.

Nadie miró la rotación, ni abrió veintitrés fichas de artículo, ni comparó condiciones proveedor por proveedor.

Diseño AI-First de la API v3

Cuatro decisiones de diseño que hacen posible lo anterior

Una API pensada para que la lea una persona obliga al modelo a reconstruir el contexto a base de llamadas. La v3 está diseñada para que llegue ya resuelto.

01

Contexto rico

Vistas 360º agregadas —cliente, facturas y riesgo— en una sola llamada. Se acabó el problema de las «N+1 queries».

Antes · 3 llamadas GET /clientes/590
GET /facturas?cliente=590
GET /riesgo/590
→
Ahora · 1 llamada GET /clientes/590
    /ficha_completa
02

Des-normalización semántica

El servidor devuelve el significado, no el código interno. La IA no necesita diccionarios ni tablas maestras para entender una respuesta.

Dato crudo "estado_id": 5
→
Dato con sentido "estado": "Pendiente"
03

Payload híbrido

Cada objeto viaja dos veces: el identificador que la herramienta necesita para ejecutar, y la descripción que el modelo necesita para razonar.

Para ejecutar "cliente_id": 590
+
Para razonar "cliente": "Tech Solutions · riesgo ALTO"
04

Pre-computación

Riesgo, previsiones y cálculos complejos se resuelven en el backend. Al agente le llegan conclusiones, no montañas de registros que interpretar.

Lo que habría que leer 3 facturas + 18 meses de histórico de pagos
→
Lo que llega "riesgo_credito": "ALTO"
Siguiente paso

Si quieres revisar la especificación OpenAPI o las herramientas que expone la capa MCP sobre tu propia parametrización, lo vemos en una sesión técnica. Escríbenos a [email protected] y lo montamos con tu equipo de sistemas.