Inicio › Blog › Conecta ShipPDF a tu asistente de IA

Pídele a tu asistente de IA «haz una factura para Acme, 1240 USD, con vencimiento a 30 días» y puede darte un PDF. Pídele cien y aparece el problema: la maquetación se desvía, la marca queda aproximada y no hay dos iguales. Cada documento es una conjetura nueva, y reproducir el que enviaste el mes pasado es un proyecto aparte.

ShipPDF convierte esa conjetura en una plantilla. Deja que tu asistente haga una maqueta del documento, previsualízala en el editor visual, ajusta lo que no encaje y publícala. A partir de ahí cada generación usa esa misma plantilla, así que la factura número cien se ve como la primera. ShipPDF expone un servidor MCP, para que el asistente pueda armar la plantilla, publicarla y generar el PDF sin código de generación de tu lado.

Este es el ciclo completo.

1. Apunta tu asistente hacia ShipPDF

Añade el servidor mcp.shippdf.com a cualquier cliente compatible con MCP (Claude, ChatGPT, Gemini o Copilot) y autentícate con una clave con alcance limitado. La clave marca el límite:

• templates:write para crear y publicar plantillas
• documents:create para generar PDF

Concede una o ambas. Un asistente que solo tiene documents:create puede generar documentos y nada más en tu cuenta.

2. Pídele que arme una plantilla

Describe el documento como se lo describirías a un colega: «una factura con nuestro logo, una tabla de conceptos y un bloque de totales». El asistente llama a create_template con un documento estructurado (los campos y las páginas maquetadas) y luego a publish_template para congelar ese borrador en una revisión numerada.

create_template({ name: "Factura", document: { /* páginas + campos de datos */ } })
→ { template_id: "tpl_8f...", lock_version: 1 }

publish_template({ template_id: "tpl_8f..." })
→ { published_revision: 1 }

Antes de publicar, abre el borrador en el editor visual para previsualizarlo con datos reales y ajustar lo que no encaje. Nunca escribes el marcado a mano, y una vez publicado es un objeto de plantilla real que puedes reutilizar, versionar y revertir.

3. Genera el PDF a partir de tus datos

Entrégale los datos. El asistente llama a generate_document, recibe un document_ref y consulta get_document hasta que el archivo está listo:

generate_document({
  template_id: "tpl_8f...",
  data: { number: "INV-1042", customer: "Acme Co." }
})
→ { document_ref: "doc_a3...", status: "queued" }

get_document({ document_ref: "doc_a3..." })
→ { status: "completed", pdf_url: "…/inv-1042.pdf" }

Ese pdf_url es un documento terminado sobre tu plantilla. Envíalo, archívalo o pega el enlace en un registro.

Por qué pasar por MCP

• Conservas tu elección de modelo. ShipPDF no incluye una IA. Expone herramientas. Cambia de un asistente a otro y las plantillas ni se enteran.
• Una plantilla, cualquier disparador. Lo que arma el asistente es la misma plantilla que usan tus flujos por API y sin código, no una copia paralela que se desincroniza.
• Puedes reproducirlo. Misma plantilla, mismos datos, mismo PDF. Un documento que un agente generó en marzo es uno que puedes volver a generar y verificar en octubre.
• Con alcance por la clave, no por confianza. La clave fija el radio de acción, así que «que lo haga el asistente» nunca se convierte en «el asistente puede tocarlo todo».

¿Empiezas con ShipPDF? Arranca con plantillas entran, documentos salen para ver cómo funcionan las plantillas.

¿Quieres que tu asistente entregue el documento terminado en lugar de un borrador? Crea una cuenta.

Archivado en#ai#mcp#tutorial