Cómo usar FlipLink en Cursor y otros clientes MCP

Si ya vives dentro de Cursor, no necesitas salir de tu editor para trabajar con FlipLink. Al añadir el servidor MCP de FlipLink, la IA integrada de Cursor puede crear flipbooks, publicarlos, extraer leads y mucho más — con solo pedírselo en lenguaje natural. La misma config funciona en Claude Desktop, Codex y cualquier otra herramienta que hable el Model Context Protocol.

Esta guía recorre la configuración en Cursor y luego te muestra la config genérica que funciona en todos los clientes MCP.

Qué es un cliente MCP

Un cliente MCP es cualquier aplicación que puede conectarse a servidores MCP y dejar que su IA use las herramientas que esos servidores exponen. Cursor, Claude Desktop y Codex son todos clientes MCP. El Model Context Protocol es el estándar abierto que les permite comunicarse con un servidor como fliplink-mcp sin necesidad de código de integración personalizado.

Cuando conectas el servidor MCP de FlipLink, el cliente lo lanza en segundo plano y la IA obtiene un conjunto de herramientas de FlipLink — cosas como flipbook_create_by_file, flipbook_publish y leads_list. ¿Es nuevo el concepto para ti? Empieza por qué es un servidor MCP y luego vuelve aquí.

Dónde vive la config MCP de Cursor

Cursor gestiona los servidores MCP desde su configuración. Abre la configuración de Cursor, busca la sección MCP / Model Context Protocol y elige añadir un nuevo servidor MCP. Cursor te deja pegar la definición de un servidor como JSON — la misma forma mcpServers que usa cualquier cliente MCP.

No tienes que instalar nada a mano. El cliente ejecuta el servidor con npx bajo demanda, así que los únicos requisitos son Node.js 18+ y una clave de API de FlipLink. Consigue una clave iniciando sesión en go.fliplink.me y abriendo la página Subscription.

El bloque del servidor FlipLink

En la configuración MCP de Cursor, añade un servidor MCP con esta entrada mcpServers. Reemplaza <YOUR_KEY> por tu clave de API de FlipLink:

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

Algunas notas sobre este bloque:

• command + args le dicen al cliente que lance el servidor con npx — sin necesidad de instalación global.
• FLIPLINK_API_KEY autentica cada llamada. Trátala como una contraseña; mantenla fuera de los repos compartidos.
• FLIPLINK_MCP_MODE controla cuántas herramientas se exponen. safe (el valor por defecto) da lecturas más escrituras reversibles y controles de acceso — sin borrados ni acciones de comercio. Usa readonly para una configuración de solo lectura, o full para todo. Consulta los modos de seguridad de MCP para ver el desglose completo.

Después de guardar, reinicia Cursor (o recarga el servidor MCP desde la configuración) para que tome la nueva entrada.

Pruébalo: pídele a Cursor que llame a whoami

La forma más rápida de confirmar que la conexión funciona es la herramienta de comprobación de estado. En el chat de Cursor, pide:

Usa el MCP de FlipLink y llama a whoami.

La herramienta whoami es la comprobación de cuenta de nivel superior. Si tu clave es válida, recibirás la identidad de tu cuenta y tu tamaño máximo de subida. Si la clave falta o es incorrecta, la herramienta devuelve instrucciones de configuración claras en lugar de un error críptico — esa es tu señal para corregir el valor de FLIPLINK_API_KEY y reiniciar.

Una vez que whoami funcione, prueba algo real:

Crea un flipbook a partir de ./deck.pdf titulado "Q3 Report" y luego dame el enlace para compartir.

La IA de Cursor llamará a flipbook_create_by_file y flipbook_get_share_link por ti, sin necesidad de llamadas manuales a la API.

🚀

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.

Otros clientes usan la misma config

Lo bueno de MCP es que la config es genérica. El bloque mcpServers de arriba funciona tal cual en Claude Desktop, Codex y cualquier otro cliente MCP — solo cambia el menú donde lo pegas. En cada cliente, busca la configuración de MCP o Model Context Protocol y añade un servidor con esa misma forma JSON.

Si tu cliente ofrece una opción de transporte stdio, esa es la que debes elegir: fliplink-mcp se comunica por stdio, que es exactamente lo que configuran command + args. No hay nada específico de FlipLink en el transporte — es la config stdio estándar que usa todo servidor MCP.

Para Claude Code en concreto, puedes saltarte el JSON por completo y ejecutar un solo comando:

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

Hay un tutorial dedicado para ese cliente en conecta FlipLink a Claude con MCP.

Preguntas frecuentes de resolución de problemas

P: El servidor de FlipLink no aparece en Cursor. ¿Qué hago? R: Primero confirma que tienes Node.js 18+ instalado (node --version), ya que npx lo necesita. Luego comprueba dos veces que el JSON sea válido — una coma o un corchete que falte hará que el servidor desaparezca sin avisar. Por último, reinicia el cliente por completo para que vuelva a leer la config.

P: Las herramientas aparecen, pero cada llamada falla con un mensaje de configuración. R: Eso significa que la clave de API no está llegando al servidor. Verifica que FLIPLINK_API_KEY esté definida en el bloque env y que el valor sea tu clave real de la página Subscription. Guarda y reinicia después de editar.

P: ¿Por qué la IA no puede eliminar un flipbook ni ejecutar una acción de venta? R: Estás en modo safe, que oculta las herramientas destructivas y de comercio a propósito. Cambia FLIPLINK_MCP_MODE a full para habilitarlas — pero ten en cuenta que las acciones de borrado y de dinero siguen requiriendo un paso de confirmación antes de ejecutarse. Consulta los modos de seguridad de MCP.

Para terminar

Añadir FlipLink a Cursor lleva un bloque JSON y un reinicio. Una vez conectado, la IA de tu editor se encarga de crear flipbooks, publicarlos y exportar leads mediante lenguaje natural — y la misma config encaja directamente en cualquier otro cliente MCP que uses.

Lecturas complementarias

• El servidor MCP de FlipLink — lista completa de herramientas, modos y detalles de seguridad
• ¿Qué es un servidor MCP?
• Conecta FlipLink a Claude con MCP
• Modos de seguridad de MCP (readonly / safe / full)
• Documentación de la CLI de FlipLink
• Referencia de la API