# MCP Dolibarr

> Servidor MCP remoto (Streamable HTTP, OAuth 2.1 con PKCE) que permite a una IA gestionar instancias de Dolibarr ERP/CRM por su API REST. Cada usuario enlaza la URL y la API key de su Dolibarr en un panel; la IA nunca ve ni pide la key. Por defecto todo es de solo lectura.

- Servidor MCP: https://mcp-dolibarr.ecortes.cl/mcp
- Panel: https://mcp-dolibarr.ecortes.cl/panel
- Documentación completa para IA: https://mcp-dolibarr.ecortes.cl/llms-full.txt

## Herramientas
- `dolibarr_listar_cuentas` (solo lectura): Lista las instancias de Dolibarr que enlazaste en el panel (etiqueta, URL, versión, permisos y estado).
- `dolibarr_listar_recursos` (solo lectura): Catálogo de recursos de Dolibarr con herramientas CRUD (terceros, productos, facturas, pedidos, presupuestos, proyectos, tickets…), sus alias en español y los campos que busca dolibarr_buscar.
- `dolibarr_estado` (solo lectura): Comprueba que la instancia responde y que su API key es válida (GET /status); devuelve la versión de Dolibarr.
- `dolibarr_listar` (solo lectura): Lista registros de un recurso (paginado).
- `dolibarr_buscar` (solo lectura): Busca por texto en un recurso (terceros por nombre/email, productos por ref/etiqueta, facturas por ref, contactos por nombre, etc.).
- `dolibarr_obtener` (solo lectura): Detalle completo de un registro por id (GET /{recurso}/{id}).
- `dolibarr_crear`: Crea un registro (POST /{recurso}); devuelve el id nuevo.
- `dolibarr_actualizar`: Modifica un registro (PUT /{recurso}/{id}) con los campos indicados.
- `dolibarr_eliminar`: Elimina un registro (DELETE /{recurso}/{id}).
- `dolibarr_api`: Puerta general a la API REST de Dolibarr (todo lo que no cubren las tools CRUD): acciones, documentos, stock, configuración… Ejemplos: POST /invoices/{id}/validate, POST /invoices/{id}/payments, GET /setup/company, GET /stockmovements, POST /orders/{id}/validate.
- `dolibarr_crear_documento`: Crea un documento comercial COMPLETO en un solo paso: cabecera + todas las líneas (productos por ref, precio/IVA/descuento, sub-líneas).
- `dolibarr_agregar_lineas`: Agrega una o varias líneas (productos, servicios o texto libre, con sub-líneas opcionales) a un documento EN BORRADOR ya existente.
- `dolibarr_accion_documento`: Cambia el estado de un documento: validar, aprobar (orden de compra), hacer_pedido, cerrar, aceptar/rechazar cotización, pagada, volver a borrador, etc.
- `dolibarr_pdf` (solo lectura): Genera (o recupera) el PDF de una cotización, pedido, factura u orden de compra y devuelve un LINK DE DESCARGA temporal (15 min) que debes mostrarle al usuario tal cual.
- `dolibarr_enviar_correo`: Envía por correo (con el SMTP o Resend que el usuario configuró en el panel) una cotización, pedido, factura u orden de compra con su PDF adjunto, a los destinatarios que el usuario indique.