Usamos cookies técnicas propias, necesarias para que el sitio funcione. Solo si lo aceptas cargamos además cookies de medición publicitaria (Google Ads) para saber qué campañas traen clientes. Puedes rechazarlas y navegar igual. Política de privacidad.
Integración DeCA · MCP para agentes de IA
El MCP (Model Context Protocol) de DeCA permite que un agente de IA opere tu cuenta en lenguaje natural: consulta el cupo, da de alta clientes y direcciones, crea recogidas, emite DeCAs y diagnostica tus webhooks sin escribir código. Es la misma API REST, con las mismas validaciones, los mismos límites y el mismo cupo.
MCP incluido con el add-on API REST: 50 €/mes o 480 €/año · Incluido en el plan Enterprise
Ya usas Claude, Cursor o un asistente propio para preparar informes, consultar datos o redactar correos. El DeCA es de las pocas tareas que todavía te obligan a salir de la conversación y entrar en otra web a rellenar un formulario a mano.
Y el momento importa: desde el 5 de octubre de 2026 el DeCA debe ser exclusivamente digital (Ley 9/2025, Disposición Transitoria 8ª), emitirlo es responsabilidad del cargador (art. 7.2 de la Orden FOM/2861/2012) y cada transporte sin documento va de 401 a 600 € (LOTT, art. 141.17 y 143.1.d).
El MCP cierra ese hueco: el agente deja de ser un asistente que te dicta los datos y pasa a ser un operador que los ejecuta sobre tu cuenta, con la misma trazabilidad y el mismo registro de auditoría que si lo hubieras hecho tú desde la web.
1. Add-on API REST y clave
El MCP se apoya en el add-on API REST (50 €/mes o 480 €/año, incluido en Enterprise y contratable sobre cualquier plan base, incluido Free). La clave se genera en Mi Cuenta → pestaña API y se muestra una sola vez.
2. Conecta tu agente
Apunta tu cliente MCP a https://app.deca.cangopal.com/mcp con la cabecera X-API-Key. El interruptor MCP de la cuenta viene activo por defecto; el permiso de escritura se activa aparte, en Mi Cuenta → API y MCP.
3. Pídelo con tus palabras
«Da de alta al cliente Transportes Vega, crea la recogida de 800 kg y emite el DeCA.» El agente encadena consultar_cuenta, crear_cliente y crear_recogida_deca con emit; si falta un dato, el error nombra el campo exacto y el agente lo corrige y reintenta.
Cada herramienta ejecuta un endpoint de la API v1, con las mismas validaciones y el mismo cupo. La columna «Acceso» indica si solo lee o si además escribe: para lo segundo hay que activar el permiso mcp_write en la cuenta.
| Acceso | Herramienta | Para qué sirve |
|---|---|---|
| Lee | consultar_cuenta | Identidad del integrador, plan y cupo de DeCAs usado y restante. Es la primera que conviene llamar. |
| Lee | listar_recogidas | Las recogidas de la cuenta con su estado y su expediente asociado. |
| Lee | listar_expedientes | Listado de expedientes DeCA con su estado. |
| Lee | consultar_expediente | Detalle completo: partes, partidas y documentos. |
| Lee | consultar_estado_expediente | Estado ligero del documento, para sondear mientras se genera el PDF. |
| Lee | descargar_pdf_deca | El PDF del DeCA, provisional o final. |
| Lee | obtener_qr_expediente | Solo la imagen del QR (PNG, SVG o PDF), el mismo dibujo que el papel. |
| Lee | consultar_modificaciones | Historial de modificaciones impresas de un DeCA. |
| Lee | buscar_articulo | Búsqueda rápida en el catálogo. |
| Lee | listar_catalogo | Catálogo de artículos con su clasificación ADR/LER. |
| Escribe | crear_recogida_deca | El comando principal: recogida, expediente y emisión (emit:true) en una sola llamada. |
| Escribe | completar_expediente | Completa el borrador antes de emitir (camino paso a paso). |
| Escribe | emitir_expediente | Emite el DeCA; el cupo se consume aquí. |
| Escribe | cambiar_matriculas | Corrige matrículas de un DeCA cerrado: mismo QR, pdf_version +1. |
| Escribe | editar_recogida | Replanifica la fecha prevista o el origen de una recogida. |
| Escribe | cancelar_expediente, cancelar_recogida | Cancela el expediente, o la recogida completa con su expediente en cascada. |
| Lee | listar_clientes | Clientes de recogida de la cuenta, con contrato y dirección principal. |
| Lee | listar_direcciones | Libreta de direcciones clasificada por uso (origen o destino). |
| Lee | listar_vehiculos | Flota: matrículas y datos ADR. |
| Escribe | crear_cliente, editar_cliente | Altas y ediciones de clientes de recogida. |
| Escribe | crear_direccion, editar_direccion | Altas y ediciones de la libreta de direcciones. |
| Escribe | crear_vehiculo, editar_vehiculo | Altas y ediciones de la flota. |
| Escribe | crear_articulo, editar_articulo | Catálogo con clasificación ADR/LER; crear_articulo exige el add-on Soporte ADR. |
| Lee | listar_rutas, consultar_ruta | Rutas de entrega con su DeCA agrupado. |
| Escribe | crear_ruta, editar_ruta | Ruta con sus paradas; con emit:true emite el DeCA agrupado. |
| Escribe | cambiar_matriculas_ruta | Matrículas del DeCA agrupado en servicio (Método 1). |
| Lee | listar_webhooks | Tus endpoints de webhook y su salud (nunca incluye el secreto). |
| Lee | consultar_entregas_webhook | Entregas recientes: evento, estado, intentos, último error. |
| Escribe | reintentar_entrega_webhook | Reintento manual de una entrega fallida o colgada. |
La documentación completa para integradores: mcp.md (versión legible por máquinas, para que la lea tu agente; la guía completa con tu cuenta está en app.deca.cangopal.com/docs/mcp).
La conexión es una URL y una cabecera. El agente descubre las 36 herramientas solo con preguntar: la descripción de cada una es el contrato que lee para decidir cuándo usarla, y se mantiene al día con cada cambio de la API.
# pi (CLI) — añade el servidor MCP de DeCA
pi mcp add deca --url https://app.deca.cangopal.com/mcp
# ~/.pi/agent/mcp.json — la autenticación viaja en la cabecera
{
"mcpServers": {
"deca": {
"url": "https://app.deca.cangopal.com/mcp",
"headers": { "X-API-Key": "deca_TU_CLAVE" }
}
}
}
# Cualquier cliente que admita cabeceras propias: Claude o Claude Code,
# Cursor, VS Code, Codex o Copilot Studio. Paso a paso de cada uno:
# /integraciones/mcp/claude, /cursor, /vscode, /codex, /copilot-studio.
# (ChatGPT aún no: su MCP autentica con OAuth y este servidor no lo usa.)Alta completa en una conversación
«Consulta mi cupo, da de alta un cliente nuevo con su dirección y crea la recogida de 800 kg de chatarra; emite el DeCA y dime si falta algo.» El agente encadena consultar_cuenta, crear_cliente y crear_recogida_deca con emit en una sola tanda.
Ruta multiparada con un solo cupo
«Crea la ruta del martes para el transportista B44556677 con tres paradas: 300 kg a Mora, 500 kg a Sonseca y 200 kg a Orgaz; emite el DeCA agrupado.» Una ruta de tres paradas consume un único DeCA y genera un único QR.
Corregir matrículas tras el cierre
«El camión cambió a última hora: el DeCA cerrado va con 1234ABC y el nuevo tractor es 5678DEF.» El agente usa cambiar_matriculas con un motivo del catálogo; se regenera el PDF con el mismo QR y la versión anterior se conserva en auditoría.
Diagnóstico de una integración muda
«Mi ERP dice que no le llegan los webhooks. Mira mis endpoints, las últimas entregas y reintenta la que esté colgada.» El agente consulta listar_webhooks y consultar_entregas_webhook y reintenta sin que entres en la app.
Solo el QR para tu propia plantilla
«Dame el QR del último DeCA emitido, en PNG.» El agente obtiene el token del documento y devuelve la imagen real (módulo 6 px, margen 4), la misma que imprime el papel, lista para incrustar en tu documento.
Partidas ADR con add-on
«Añade al catálogo Disolvente clorado con ONU 1992, clase 3 y grupo II, y emite una recogida de 10 bultos de 25 kg.» Requiere el add-on de Soporte ADR: el agente crea el artículo con su clasificación y la partida de la recogida.
La API se contrata como add-on API REST: 50 €/mes (o 480 €/año con el descuento anual) sobre cualquier plan base, incluido Free. En el plan Enterprise va incluida. Los DeCAs emitidos por API comparten el límite mensual de tu plan con los creados desde la web.
No. El MCP usa tu misma cuenta y la misma clave X-API-Key de la API REST: el mismo cupo, la misma auditoría y la misma idempotencia. No hay que dar de alta nada adicional.
Tres cosas: una clave de API, el add-on API REST vigente —estar en Enterprise no basta por sí solo— y el interruptor MCP de la cuenta, que viene activo por defecto y se puede apagar sin revocar la clave. Para que el agente escriba hay que activar además el permiso mcp_write.
Solo si le das el permiso de escritura. Sin mcp_write el agente puede leerlo todo —cuenta, expedientes, recogidas, rutas, catálogo, webhooks, PDF y QR— pero cualquier escritura devuelve un error con las instrucciones para activarlo. Con el permiso puede crear y editar maestros, emitir y cancelar expedientes y reintentar entregas de webhook.
Sí: web, API y agente comparten el mismo contador mensual y el cupo se consume al emitir, no al crear el borrador. Una ruta multiparada consume una sola unidad, no una por parada.
Puede consultarlos y reintentar entregas fallidas, pero crear, rotar o borrar un webhook se hace desde la app o la API REST: el secreto se muestra una sola vez y no debe viajar por una conversación con un agente.
Cualquier cliente MCP que use transporte HTTP: pi, Claude Desktop, Cursor, copilotos de ERP o un agente propio. La conexión es una URL y una cabecera; no hay SDK que instalar.
En la aplicación, en app.deca.cangopal.com/docs/mcp, junto a la referencia de la API REST. Se abre con tu cuenta, la misma con la que opera el agente.
No todos los clientes valen igual: el servidor de DeCA se autentica con una cabecera fija
(X-API-Key) y no usa OAuth, así que solo funcionan los que permiten
enviar cabeceras propias. Estas son las guías, con los pasos verificados contra la documentación
oficial de cada fabricante:
Claude
ListoLa app de Claude, con conector personalizado
Claude Code
ListoLa CLI de Anthropic, en un comando
Cursor
ListoEl editor con agente, en dos líneas de JSON
Visual Studio Code
ListoGitHub Copilot en modo agente
Codex
ListoLa CLI de OpenAI, con cabeceras estáticas
Microsoft Copilot Studio
ListoAgentes de empresa, con API key en cabecera
ChatGPT
Aún noTodavía no: su MCP autentica con OAuth
SAP
Si gestionas las expediciones en SAP, los datos que el DeCA exige —cargador, mercancía, or…
Odoo
Odoo ya gestiona tus ventas, tu inventario y tus albaranes de entrega. La integración con …
Microsoft Dynamics 365 Business Central
En Business Central la expedición ya existe como documento: pedido de venta, envío y trans…
Sage
Los ERP de Sage llevan décadas gestionando la facturación y la logística de las pymes espa…
API REST
DeCA funciona como motor de documentos: tu sistema (ERP, TMS, WMS, portal de cliente o inc…
Crea tu cuenta, contrata el add-on API y empieza a emitir. Si prefieres que desarrollemos la integración por ti, cuéntanos qué ERP usas.