FlipLink MCP-server
Bedien FlipLink vanuit je AI-assistent. Laat Claude, Cursor of een willekeurige MCP-client je flipbooks in natuurlijke taal maken, configureren, publiceren en beheren — met ingebouwde beveiligingen op alles wat destructief is.
Verbind met één keer kopiëren en plakken
Plak de startprompt in Claude Code — die voegt de FlipLink MCP-server toe en controleert hem.
Vervang YOUR_API_KEY door je eigen FlipLink API-sleutel.
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.Werkt met je AI-tools
Claude
Cursor
ChatGPT
Codex
VS Code
Windsurf
Installeert via npx fliplink-mcp · gebruikt je eigen API-sleutel · 87 tools
Hoe het werkt
De FlipLink MCP-server is een klein programma dat je AI-client op je eigen machine draait. Hij stelt dezelfde FlipLink REST-API beschikbaar als MCP-tools, zodat de assistent ze in natuurlijke taal kan aanroepen. Het is een derde voordeur naar dezelfde API — een broertje van de CLI. Er verandert niets aan de API; deze server is gewoon weer een client, en alle beveiligingen draaien lokaal voordat er een verzoek je machine verlaat.
Installeren
Je installeert niets met de hand — je AI-client start de server met npx. Je hebt alleen je eigen FlipLink API-sleutel nodig (zie hieronder).
Claude Code
claude mcp add fliplink -e FLIPLINK_API_KEY=<YOUR_KEY> -- npx -y fliplink-mcpClaude Desktop · Cursor · Codex
Voeg dit toe aan de MCP-configuratie van de client (een mcpServers-blok):
{
"mcpServers": {
"fliplink": {
"command": "npx",
"args": ["-y", "fliplink-mcp"],
"env": {
"FLIPLINK_API_KEY": "<YOUR_KEY_FROM_SUBSCRIPTION_PAGE>",
"FLIPLINK_MCP_MODE": "safe"
}
}
}
}Haal je API-sleutel op
Elke gebruiker levert zijn eigen sleutel aan — wij vullen er nooit één voor je in. Log in en kopieer je sleutel van de abonnementspagina, en plak hem dan in de bovenstaande configuratie als FLIPLINK_API_KEY.
Ontbreekt de sleutel, dan geeft elke tool een duidelijke instructie terug om hem toe te voegen — zo kan de assistent je door de installatie loodsen voordat je ook maar één pagina documentatie leest.
Startprompt
Plak dit in een nieuwe AI-sessie om een veilige workflow op te zetten:
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>Modi
Tools zijn ingedeeld naar risico, en een modus bepaalt welke niveaus beschikbaar zijn. Stel FLIPLINK_MCP_MODE in de configuratie in (standaard safe).
| Modus | Stelt beschikbaar | Opmerkingen |
|---|---|---|
| readonly | Alleen lezen (19 tools) | whoami, lijsten, opzoekacties |
| safe (standaard) | Lezen + omkeerbare schrijfacties + toegangsbeheer (79 tools) | Geen verwijder- of commerce-tools |
| full | Alles (87 tools) | Verwijder- + commerce-tools vereisen een bevestiging |
Nieuw met deze termen? Lees wat een API is en automatisering.
Veiligheidsmodel
In de full-modus worden destructieve tools (verwijderen) en geldtools (verkoop / prijzen) bij de eerste aanroep nooit uitgevoerd. De server geeft een voorbeeld van één regel terug plus een kortlevend confirm_token; de assistent moet je het voorbeeld tonen en opnieuw aanroepen met dat token. Het token is gekoppeld aan de exacte argumenten en verloopt na 5 minuten. Deze controle zit in de server — de FlipLink API krijgt hem nooit te zien.
Elke tool draagt ook MCP-annotaties (readOnlyHint, destructiveHint, idempotentHint), zodat clients hun eigen goedkeuringsmeldingen kunnen tonen.
Tools
Tools worden gegenereerd uit de API-specificatie en krijgen de naam <noun>_<verb> — bijvoorbeeld flipbook_publish, flipbook_set_skin, leads_list, cname_add. De enige tool op het hoogste niveau voor een health-check is whoami. De volledige parameterreferentie van elk onderliggend endpoint vind je in de REST-API-documentatie.
Veelgestelde vragen
- Wat is een MCP-server?
Een MCP-server (Model Context Protocol) is een klein programma dat je AI-client lokaal draait en dat tools beschikbaar maakt voor de assistent. De server van FlipLink stelt diezelfde FlipLink REST API als tools beschikbaar, zodat Claude, Cursor of elke andere MCP-client flipbooks kan maken, instellen en publiceren in natuurlijke taal.
- Welke AI-clients worden ondersteund?
Elke MCP-client — waaronder Claude Code, Claude Desktop, Cursor en Codex. Je voegt FlipLink toe aan de
mcpServers-config van de client en die start de server op aanvraag metnpx fliplink-mcp.- Wat zijn de modi readonly, safe en full?
De modus bepaalt welke tools beschikbaar zijn.
readonlygeeft 19 alleen-lezen tools;safe(de standaard) voegt omkeerbare schrijfacties en toegangsbeheer toe voor 79 tools;fullgeeft alle 87, waarbij verwijder- en commerce-tools achter een bevestigingsstap zitten. Stel de modus in metFLIPLINK_MCP_MODE.- Is het veilig om een AI mijn flipbooks te laten beheren?
Ja. In de modus full worden destructieve acties (verwijderen) en acties met geld (verkoop / prijzen) nooit bij de eerste aanroep uitgevoerd — de server stuurt een preview van één regel terug plus een kortlevend bevestigingstoken dat aan precies die argumenten is gekoppeld, en de assistent moet bevestigen voordat er iets gebeurt. De beveiliging draait lokaal; de FlipLink API blijft ongewijzigd.
- Heb ik mijn eigen API-sleutel nodig?
Ja — elke gebruiker levert zijn eigen sleutel aan via de abonnementenpagina van FlipLink, ingesteld als
FLIPLINK_API_KEYin de config. Ontbreekt de sleutel, dan geeft elke tool duidelijke installatie-instructies, zodat de assistent je er stap voor stap doorheen kan helpen.