Servidor MCP de FlipLink
Maneja FlipLink desde tu asistente de IA. Deja que Claude, Cursor o cualquier cliente compatible con MCP cree, configure, publique y gestione tus flipbooks en lenguaje natural, con protecciones integradas en todo lo que sea destructivo.
Conéctate con un solo copiar y pegar
Copia el prompt de inicio en Claude Code: añade el servidor MCP de FlipLink y lo verifica.
Reemplaza YOUR_API_KEY con tu clave de API de FlipLink.
Set up and verify the FlipLink MCP server for me.
1. Add the server to this Claude Code session by running this in the terminal:
claude mcp add fliplink -e FLIPLINK_API_KEY=YOUR_API_KEY -e FLIPLINK_MCP_MODE=safe -- npx -y fliplink-mcp
2. Confirm it was added: run `claude mcp list` and check that "fliplink" appears and shows as connected.
3. Verify the config: confirm the "fliplink" server has FLIPLINK_API_KEY set in its env (it must be my real
key, not the YOUR_API_KEY placeholder, and must not be empty). Reading config: `claude mcp get fliplink`.
4. Test the connection: call the FlipLink "whoami" tool. If it returns my account, the MCP is live.
5. If "fliplink" is missing or won't connect, troubleshoot:
- Ensure Node.js 18+ and npx are installed (`node -v`).
- Re-run the add command and confirm FLIPLINK_API_KEY is present and correct (not the placeholder).
- Remove and re-add: `claude mcp remove fliplink` then re-run step 1; restart the session.
- Re-run `claude mcp list` to confirm it now shows connected.
Once "whoami" succeeds, list the FlipLink tools now available to you.Funciona con tus herramientas de IA
Claude
Cursor
ChatGPT
Codex
VS Code
Windsurf
Se instala con npx fliplink-mcp · usa tu propia clave de API · 87 herramientas
Cómo funciona
El servidor MCP de FlipLink es un pequeño programa que tu cliente de IA ejecuta en tu equipo. Expone la misma API REST de FlipLink como herramientas MCP, para que el asistente pueda llamarlas en lenguaje natural. Es una tercera puerta de entrada a la misma API, hermana de la CLI. Nada cambia en la API; este servidor es solo otro cliente, y todas las protecciones se ejecutan en tu equipo antes de que cualquier petición salga de él.
Instalación
No instalas nada a mano: tu cliente de IA arranca el servidor con npx. Solo necesitas tu propia clave de API de FlipLink (ver más abajo).
Claude Code
claude mcp add fliplink -e FLIPLINK_API_KEY=<YOUR_KEY> -- npx -y fliplink-mcpClaude Desktop · Cursor · Codex
Añade esto a la configuración MCP del cliente (un bloque mcpServers):
{
"mcpServers": {
"fliplink": {
"command": "npx",
"args": ["-y", "fliplink-mcp"],
"env": {
"FLIPLINK_API_KEY": "<YOUR_KEY_FROM_SUBSCRIPTION_PAGE>",
"FLIPLINK_MCP_MODE": "safe"
}
}
}
}Consigue tu clave de API
Cada usuario aporta su propia clave; nosotros nunca la rellenamos por ti. Inicia sesión y copia tu clave desde la página de suscripción, luego pégala en la configuración de arriba como FLIPLINK_API_KEY.
Si falta la clave, cada herramienta devuelve instrucciones claras para añadirla, así el asistente puede guiarte en la configuración antes de que leas la documentación.
Prompt de inicio
Pega esto en una sesión nueva de IA para arrancar un flujo de trabajo seguro:
You now have the FlipLink MCP server connected (tools like whoami,
flipbook_create_by_file, leads_list). First, call whoami to confirm my account is reachable.
If it returns an auth error, ask me to paste my FlipLink API key (I get it from
https://go.fliplink.me/Subscription) and remind me to put it in the MCP server config as
FLIPLINK_API_KEY, then stop until I confirm.
Once connected you can create, list, and configure my flipbooks. For any delete, sale/pricing,
or access-control change, show me a one-line preview and wait for my explicit "yes" before doing it.
Here's what I want to do: <describe your task>Modos
Las herramientas se organizan por niveles de riesgo, y un modo decide qué niveles se exponen. Define FLIPLINK_MCP_MODE en la configuración (por defecto es safe).
| Modo | Expone | Notas |
|---|---|---|
| readonly | Solo lecturas (19 herramientas) | whoami, listados, consultas |
| safe (por defecto) | Lecturas + escrituras reversibles + control de acceso (79 herramientas) | Sin herramientas de borrado ni de ventas |
| full | Todo (87 herramientas) | Las herramientas de borrado y de ventas requieren confirmación |
¿No conoces estos términos? Consulta qué es una API y automatización.
Modelo de seguridad
En el modo full, las herramientas destructivas (borrado) y de dinero (venta / precios) nunca se ejecutan en la primera llamada. El servidor devuelve una vista previa de una línea y un confirm_token de corta duración; el asistente debe mostrarte la vista previa y volver a llamar con ese token. El token está ligado a los argumentos exactos y caduca en 5 minutos. Esta protección vive en el servidor: la API de FlipLink nunca la ve.
Cada herramienta lleva además anotaciones MCP (readOnlyHint, destructiveHint, idempotentHint) para que los clientes muestren sus propias confirmaciones.
Herramientas
Las herramientas se generan a partir de la especificación de la API y se nombran <noun>_<verb>; por ejemplo flipbook_publish, flipbook_set_skin, leads_list, cname_add. La única herramienta de comprobación de estado de nivel superior es whoami. Para la referencia completa de parámetros de cada endpoint subyacente, consulta la documentación de la API REST.
Preguntas frecuentes
- ¿Qué es un servidor MCP?
Un servidor MCP (Model Context Protocol) es un pequeño programa que tu cliente de IA ejecuta de forma local y que expone herramientas al asistente. El servidor de FlipLink expone la misma API REST de FlipLink en forma de herramientas, así que Claude, Cursor o cualquier cliente MCP puede crear, configurar y publicar flipbooks con lenguaje natural.
- ¿Qué clientes de IA son compatibles?
Cualquier cliente compatible con MCP, incluidos Claude Code, Claude Desktop, Cursor y Codex. Añades FlipLink a la configuración
mcpServersdel cliente y este inicia el servidor cuando lo necesita connpx fliplink-mcp.- ¿Qué son los modos readonly, safe y full?
Los modos deciden qué herramientas se exponen.
readonlyexpone 19 herramientas de solo lectura;safe(el predeterminado) añade escrituras reversibles y control de acceso, con 79 herramientas;fullexpone las 87, con las herramientas de eliminación y de comercio protegidas tras un paso de confirmación. Define el modo conFLIPLINK_MCP_MODE.- ¿Es seguro dejar que una IA gestione mis flipbooks?
Sí. En el modo full, las acciones destructivas (eliminar) y las de dinero (venta y precios) nunca se ejecutan en la primera llamada: el servidor devuelve una vista previa de una línea y un token de confirmación de corta duración vinculado a los argumentos exactos, y el asistente debe confirmar antes de que ocurra nada. Las protecciones se ejecutan de forma local; la API de FlipLink no cambia.
- ¿Necesito mi propia clave de API?
Sí: cada usuario aporta su propia clave desde la página de suscripción de FlipLink, definida como
FLIPLINK_API_KEYen la configuración. Si falta la clave, cada herramienta devuelve instrucciones claras de configuración para que el asistente pueda guiarte paso a paso.