FlipLink in Cursor und anderen MCP-Clients nutzen

Wenn du ohnehin in Cursor lebst, musst du deinen Editor nicht verlassen, um mit FlipLink zu arbeiten. Wenn du den FlipLink-MCP-Server hinzufügst, kann die integrierte KI von Cursor Flipbooks erstellen, veröffentlichen, Leads abrufen und vieles mehr — einfach indem du es in normaler Sprache anfragst. Dieselbe Konfiguration funktioniert in Claude Desktop, Codex und jedem anderen Tool, das das Model Context Protocol spricht.

Diese Anleitung führt durch die Einrichtung in Cursor und zeigt dir anschließend die generische Konfiguration, die in jedem MCP-Client funktioniert.

Was ein MCP-Client ist

Ein MCP-Client ist jede Anwendung, die sich mit MCP-Servern verbinden und ihrer KI die von diesen Servern bereitgestellten Tools zur Verfügung stellen kann. Cursor, Claude Desktop und Codex sind allesamt MCP-Clients. Das Model Context Protocol ist der offene Standard, der ihnen erlaubt, mit einem Server wie fliplink-mcp zu kommunizieren — ganz ohne eigenen Verbindungscode.

Wenn du den FlipLink-MCP-Server verbindest, startet der Client ihn im Hintergrund und die KI erhält eine Reihe von FlipLink-Tools — etwa flipbook_create_by_file, flipbook_publish und leads_list. Neu beim Thema? Beginne mit was ein MCP-Server ist und komm dann hierher zurück.

Wo Cursors MCP-Konfiguration liegt

Cursor verwaltet MCP-Server über seine Einstellungen. Öffne die Einstellungen von Cursor, suche den Bereich MCP / Model Context Protocol und wähle die Option, einen neuen MCP-Server hinzuzufügen. Cursor erlaubt es dir, eine Server-Definition als JSON einzufügen — dieselbe mcpServers-Struktur, die jeder MCP-Client verwendet.

Du installierst nichts von Hand. Der Client startet den Server bei Bedarf mit npx, daher sind die einzigen Voraussetzungen Node.js 18+ und ein FlipLink-API-Schlüssel. Hol dir einen Schlüssel, indem du dich unter go.fliplink.me anmeldest und die Seite Subscription öffnest.

Der FlipLink-Server-Block

Füge in den MCP-Einstellungen von Cursor einen MCP-Server mit diesem mcpServers-Eintrag hinzu. Ersetze <YOUR_KEY> durch deinen FlipLink-API-Schlüssel:

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

Ein paar Hinweise zu diesem Block:

• command + args sagen dem Client, dass er den Server mit npx starten soll — keine globale Installation nötig.
• FLIPLINK_API_KEY authentifiziert jeden Aufruf. Behandle ihn wie ein Passwort und halte ihn aus geteilten Repositorys heraus.
• FLIPLINK_MCP_MODE steuert, wie viele Tools bereitgestellt werden. safe (die Standardeinstellung) erlaubt Lesezugriffe sowie umkehrbare Schreibvorgänge und Zugriffssteuerungen — keine Löschungen oder Handelsaktionen. Verwende readonly für einen Schauen-aber-nicht-anfassen-Modus oder full für alles. Siehe MCP-Sicherheitsmodi für die vollständige Aufschlüsselung.

Starte Cursor nach dem Speichern neu (oder lade den MCP-Server in den Einstellungen neu), damit der neue Eintrag übernommen wird.

Teste es: Bitte Cursor, whoami aufzurufen

Am schnellsten bestätigst du, dass die Verbindung funktioniert, mit dem Health-Check-Tool. Frage im Chat von Cursor:

Nutze das FlipLink-MCP und rufe whoami auf.

Das Tool whoami ist die Kontoprüfung auf oberster Ebene. Wenn dein Schlüssel gültig ist, erhältst du deine Konto-Identität und deine maximale Upload-Größe zurück. Fehlt der Schlüssel oder ist er falsch, gibt das Tool statt einer kryptischen Fehlermeldung klare Einrichtungsanweisungen zurück — das ist dein Zeichen, den Wert von FLIPLINK_API_KEY zu korrigieren und neu zu starten.

Sobald whoami funktioniert, probiere etwas Echtes aus:

Erstelle aus ./deck.pdf ein Flipbook mit dem Titel "Q3 Report" und gib mir dann den Freigabe-Link.

Cursors KI ruft flipbook_create_by_file und flipbook_get_share_link für dich auf — keine manuellen API-Aufrufe nötig.

🚀

FlipLink kostenlos testen

Wandle dein PDF in Sekunden um. Keine Anmeldung, keine Kreditkarte — einfach hochladen und loslegen.

Drop your PDF here or click to browse

Max. 40 MB

Bezahlte Tarife ab $39 erhöhen das auf 150 MB.

Andere Clients nutzen dieselbe Konfiguration

Das Schöne an MCP ist, dass die Konfiguration generisch ist. Der genaue mcpServers-Block oben funktioniert in Claude Desktop, Codex und jedem anderen MCP-Client — nur das Menü, in das du ihn einfügst, unterscheidet sich. Suche in jedem Client die MCP- oder Model-Context-Protocol-Einstellungen und füge einen Server mit derselben JSON-Struktur hinzu.

Wenn dein Client eine stdio-Transportoption anbietet, ist das die richtige Wahl: fliplink-mcp kommuniziert über stdio, was genau das ist, was command + args einrichten. Am Transport ist nichts FlipLink-Spezifisches — es ist die Standard-stdio-Konfiguration, die jeder MCP-Server verwendet.

Speziell für Claude Code kannst du das JSON komplett überspringen und einen einzigen Befehl ausführen:

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

Eine eigene Schritt-für-Schritt-Anleitung für diesen Client findest du unter FlipLink mit Claude über MCP verbinden.

Troubleshooting-FAQ

F: Der FlipLink-Server taucht nicht in Cursor auf. Was nun? A: Bestätige zuerst, dass Node.js 18+ installiert ist (node --version), denn npx braucht es. Überprüfe dann noch einmal, ob das JSON gültig ist — ein fehlendes Komma oder eine fehlende Klammer lässt den Server stillschweigend wegfallen. Starte schließlich den Client vollständig neu, damit er die Konfiguration erneut einliest.

F: Tools erscheinen, aber jeder Aufruf schlägt mit einer Einrichtungsmeldung fehl. A: Das bedeutet, dass der API-Schlüssel den Server nicht erreicht. Stelle sicher, dass FLIPLINK_API_KEY im env-Block gesetzt ist und dass der Wert dein echter Schlüssel von der Seite Subscription ist. Speichere und starte nach dem Bearbeiten neu.

F: Warum kann die KI kein Flipbook löschen oder eine Verkaufsaktion ausführen? A: Du bist im Modus safe, der destruktive und Handels-Tools bewusst ausblendet. Stelle FLIPLINK_MCP_MODE auf full, um sie zu aktivieren — beachte aber, dass Lösch- und Geldaktionen vor der Ausführung weiterhin einen Bestätigungsschritt erfordern. Siehe MCP-Sicherheitsmodi.

Fazit

FlipLink zu Cursor hinzuzufügen erfordert einen JSON-Block und einen Neustart. Sobald alles verdrahtet ist, übernimmt die KI deines Editors die Flipbook-Erstellung, Veröffentlichung und Lead-Exporte über natürliche Sprache — und dieselbe Konfiguration passt direkt in jeden anderen MCP-Client, den du verwendest.

Weiterführende Lektüre

• Der FlipLink-MCP-Server — vollständige Tool-Liste, Modi und Sicherheitsdetails
• Was ist ein MCP-Server?
• FlipLink mit Claude über MCP verbinden
• MCP-Sicherheitsmodi (readonly / safe / full)
• FlipLink-CLI-Dokumentation
• API-Referenz