DAVOJ Connect · MCP

Conecta DAVOJ con tu asistente AI

DAVOJ ERP expone un servidor MCP (Model Context Protocol), un estándar abierto que permite a cualquier asistente AI compatible —Claude, ChatGPT, Gemini o Copilot— consultar y operar los datos de tu negocio de forma segura usando tu API Key.

1. Obtén tu API Key

En DAVOJ entra a Configuración → API Keys y crea una key. Cópiala (se muestra una sola vez). Para acceso de solo lectura, cualquier key sirve; para permitir que el asistente cree ventas, la key necesita el scope mcp:write.

Empieza con el Sandbox — prueba sin riesgo. Marca la casilla Sandbox al crear la key (prefijo sb_) para desarrollar tu integración sin tocar la DGII: genera e-CF y NCF simulados (E31SANDBOX000001), no consume secuencias reales y no afecta tus estadísticas. Usa los mismos endpoints y validaciones que producción. Cuando estés listo, cambia a una key de producción (prefijo sv_) sin tocar tu código.

2. Configura tu cliente MCP

En Claude Desktop (Configuración → Developer → Edit Config) agrega el servidor con la URL y tu API Key en el header:

{
  "mcpServers": {
    "davoj-erp": {
      "url": "https://app.davoj.com/mcp/v1/sse",
      "headers": {
        "X-API-Key": "tu_api_key_aqui"
      }
    }
  }
}

URL del servidor: https://app.davoj.com/mcp/v1/sse. Reinicia el cliente y verás las herramientas de DAVOJ disponibles. Otros clientes MCP usan la misma URL y el header X-API-Key.

Seguridad. Cada API Key solo accede a los datos de su propio negocio (aislamiento estricto). El acceso es de solo lectura por defecto; crear ventas requiere el scope mcp:write. Nunca se exponen contraseñas, certificados ni credenciales. Cada llamada queda auditada y hay límite de 60 solicitudes por minuto. Puedes desactivar una key al instante desde el panel (kill switch).

3. Herramientas disponibles

Ventas

consultar_ventas	Buscar ventas por fecha, cliente, monto o NCF
detalle_venta	Detalle completo de una venta
resumen_ventas	Resumen por período (hoy, semana, mes)
crear_venta	Crear una venta (requiere permiso de escritura)

Inventario

consultar_productos	Buscar productos por nombre, SKU o categoría
verificar_stock	Stock actual de un producto
productos_bajo_reorden	Productos por debajo del punto de reorden
productos_mas_vendidos	Top de productos por volumen o monto

Clientes

consultar_clientes	Buscar clientes por nombre o RNC
balance_cliente	Cuentas por cobrar de un cliente
historial_cliente	Compras de un cliente en un período

Facturación electrónica

estado_ecf	Estado de un e-CF
ecf_pendientes	e-CF pendientes de envío
estadisticas_ecf	Contadores de e-CF por estado

Contabilidad

balance_general	Balance general a una fecha
estado_resultados	Estado de resultados por período
cuentas_por_cobrar	Resumen de CxC
cuentas_por_pagar	Resumen de CxP
flujo_caja	Flujo de efectivo por período

Reportes

ganancia_por_producto	Rentabilidad por producto
ventas_por_vendedor	Ventas por vendedor
ventas_por_categoria	Ventas por categoría

Órdenes de servicio

consultar_ordenes	Buscar órdenes de servicio
ordenes_pendientes	Órdenes en RECIBIDO o EN_REPARACION

4. Recursos (datos)

davoj://negocio/info	Datos del negocio
davoj://negocio/config	Configuración fiscal y de facturación
davoj://productos/catalogo	Catálogo de productos
davoj://clientes/lista	Lista de clientes
davoj://ventas/recientes	Últimas 50 ventas
davoj://ecf/estado	Estado de facturación electrónica
davoj://contabilidad/resumen	Resumen contable del mes

Ejemplos de lo que puedes preguntar a tu asistente: «¿Cuánto vendí este mes?», «¿Qué productos están bajo el punto de reorden?», «Dame el balance de cuentas por cobrar», «¿Cuántos e-CF tengo pendientes?», «Muéstrame las órdenes de servicio en reparación».