Crea un agente de IA que genere flipbooks

¿Y si “publica el informe de este mes como flipbook” fuera algo que tu computadora hiciera por su cuenta — sin panel, sin subir archivos, sin copiar y pegar un enlace para compartir en un correo? Esa es la promesa de un agente de IA para documentos: describes el resultado y el agente llama a las herramientas correctas en el orden correcto para lograrlo.

Este tutorial muestra cómo crear uno con el servidor MCP de FlipLink y Claude. El agente tomará un informe PDF recién generado, creará un flipbook a partir de él, lo publicará y te devolverá un enlace para compartir — justo el tipo de tarea que puedes ejecutar de forma programada y olvidarte de ella. También seremos honestos sobre dónde un agente totalmente desatendido choca con límites reales, y cuándo un simple script (la CLI) es la mejor herramienta.

El escenario: un informe mensual que se publica solo

Imagina una tarea recurrente. El primero de cada mes, algún pipeline genera report.pdf — cifras de ventas, un boletín, una presentación para la junta. Hoy, una persona lo sube al panel, lo publica, copia el enlace y lo pega en algún lado. Queremos automatizar eso con un agente que pueda razonar sobre los pasos en lugar de programar cada uno a mano.

El agente tiene que poder: crear un flipbook a partir del archivo, publicarlo y obtener el enlace para compartir. Con el servidor MCP de FlipLink conectado, eso se traduce en herramientas reales que el modelo puede llamar directamente.

Paso 1 — Conecta el servidor MCP

El Model Context Protocol es la forma en que un cliente de IA (Claude, Cursor y otros) descubre y llama a herramientas externas. El servidor MCP de FlipLink expone la API de FlipLink como un conjunto de herramientas que el modelo puede usar en una conversación.

Para el recorrido completo, consulta Conecta FlipLink a Claude con el servidor MCP. La versión corta — no hay nada que instalar a mano, tu cliente lo arranca con npx:

claude mcp add fliplink -e FLIPLINK_API_KEY=YOUR_API_KEY -- npx -y fliplink-mcp

O bien, como un bloque de configuración mcpServers (Claude Desktop, Cursor, Codex):

{
  "mcpServers": {
    "fliplink": {
      "command": "npx",
      "args": ["-y", "fliplink-mcp"],
      "env": { "FLIPLINK_API_KEY": "YOUR_API_KEY", "FLIPLINK_MCP_MODE": "safe" }
    }
  }
}

Las herramientas se generan a partir de la especificación de FlipLink y se nombran <noun>_<verb> — así que el agente verá flipbook_create_by_file, flipbook_publish, flipbook_get_share_link y una comprobación de estado de nivel superior whoami, entre otras. Obtén tu clave iniciando sesión en go.fliplink.me.

Paso 2 — Escribe el prompt del agente

Un agente no es más que un modelo con un bucle: lee el objetivo, decide qué herramienta llamar, lee el resultado y decide qué hacer a continuación hasta cumplir el objetivo. La calidad de ese bucle depende casi por completo de un prompt claro que nombre las herramientas, el orden y la condición de éxito.

Este es un prompt realista de sistema/tarea para el agente del informe mensual:

SYSTEM:
You are a publishing agent for FlipLink. Your job is to turn a PDF report
into a published flipbook and return its share link. You have FlipLink MCP
tools available (names follow the pattern noun_verb).

Operating rules:
1. Start by calling `whoami` to confirm the API key works and check the
   remaining flipbook quota. If `whoami` fails, STOP and report the error.
2. Create the flipbook from the file with `flipbook_create_by_file`
   (field File = the PDF path; set Name and Title from the task).
3. Read the result. Every FlipLink response has a top-level `Result` field
   that is "OK" or "ERROR". If `Result` is "ERROR", STOP and report the
   `Message` — do NOT retry blindly or proceed.
4. On success, capture the returned flipbook ID.
5. Publish it with `flipbook_publish` using that ID. Check `Result` again.
6. Fetch the share link with `flipbook_get_share_link`.
7. Report back: the flipbook ID, the published share URL, and the quota left.

Never invent tool names or IDs. If a step has no clear next action,
stop and explain rather than guessing.

TASK:
Publish this month's report. File: ./reports/2026-06-report.pdf
Title: "June 2026 Report". Name: "june-2026-report".

Dos cosas hacen que este prompt funcione. Primero, le indica al agente que se ramifique según el campo Result — FlipLink devuelve los errores de aplicación como HTTP 200 con Result: "ERROR", así que una comprobación ingenua del tipo “¿la llamada devolvió 200?” trataría en silencio los fallos como aciertos. Segundo, da una condición de parada explícita para cada ruta de fallo, lo que evita que una ejecución desatendida acabe enredada en reintentos.

Paso 3 — Salvaguardas para ejecuciones desatendidas

Aquí hay que verlo con claridad. El modo MCP por defecto es safe (79 herramientas): lecturas más escrituras reversibles, sin eliminación ni herramientas de comercio. Nuestro agente del informe mensual solo crea, publica y lee — todo lo cual cabe dentro del modo safe — así que para esta tarea puedes dejar el valor por defecto y el agente se ejecuta de principio a fin sin fricción.

Las acciones destructivas son otra historia. Si tu agente llega a necesitar eliminar un flipbook o tocar precios/ventas, tiene que ejecutarse en modo full (87 herramientas). En modo full, las herramientas de eliminación y de dinero nunca se ejecutan en la primera llamada: el servidor devuelve una vista previa de una línea más un confirm_token de corta duración (ligado a los argumentos exactos, caduca en 5 minutos), y el asistente tiene que volver a llamar con ese token. Esa barrera vive en el servidor — la API de FlipLink en sí no cambia.

Sé honesto sobre lo que esto significa para lo “totalmente autónomo”:

• Un agente que lee, crea y publica en modo safe sí puede ejecutarse desatendido sin problemas. Nada de lo que hace está sujeto a barreras.
• Un agente que elimina cosas no puede ser, al mismo tiempo, libre de fricción y desatendido. La barrera del confirm-token está ahí a propósito. O una persona aprueba el paso destructivo, o tu harness se ejecuta en modo full y maneja de forma explícita el flujo vista previa → confirm-token → segunda llamada en el código. No diseñes un pipeline que dé por hecho que un flipbook se va a eliminar solo y en silencio, sin confirmación — no lo hará, y de eso se trata.

Para el desglose completo de los modos y el flujo del confirm-token, consulta Seguridad y salvaguardas del servidor MCP. Las herramientas también llevan anotaciones MCP (readOnlyHint, destructiveHint, idempotentHint) para que un harness cuidadoso pueda razonar sobre el riesgo antes de llamar a cualquier cosa.

🚀

Prueba FlipLink Gratis

Convierte tu PDF en segundos. Sin registro, sin tarjeta de crédito — solo súbelo y listo.

Drop your PDF here or click to browse

Máximo 40MB

Los planes de pago desde $39 lo amplían a 150 MB.

Paso 4 — Prográmalo

Una vez que el agente se ejecute de forma fiable a mano, ponlo en un temporizador. Cómo lo hagas depende de tu cliente — un cron job que invoque a Claude en modo headless con el prompt de la tarea, un flujo de trabajo programado o tu propia orquestación. La mecánica queda fuera del alcance de este artículo; lo importante es que el prompt y el modo son los que hacen segura una ejecución programada, no el planificador en sí. Mantén el agente en modo safe para tareas de crear/publicar y la ejecución sigue siendo desatendida sin chocar con un muro de confirmación.

Paso 5 — Verifica el resultado

No te fíes de “el agente dijo que funcionó.” Verifica el artefacto real:

• El informe final del agente debería incluir un ID de flipbook y una URL para compartir. Abre la URL — debería cargar el flipbook publicado.
• Comprueba la cuota de whoami antes y después, para que sepas que la creación realmente consumió un cupo en lugar de fallar en silencio.
• Como cada resultado de herramienta lleva un campo Result, un agente bien construido muestra el Message exacto en caso de fallo. Si la ejecución informa Result: "ERROR", lee el mensaje en lugar de volver a ejecutarla — un límite de cuota o un archivo demasiado grande no se va a arreglar solo con un reintento.

Cuándo la CLI es la mejor herramienta

Este es el contrapunto honesto a todo lo anterior: para una tarea headless y determinista en CI, normalmente no quieres un agente de LLM en absoluto.

Un agente de IA brilla cuando la tarea exige criterio — decidir cómo titular algo, reaccionar ante una entrada ambigua o encadenar pasos que no detallaste por completo. Pero “toma este archivo exacto, crea un flipbook, publícalo, imprime el enlace” no tiene ninguna ambigüedad. Ejecutar un LLM para eso suma costo, latencia y falta de determinismo sin ningún beneficio, y aun así tienes que manejar la misma ramificación según Result.

Para eso, recurre a la CLI de FlipLink. Se genera a partir de la misma especificación que el servidor MCP y la API, así que no puede desfasarse, y devuelve códigos de salida limpios (0 éxito, 1 error de solicitud, 2 error de aplicación) que CI puede usar para ramificar sin ningún parseo:

fliplink config set-key "$FLIPLINK_API_KEY"
ID=$(fliplink flipbook create ./reports/2026-06-report.pdf \
  --title "June 2026 Report" --name june-2026-report --json | jq -r '.ID')
fliplink flipbook publish "$ID"
fliplink flipbook share-link "$ID"

Esa es toda la tarea mensual, sin necesidad de un modelo. Para un pipeline completo — incluyendo cómo ejecutarlo dentro de integración continua — consulta Automatiza la publicación de flipbooks en CI/CD.

Regla general: usa un agente de IA cuando la tarea necesite criterio; usa la CLI cuando necesite ser igual siempre. Muchos equipos usan ambos — el agente para peticiones ad-hoc del tipo “publica esto por mí”, la CLI para las ejecuciones programadas y mecánicas.

Empieza a construir

Un agente de IA para documentos elimina la parte manual intermedia de la publicación: tú dictas el resultado, él llama a las herramientas. Con FlipLink MCP en modo safe, un agente que crea y publica se ejecuta de principio a fin sin fricción — y donde entran en juego las acciones destructivas, la barrera del confirm-token mantiene las ejecuciones desatendidas honestas en lugar de peligrosas.

¿Listo? Conecta el servidor MCP, apunta un agente a un informe y míralo publicar. Para la ruta determinista de CI, la documentación de la CLI te tiene cubierto. El catálogo completo de endpoints está en la referencia de la API.

Lecturas complementarias

• Conecta FlipLink a Claude con el servidor MCP
• Seguridad y salvaguardas del servidor MCP
• Automatización de flipbooks en lenguaje natural
• Automatiza la publicación de flipbooks en CI/CD
• La documentación de la CLI de FlipLink
• La referencia de la API de FlipLink