FlipLink CLI vs. API vs. MCP: ¿qué integración deberías usar?

FlipLink te ofrece tres formas de automatizar flipbooks sin tocar el panel: una herramienta de línea de comandos, una API REST y un servidor MCP para asistentes de IA. Suenan como tres productos distintos, pero no lo son. Son tres puertas de entrada al mismo motor — los mismos endpoints, los mismos datos, la misma cuenta.

Así que la verdadera pregunta no es “¿cuál es la mejor?”. Es “¿cuál encaja con lo que estás haciendo ahora mismo?”. Esta guía te ofrece una comparación neutral y una regla rápida para “elegir una”.

Tres puertas de entrada, una sola API

Todo lo que FlipLink puede hacer de forma programática pasa por una única API REST en https://go.fliplink.me, autenticada con una cabecera X-Api-Key. La CLI y el servidor MCP están construidos directamente sobre esa misma API — de hecho, la lista de comandos de la CLI y la lista de herramientas de MCP se generan a partir de la misma especificación de endpoints, así que no pueden desincronizarse.

Esto tiene una consecuencia útil: lo que puedes hacer en una, lo puedes hacer en las tres. Las diferencias están en quién lleva el control y cuánto código quieres escribir — no en la capacidad.

Matriz de decisión

Las tres comparten el mismo modelo de respuesta: cada respuesta es JSON con un Result de nivel superior con valor "OK" o "ERROR", y el mismo límite de 300 peticiones por minuto por clave.

Cuándo recurrir a cada una

CLI — para scripts, terminales y CI/CD

Usa la CLI cuando vivas en una terminal o en un pipeline. Es el camino más rápido desde “tengo un PDF” hasta “tengo un flipbook publicado” sin escribir un cliente HTTP. Envuélvela en un script de shell, un cron job o un paso de GitHub Actions y tendrás una automatización repetible. Añade --json a cualquier comando y pásalo por una tubería a jq para crear tus scripts. Consulta primeros pasos con la CLI.

API — para aplicaciones

Usa la API cuando FlipLink sea una función dentro de algo que estás construyendo — un portal de clientes que genera flipbooks al registrarse, un panel que extrae datos de captura de leads o una sincronización con tu CRM. Tienes control total y puedes llamarla desde cualquier lenguaje que hable HTTP. La referencia de la API incluye todos los endpoints con una consola Try-It en vivo.

MCP — para asistentes de IA y quienes no programan

Usa el servidor MCP cuando la persona (o el agente) que hace el trabajo no debería ni siquiera saber que existe un endpoint. Conecta FlipLink a Claude, Cursor u otro cliente MCP y podrás decir “publica la presentación del Q3 y dame el enlace para compartir” en lenguaje natural. El asistente elige la herramienta correcta y rellena los parámetros. Es la opción con menos fricción para quienes no programan — y viene con medidas de seguridad para que las acciones destructivas requieran confirmación primero.

🚀

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.

Puedes combinarlas

No son excluyentes entre sí. Una configuración habitual usa las tres: la API impulsa tu app en producción, la CLI ejecuta trabajos por lotes nocturnos en CI y el servidor MCP permite que tu equipo cree flipbooks puntuales pidiéndoselo a un asistente de IA. La misma cuenta, los mismos flipbooks, los mismos datos — solo que con puertas distintas para momentos distintos.

La misma tarea, de tres formas

Aquí tienes exactamente el mismo resultado — crear un flipbook a partir de un PDF — a través de cada puerta.

CLI — un comando en tu terminal:

fliplink flipbook create ./q3-report.pdf --title "Q3 Report" --name q3

API — una petición HTTP que haces desde código:

curl -X POST 'https://go.fliplink.me/api/create-by-file' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'File=@q3-report.pdf' \
  -F 'Name=q3' \
  -F 'Title=Q3 Report'

MCP — lenguaje natural en tu cliente de IA:

“Crea un flipbook a partir de q3-report.pdf con el título ‘Q3 Report’.”

Entre bastidores, el asistente llama a la herramienta flipbook_create_by_file con los mismos parámetros que la petición curl anterior. Las tres devuelven el mismo JSON — {"Result":"OK","ID":"90001","URL":"https://go.fliplink.me/view/<slug>", ...} — porque las tres llegan al mismo endpoint.

Guía rápida para “elegir una”

• ¿Escribes un script o un pipeline de CI/CD? → CLI
• ¿Integras flipbooks en tu propia app? → API
• ¿Quieres que un asistente de IA o alguien que no programa lo haga? → MCP
• ¿No estás seguro? Empieza por la CLI — es la forma más rápida de ver resultados, y lo que aprendas se traslada directamente a la API.

Sea cual sea la puerta que cruces, estás usando el mismo motor de FlipLink. Elige la que encaje con tu forma de trabajar hoy — siempre puedes añadir otra más adelante.

Lecturas relacionadas

• Primeros pasos con la CLI de FlipLink
• Conecta FlipLink a Claude con un servidor MCP
• ¿Qué es un servidor MCP?
• Cómo usar la API de FlipLink para integraciones personalizadas
• Automatización e integraciones
• Acceso a la API