Serveur MCP FlipLink
Pilote FlipLink depuis ton assistant IA. Laisse Claude, Cursor ou n'importe quel client compatible MCP créer, configurer, publier et gérer tes flipbooks en langage naturel — avec des garde-fous intégrés sur tout ce qui est destructeur.
Connecte-toi en un seul copier-coller
Copie le prompt de départ dans Claude Code : il ajoute le serveur MCP FlipLink et le vérifie.
Remplace YOUR_API_KEY par ta vraie clé API 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.Compatible avec tes outils IA
Claude
Cursor
ChatGPT
Codex
VS Code
Windsurf
S'installe via npx fliplink-mcp · utilise ta propre clé API · 87 outils
Comment ça marche
Le serveur MCP FlipLink est un petit programme que ton client IA exécute sur ta machine. Il expose la même API REST FlipLink sous forme d'outils MCP, pour que l'assistant puisse les appeler en langage naturel. C'est une troisième porte d'entrée vers la même API — l'équivalent du CLI. Rien ne change côté API ; ce serveur n'est qu'un client de plus, et tous les garde-fous s'exécutent en local avant qu'une requête ne quitte ta machine.
Installation
Tu n'installes rien à la main — c'est ton client IA qui lance le serveur avec npx. Il te suffit d'avoir ta propre clé API FlipLink (voir ci-dessous).
Claude Code
claude mcp add fliplink -e FLIPLINK_API_KEY=<YOUR_KEY> -- npx -y fliplink-mcpClaude Desktop · Cursor · Codex
Ajoute ceci à la config MCP du client (un bloc mcpServers) :
{
"mcpServers": {
"fliplink": {
"command": "npx",
"args": ["-y", "fliplink-mcp"],
"env": {
"FLIPLINK_API_KEY": "<YOUR_KEY_FROM_SUBSCRIPTION_PAGE>",
"FLIPLINK_MCP_MODE": "safe"
}
}
}
}Récupère ta clé API
Chaque utilisateur fournit sa propre clé — nous n'en pré-remplissons jamais. Connecte-toi et copie ta clé depuis la page d'abonnement, puis colle-la dans la config ci-dessus en tant que FLIPLINK_API_KEY.
Si la clé est absente, chaque outil renvoie des instructions claires pour l'ajouter — l'assistant peut donc te guider dans la configuration avant même que tu ne lises la moindre doc.
Prompt de démarrage
Colle ceci dans une nouvelle session IA pour amorcer un workflow sûr :
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>Modes
Les outils sont classés par niveau de risque, et un mode décide des niveaux exposés. Définis FLIPLINK_MCP_MODE dans la config (par défaut safe).
| Mode | Expose | Notes |
|---|---|---|
| readonly | Lectures seules (19 outils) | whoami, listes, recherches |
| safe (par défaut) | Lectures + écritures réversibles + contrôle d'accès (79 outils) | Aucun outil de suppression ou de vente |
| full | Tout (87 outils) | Les outils de suppression et de vente exigent une confirmation |
Tu débutes avec ces termes ? Découvre ce qu’est une API et l’automatisation.
Modèle de sécurité
En mode full, les outils destructeurs (suppression) et monétaires (vente / tarification) ne s'exécutent jamais au premier appel. Le serveur renvoie un aperçu sur une ligne et un confirm_token à durée de vie courte ; l'assistant doit t'afficher l'aperçu et rappeler l'outil avec ce token. Le token est lié aux arguments exacts et expire au bout de 5 minutes. Ce contrôle vit dans le serveur — l'API FlipLink ne le voit jamais.
Chaque outil porte aussi des annotations MCP (readOnlyHint, destructiveHint, idempotentHint) pour que les clients puissent afficher leurs propres demandes de validation.
Outils
Les outils sont générés à partir de la spécification de l'API et nommés <noun>_<verb> — par exemple flipbook_publish, flipbook_set_skin, leads_list, cname_add. Le seul outil de vérification de haut niveau est whoami. Pour la référence complète des paramètres de chaque endpoint sous-jacent, consulte la doc de l'API REST.
Questions fréquentes
- Qu'est-ce qu'un serveur MCP ?
Un serveur MCP (Model Context Protocol) est un petit programme que ton client IA exécute en local et qui expose des outils à l'assistant. Le serveur de FlipLink expose la même API REST FlipLink sous forme d'outils, pour que Claude, Cursor ou n'importe quel client MCP puisse créer, configurer et publier des flipbooks en langage naturel.
- Quels clients IA sont pris en charge ?
N'importe quel client compatible MCP — dont Claude Code, Claude Desktop, Cursor et Codex. Tu ajoutes FlipLink à la configuration
mcpServersdu client, qui lance alors le serveur à la demande avecnpx fliplink-mcp.- À quoi correspondent les modes readonly, safe et full ?
Les modes déterminent quels outils sont exposés.
readonlyexpose 19 outils en lecture seule ;safe(le mode par défaut) ajoute les écritures réversibles et le contrôle d'accès, pour 79 outils ;fullexpose les 87, les outils de suppression et de commerce étant protégés par une étape de confirmation. Tu définis le mode avecFLIPLINK_MCP_MODE.- Est-il prudent de laisser une IA gérer mes flipbooks ?
Oui. En mode full, les actions destructrices (suppression) et financières (vente / tarification) ne s'exécutent jamais au premier appel : le serveur renvoie un aperçu sur une ligne et un jeton de confirmation à durée limitée, lié aux arguments exacts, et l'assistant doit confirmer avant que quoi que ce soit ne se produise. Les garde-fous s'exécutent en local ; l'API FlipLink reste inchangée.
- Ai-je besoin de ma propre clé API ?
Oui — chaque utilisateur fournit sa propre clé depuis la page d'abonnement FlipLink, définie comme
FLIPLINK_API_KEYdans la configuration. Si la clé est absente, chaque outil renvoie des instructions de configuration claires pour que l'assistant puisse te guider.