Cómo conectar FlipLink a Claude con el servidor MCP

¿Y si pudieras pedirle a Claude que — “convierte este PDF en un flipbook y publícalo” — y de verdad lo hiciera? Eso es justo lo que hace posible el servidor MCP de FlipLink para Claude. Una vez conectado, Claude puede crear, listar, publicar y gestionar tus flipbooks mediante una conversación natural, sin tener que ir haciendo clic por el panel.

Esta guía te lleva por toda la configuración — menos de cinco minutos desde el inicio hasta tu primera tarea.

Lo que vas a necesitar

Antes de conectar nada, asegúrate de tener:

• Node.js 18 o superior — el servidor se ejecuta a través de npx, así que Node es la única dependencia de tiempo de ejecución. (No instalas el servidor a mano; tu cliente de IA lo lanza cuando lo necesita.)
• Una clave de API de FlipLink — inicia sesión en go.fliplink.me y obtén tu clave en la página de Subscription. Esta clave autentica cada acción que realiza Claude, así que trátala como una contraseña.

Y eso es todo. Si nunca has usado un servidor de model context protocol, vale la pena dedicarle dos minutos de lectura: qué es un servidor MCP.

Conecta FlipLink a Claude Code (un solo comando)

Si usas Claude Code, toda la configuración es un único comando. Pon tu clave y ejecútalo:

claude mcp add fliplink -e FLIPLINK_API_KEY=<YOUR_KEY> -- npx -y fliplink-mcp

Eso registra FlipLink como servidor MCP, pasa tu clave de API como variable de entorno y le indica a Claude que lance el servidor mediante npx cuando lo necesite. La opción -y permite que npx descargue el paquete sin un aviso interactivo. Reinicia tu sesión de Claude Code y las herramientas de FlipLink quedan disponibles.

Conecta Claude Desktop (bloque de configuración)

Claude Desktop (y otros clientes como Cursor o Codex) usan una configuración JSON en su lugar. Añade una entrada mcpServers como esta:

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

Cambia <YOUR_KEY> por tu clave real, guarda la configuración y reinicia el cliente. En el siguiente arranque, las herramientas de FlipLink se cargan automáticamente. El valor FLIPLINK_MCP_MODE define qué acciones se permiten — más sobre esto a continuación.

Verifica la conexión

Antes de pedirle a Claude que haga trabajo real, confirma que todo está bien conectado. La comprobación más sencilla es la herramienta de estado de nivel superior, whoami. Solo pídele a Claude:

“Ejecuta la herramienta whoami de FlipLink.”

Claude llama a la herramienta y devuelve la identidad de tu cuenta y tu tamaño máximo de subida. Si tu clave falta o es incorrecta, el servidor responde con instrucciones de configuración claras — así un error confuso se convierte en uno que puedes resolver.

🚀

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.

Cómo se ve una llamada a una herramienta

Nunca escribes el nombre de una herramienta tú mismo. Describes lo que quieres en lenguaje natural y Claude elige la herramienta adecuada, completa los argumentos y la ejecuta. Las herramientas de FlipLink se generan directamente a partir de la especificación de la API y siguen el formato <noun>_<verb> — así que verás pasar llamadas como flipbook_create_by_file, flipbook_publish, flipbook_set_skin o leads_list mientras Claude trabaja.

Tras bambalinas, cada herramienta se corresponde con un endpoint real de la API de FlipLink. Si en algún momento quieres ver la estructura de las solicitudes, los parámetros y una consola Try-It en vivo, la referencia de la API completa documenta cada uno — y de ahí también obtienes tu clave de API.

Tu primera tarea

Ahora viene lo divertido. Pásale un PDF a Claude y pídele:

“Crea un flipbook a partir de este PDF y llámalo Informe T3.”

Claude llama a flipbook_create_by_file, sube el archivo y te devuelve el ID del nuevo flipbook y su URL para compartir. A partir de ahí puedes seguir en la misma conversación:

“Ahora publícalo y dame el enlace para compartir.”

Claude encadena flipbook_publish y flipbook_get_share_link y devuelve un enlace que puedes enviar de inmediato. Sin cambiar de pestaña, sin pasos manuales — solo una conversación que produce flipbooks reales y publicados. Para tener una visión más amplia de lo que esto abre, consulta automatización de flipbooks con lenguaje natural.

Unas palabras sobre los modos (seguro por defecto)

El servidor MCP viene con una protección que conviene entender: el ajuste FLIPLINK_MCP_MODE controla qué herramientas puede alcanzar Claude.

• readonly — 19 herramientas, solo lectura. Claude puede listar e inspeccionar, pero nunca cambiar nada.
• safe — 79 herramientas y el modo por defecto. Lecturas más escrituras reversibles y control de acceso; sin eliminar, sin acciones comerciales. Este es el punto de partida adecuado para casi todo el mundo.
• full — las 87 herramientas, incluidas las acciones destructivas y relacionadas con dinero.

Incluso en modo full hay una segunda red de seguridad: las herramientas de eliminación y de venta/precios nunca se activan en la primera llamada. El servidor devuelve una vista previa de una línea más un token de confirmación de corta duración (vinculado a esos argumentos exactos, que caduca en cinco minutos), y Claude tiene que mostrarte la vista previa y volver a llamar con el token antes de que ocurra cualquier acción irreversible. Si quieres el desglose completo de cómo funcionan estas protecciones, lee protecciones de seguridad del servidor MCP.

Empieza a hablar con tus flipbooks

Conectar FlipLink a Claude convierte la gestión de flipbooks en una conversación. Un comando (o un bloque de configuración), una comprobación rápida de whoami y ya le estás pidiendo a Claude que cree y publique flipbooks por ti — de forma segura, con el modo safe protegiéndote desde el primer momento.

¿Listo para empezar? Obtén tu clave en la página de Subscription, ejecuta el comando de configuración y pídele a Claude que cree su primer flipbook.

Lecturas relacionadas

• Resumen del servidor MCP de FlipLink
• ¿Qué es un servidor MCP?
• Protecciones de seguridad del servidor MCP (readonly / safe / full)
• Automatización de flipbooks con lenguaje natural
• Función de acceso a la API
• Referencia de la CLI de FlipLink