# Atlas MCP — contexto operativo para asistentes

Atlas es la aplicación económica y administrativa de Mikodawa Suite. Sus tools MCP permiten trabajar con clientes, proveedores, artículos, documentos, líneas, cobros, pagos e informes.

## Scopes

- `atlas.read`: consultas comerciales, documentos, recibos e informes.
- `atlas.write`: clientes, proveedores, artículos, borradores y líneas.
- `atlas.issue`: emisión definitiva de documentos.
- `atlas.payments`: registro de cobros o pagos.

`atlas.write` no implica `atlas.issue` ni `atlas.payments`.

## Entidades principales

- Party: tercero que puede asumir rol de cliente, proveedor o ambos.
- Item: producto, servicio o kit con precio, coste, impuesto, unidad y comportamiento de stock.
- Document: presupuesto, pedido, albarán, factura, factura de compra o abono.
- Document line: concepto de catálogo o manual dentro de un borrador.
- Receipt: vencimiento de cobro o pago asociado a un documento.
- Payment: movimiento que liquida total o parcialmente un recibo.

## Familias de tools

### Terceros

`atlas_list_customers`, `atlas_search_customers`, `atlas_get_customer`, `atlas_create_customer`, `atlas_update_customer`, `atlas_list_suppliers`, `atlas_search_suppliers`, `atlas_get_supplier`, `atlas_create_supplier`, `atlas_update_supplier`, `atlas_get_customer_overview`.

### Artículos

`atlas_list_items`, `atlas_search_items`, `atlas_get_item`, `atlas_create_item`, `atlas_update_item`.

### Documentos y líneas

`atlas_list_documents`, `atlas_search_documents`, `atlas_get_document`, `atlas_create_document`, `atlas_update_document`, `atlas_duplicate_document`, `atlas_create_quote`, `atlas_create_sales_order`, `atlas_create_delivery_note`, `atlas_create_invoice`, `atlas_add_document_line`, `atlas_update_document_line`, `atlas_remove_document_line`, `atlas_reorder_document_lines`, `atlas_convert_document`, `atlas_create_invoice_from_document`, `atlas_issue_document`.

### Compras y Sense

`atlas_upload_purchase_invoice_pdf`, `atlas_reprocess_purchase_invoice_with_sense`, `atlas_get_purchase_invoice_sense_job`.

### Tesorería

`atlas_list_pending_receivables`, `atlas_list_overdue_receivables`, `atlas_get_customer_financial_summary`, `atlas_get_customer_receivables`, `atlas_list_receipts`, `atlas_get_receipt`, `atlas_register_payment`.

### Informes

`atlas_get_sales_report`, `atlas_get_purchases_report`, `atlas_get_financial_summary`, `atlas_get_top_customers_report`, `atlas_get_outstanding_report`.

## Patrones obligatorios

### Crear un presupuesto

1. Buscar el cliente.
2. Si hay varias coincidencias, pedir selección.
3. Buscar los artículos o preparar líneas manuales.
4. Crear el presupuesto como borrador.
5. Añadir líneas y devolver número provisional, cliente y total.
6. No emitir salvo petición separada y confirmada.

### Emitir un documento

1. Leer el documento por ID inmediatamente antes de emitir.
2. Mostrar empresa, cliente/proveedor, tipo, líneas, impuestos y total.
3. Solicitar confirmación confiable.
4. Invocar `atlas_issue_document` una vez con idempotencia.

### Registrar un cobro o pago

1. Resolver el recibo exacto.
2. Leer saldo pendiente y movimientos existentes.
3. Mostrar importe, fecha, dirección y cuenta financiera.
4. Solicitar confirmación confiable.
5. Invocar `atlas_register_payment`.

### Procesar una factura de compra con Sense

1. Resolver una factura de compra en borrador.
2. Adjuntar un PDF real de hasta 20 MB mediante URL HTTPS admitida o base64.
3. Invocar una sola vez el reprocesado con Sense.
4. Consultar el UUID del trabajo hasta `completed` o `failed`; no reiniciar para consultar progreso.
5. Revisar proveedor, referencia, fechas, líneas, impuestos y totales.

## Límites

- No hay borrado físico ni anulación fiscal MCP v1.
- Crear una factura no equivale a emitirla.
- Las tools no exponen binarios, secretos ni enlaces internos de almacenamiento.
- La administración de inventario, fiscalidad, TPV, restaurante, equipo y Radar no está expuesta como tools Atlas v1.
- La creación masiva conversacional de artículos está disponible dentro del Asistente Sense de Atlas; MCP Atlas ofrece altas individuales estructuradas.

## Composición

Atlas puede combinarse con Forge para clientes y contexto de proyectos, con Flow para automatizaciones, con Vault para firma y con Bridge para comunicaciones. Cada aplicación necesita sus propios scopes.