Generar el DeCA desde tu agente de IA: el MCP de DeCA

Cada vez más equipos de expediciones trabajan con un agente de IA al lado: le piden que resuma un albarán, que consulte un stock, que prepare un correo. Y casi todos se topan con la misma frontera: el agente sabe hacer el trabajo, pero no puede tocar el documento. El DeCA era, hasta ahora, la última tarea que obligaba a salir de la conversación y entrar en otra web a rellenar un formulario.

DeCA ya tiene servidor MCP, y esa frontera desaparece.

Qué es el MCP y por qué un agente puede emitir DeCAs

El MCP (Model Context Protocol) es el estándar con el que un agente de IA descubre y ejecuta herramientas de un sistema externo. En lugar de programar una integración a medida, el agente se conecta a un servidor MCP y recibe un catálogo: qué puede hacer, con qué argumentos y qué devuelve cada cosa.

El MCP de DeCA expone 36 herramientas que operan tu cuenta: consultar el cupo, dar de alta clientes y direcciones, crear recogidas, emitir y cancelar expedientes, gestionar rutas multiparada, descargar el PDF, obtener el QR y diagnosticar tus webhooks. Y no es una API paralela: cada herramienta ejecuta un endpoint de la API REST v1, con las mismas validaciones, los mismos límites y el mismo cupo.

Cómo se conecta un agente

La conexión es una URL y una cabecera:

# pi (CLI) — añade el servidor MCP de DeCA
pi mcp add deca --url https://app.deca.cangopal.com/mcp

{
  "mcpServers": {
    "deca": {
      "url": "https://app.deca.cangopal.com/mcp",
      "headers": { "X-API-Key": "deca_TU_CLAVE" }
    }
  }
}

El transporte es JSON-RPC sobre HTTP y la autenticación va en la cabecera X-API-Key, la misma clave de la API REST. Funciona con cualquier cliente MCP que hable HTTP: pi, Claude Desktop, Cursor, un copiloto de ERP o un agente propio. No hay SDK que instalar.

Las tres puertas (y una cuarta para escribir)

Para que un agente entre a tu cuenta se cumplen tres condiciones:

1. Clave de API, generada en Mi Cuenta → API y visible una sola vez.
2. Add-on API REST activo. Estar en el plan Enterprise no basta por sí solo: el MCP se apoya en el add-on (50 €/mes o 480 €/año; incluido en Enterprise y contratable sobre cualquier plan base, incluido Free).
3. Interruptor MCP de la cuenta, activo por defecto. Se puede apagar sin revocar la clave.

Y una cuarta, esta solo para escritura: el permiso mcp_write, que viene apagado por defecto. Sin él, 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. Es una decisión de diseño, y es la correcta: un agente no debería poder borrar nada el primer día que lo conectas.

Qué puede hacer el agente hoy

El comando principal es crear_recogida_deca: con emit: true crea la recogida, abre el expediente y emite el DeCA —con su QR y su PDF— en una sola llamada.

El flujo completo, en lenguaje natural

Así se ve una emisión de principio a fin, sin escribir código:

«Consulta mi cupo. Da de alta al cliente Transportes Vega SL, NIF B87654321, con dirección en Calle Industriales 12, Getafe. Crea una recogida de 800 kg de chatarra y emite el DeCA. Si falta algo, dime exactamente qué.»

El agente ejecuta consultar_cuenta → crear_cliente → crear_recogida_deca con emit: true. Si falta un dato, el error en español nombra el campo exacto y el agente lo corrige y reintenta con la misma source_reference — sin duplicar nada.

Otros tres casos que funcionan tal cual:

• Ruta multiparada: «Crea la ruta del martes con tres paradas —300 kg a Mora, 500 kg a Sonseca y 200 kg a Orgaz— y emite el DeCA agrupado.» Tres paradas, un solo DeCA y un solo cupo consumido.
• Corrección tras el cierre: «El camión cambió a última hora: el DeCA cerrado va con 1234ABC y el nuevo tractor es 5678DEF.» El agente corrige la matrícula con motivo, regenera el PDF y conserva la versión anterior en auditoría.
• Diagnóstico: «Mi ERP dice que no le llegan los avisos de DeCA. Mira mis webhooks y reintenta la entrega que esté fallando.»

Lo que el agente no puede hacer (y por qué es buena señal)

El MCP no expone todo, a propósito:

• No puede crear, rotar ni borrar webhooks. El secreto de firma se muestra una sola vez y no debe viajar por una conversación con un agente.
• No toca la libreta de transportistas ni la facturación ni el panel de administración.
• No importa catálogos desde Excel: la carga masiva es una pantalla web con vista previa.

Los límites del sistema también se heredan tal cual: el cupo del plan (se consume al emitir, consultar_cuenta lo reporta) y el tope de 20 partidas por expediente.

Cupo, idempotencia y auditoría: nada nuevo bajo el capó

Lo importante para el responsable de cumplimiento es que el MCP no abre un camino paralelo: los documentos que emite el agente son los mismos DeCAs, con el mismo registro de emisión sellado, la misma URL pública por token y la misma auditoría. Web, API y agente comparten el contador mensual del plan, y la emisión sigue siendo atómica: si dos emisiones compiten por el último DeCA disponible, solo una entra.

Por qué esto importa ahora

La obligación digital arranca el 5 de octubre de 2026 (Ley 9/2025, Disposición Transitoria 8ª). El cargador contractual responde de formalizar el documento (art. 7.2 de la Orden FOM/2861/2012) y cada transporte sin DeCA se sanciona con 401 a 600 € (LOTT, art. 141.17 y 143.1.d).

Para el equipo que ya trabaja con agentes, la diferencia práctica es esta: el DeCA deja de ser una tarea que hay que recordar y pasa a ser una operación más del flujo. Si la expedición ya está en tu sistema y tu agente ya la ve, emitir el documento es la última pieza que faltaba.

Empezar en cinco minutos

1. Crea tu cuenta en DeCA (el plan Free incluye 10 DeCAs al mes).
2. Contrata el add-on API REST y genera tu clave en Mi Cuenta → API.
3. Conecta tu agente a https://app.deca.cangopal.com/mcp con la cabecera X-API-Key.
4. Pídele el primer DeCA en lenguaje natural. Cuando quieras que además escriba, activa mcp_write.

La guía técnica completa, con el catálogo de las 36 herramientas y las trampas conocidas, está en la página del MCP, y hay una versión en texto plano pensada para que la lea directamente tu agente.