FlipLink MCP-Server
Steuere FlipLink aus deinem KI-Assistenten. Lass Claude, Cursor oder einen beliebigen MCP-fähigen Client deine Flipbooks in natürlicher Sprache erstellen, konfigurieren, veröffentlichen und verwalten — mit eingebauten Schutzmechanismen für alles Destruktive.
Mit einem Copy-and-paste verbinden
Kopiere den Start-Prompt in Claude Code — er fügt den FlipLink-MCP-Server hinzu und überprüft ihn.
Ersetze YOUR_API_KEY durch deinen echten FlipLink-API-Key.
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.Funktioniert mit deinen KI-Tools
Claude
Cursor
ChatGPT
Codex
VS Code
Windsurf
Installation über npx fliplink-mcp · nutzt deinen eigenen API-Schlüssel · 87 Tools
So funktioniert's
Der FlipLink MCP-Server ist ein kleines Programm, das dein KI-Client auf deinem Rechner ausführt. Es stellt dieselbe FlipLink REST-API als MCP-Tools bereit, sodass der Assistent sie in natürlicher Sprache aufrufen kann. Es ist eine dritte Eingangstür zur selben API — ein Geschwister der CLI. An der API ändert sich nichts; dieser Server ist einfach ein weiterer Client, und alle Schutzmechanismen laufen lokal, bevor eine Anfrage deinen Rechner verlässt.
Installation
Du installierst nichts von Hand — dein KI-Client startet den Server mit npx. Du brauchst nur deinen eigenen FlipLink API-Schlüssel (siehe unten).
Claude Code
claude mcp add fliplink -e FLIPLINK_API_KEY=<YOUR_KEY> -- npx -y fliplink-mcpClaude Desktop · Cursor · Codex
Füge das in die MCP-Konfiguration des Clients ein (einen mcpServers-Block):
{
"mcpServers": {
"fliplink": {
"command": "npx",
"args": ["-y", "fliplink-mcp"],
"env": {
"FLIPLINK_API_KEY": "<YOUR_KEY_FROM_SUBSCRIPTION_PAGE>",
"FLIPLINK_MCP_MODE": "safe"
}
}
}
}Hol dir deinen API-Schlüssel
Jeder Nutzer stellt seinen eigenen Schlüssel bereit — wir füllen nie einen aus. Melde dich an und kopiere deinen Schlüssel von der Abo-Seite, dann füge ihn in die obige Konfiguration als FLIPLINK_API_KEY ein.
Fehlt der Schlüssel, gibt jedes Tool klare Anweisungen zum Hinzufügen zurück — so kann dich der Assistent durch die Einrichtung führen, bevor du irgendeine Doku liest.
Starter-Prompt
Füge das in eine neue KI-Sitzung ein, um einen sicheren Workflow aufzusetzen:
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 sind nach Risiko gestaffelt, und ein Modus entscheidet, welche Stufen freigegeben werden. Setze FLIPLINK_MCP_MODE in der Konfiguration (Standard ist safe).
| Modus | Gibt frei | Hinweise |
|---|---|---|
| readonly | Nur Lesezugriffe (19 Tools) | whoami, Listen, Abfragen |
| safe (Standard) | Lesezugriffe + reversible Schreibvorgänge + Zugriffssteuerung (79 Tools) | Keine Lösch- oder Commerce-Tools |
| full | Alles (87 Tools) | Lösch- + Commerce-Tools erfordern eine Bestätigung |
Neu bei diesen Begriffen? Sieh dir an, was eine API ist und Automatisierung.
Sicherheitsmodell
Im full-Modus werden destruktive Tools (Löschen) und Geld-Tools (Verkauf / Preisgestaltung) beim ersten Aufruf nie ausgeführt. Der Server gibt eine einzeilige Vorschau und ein kurzlebiges confirm_token zurück; der Assistent muss dir die Vorschau zeigen und mit diesem Token erneut aufrufen. Das Token ist an die genauen Argumente gebunden und läuft nach 5 Minuten ab. Dieser Schutz liegt im Server — die FlipLink API bekommt ihn nie zu sehen.
Jedes Tool trägt außerdem MCP-Annotationen (readOnlyHint, destructiveHint, idempotentHint), sodass Clients ihre eigenen Bestätigungsaufforderungen anzeigen können.
Tools
Tools werden aus der API-Spezifikation generiert und nach dem Schema <noun>_<verb> benannt — zum Beispiel flipbook_publish, flipbook_set_skin, leads_list, cname_add. Das eine übergeordnete Health-Check-Tool ist whoami. Die vollständige Parameterreferenz zu jedem zugrunde liegenden Endpunkt findest du in der REST-API-Doku.
Häufige Fragen
- Was ist ein MCP-Server?
Ein MCP-Server (Model Context Protocol) ist ein kleines Programm, das dein KI-Client lokal ausführt und dem Assistenten Werkzeuge bereitstellt. Der Server von FlipLink stellt dieselbe FlipLink REST API als Werkzeuge bereit, sodass Claude, Cursor oder jeder andere MCP-Client Flipbooks in natürlicher Sprache erstellen, konfigurieren und veröffentlichen kann.
- Welche KI-Clients werden unterstützt?
Jeder MCP-fähige Client – darunter Claude Code, Claude Desktop, Cursor und Codex. Du fügst FlipLink in der
mcpServers-Konfiguration des Clients hinzu, und dieser startet den Server bei Bedarf mitnpx fliplink-mcp.- Was sind die Modi readonly, safe und full?
Die Modi legen fest, welche Werkzeuge bereitgestellt werden.
readonlystellt 19 reine Lese-Werkzeuge bereit;safe(die Standardeinstellung) ergänzt umkehrbare Schreibvorgänge und Zugriffssteuerung für 79 Werkzeuge;fullstellt alle 87 bereit, wobei Lösch- und Verkaufswerkzeuge hinter einem Bestätigungsschritt abgesichert sind. Den Modus legst du mitFLIPLINK_MCP_MODEfest.- Ist es sicher, eine KI meine Flipbooks verwalten zu lassen?
Ja. Im Modus full werden destruktive Aktionen (Löschen) und Geldaktionen (Verkauf / Preisgestaltung) niemals beim ersten Aufruf ausgeführt – der Server gibt eine einzeilige Vorschau und ein kurzlebiges Bestätigungs-Token zurück, das an die genauen Argumente gebunden ist, und der Assistent muss bestätigen, bevor etwas geschieht. Die Schutzmechanismen laufen lokal; die FlipLink API bleibt unverändert.
- Brauche ich meinen eigenen API-Schlüssel?
Ja – jede Nutzerin und jeder Nutzer stellt den eigenen Schlüssel von der FlipLink-Abo-Seite bereit und legt ihn als
FLIPLINK_API_KEYin der Konfiguration fest. Fehlt der Schlüssel, gibt jedes Werkzeug eine klare Einrichtungsanleitung zurück, damit der Assistent dich Schritt für Schritt anleiten kann.