Bouw een AI-agent die flipbooks maakt

Wat als “publiceer het rapport van deze maand als flipbook” iets was wat je computer zelf deed — geen dashboard, geen upload, geen deellink die je in een e-mail plakt? Dat is de belofte van een AI-agent voor documenten: jij beschrijft het resultaat en de agent roept de juiste tools in de juiste volgorde aan om het voor elkaar te krijgen.

Deze tutorial laat zien hoe je er een bouwt met de FlipLink MCP-server en Claude. De agent neemt een vers gegenereerd PDF-rapport, maakt er een flipbook van, publiceert het en geeft een deellink terug — precies het soort taak dat je op een schema kunt zetten en kunt vergeten. We zijn ook eerlijk over waar een volledig onbemande agent tegen echte grenzen aanloopt, en wanneer een gewoon script (de CLI) de betere keuze is.

Het scenario: een automatisch gepubliceerd maandrapport

Stel je een terugkerende taak voor. Op de eerste van elke maand levert een pipeline een report.pdf op — verkoopcijfers, een nieuwsbrief, een board deck. Vandaag uploadt een mens dat naar het dashboard, publiceert het, kopieert de link en plakt die ergens. Dat willen we automatiseren met een agent die over de stappen kan redeneren in plaats van dat wij elke stap vastleggen.

De agent moet het volgende kunnen: een flipbook van het bestand maken, het publiceren en de deellink ophalen. Met de FlipLink MCP-server verbonden komen die overeen met echte tools die het model direct kan aanroepen.

Stap 1 — Sluit de MCP-server aan

Het Model Context Protocol is hoe een AI-client (Claude, Cursor en andere) externe tools ontdekt en aanroept. De FlipLink MCP-server stelt de FlipLink API beschikbaar als een set tools die het model in een gesprek kan gebruiken.

Voor de volledige uitleg, zie Verbind FlipLink met Claude via de MCP-server. De korte versie — niets om met de hand te installeren, je client start hem met npx:

claude mcp add fliplink -e FLIPLINK_API_KEY=YOUR_API_KEY -- npx -y fliplink-mcp

Of, als een mcpServers-configblok (Claude Desktop, Cursor, Codex):

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

Tools worden gegenereerd uit de FlipLink-spec en krijgen de naam <noun>_<verb> — dus de agent ziet onder andere flipbook_create_by_file, flipbook_publish, flipbook_get_share_link en een whoami healthcheck op hoofdniveau. Haal je sleutel op door in te loggen op go.fliplink.me.

Stap 2 — Schrijf de agent-prompt

Een agent is eigenlijk gewoon een model plus een lus: hij leest het doel, beslist welke tool hij aanroept, leest het resultaat en beslist wat hij vervolgens doet, totdat het doel is bereikt. De kwaliteit van die lus komt bijna volledig voort uit een heldere prompt die de tools, de volgorde en de slaagvoorwaarde benoemt.

Hier is een realistische system/task-prompt voor de maandrapport-agent:

SYSTEM:
You are a publishing agent for FlipLink. Your job is to turn a PDF report
into a published flipbook and return its share link. You have FlipLink MCP
tools available (names follow the pattern noun_verb).

Operating rules:
1. Start by calling `whoami` to confirm the API key works and check the
   remaining flipbook quota. If `whoami` fails, STOP and report the error.
2. Create the flipbook from the file with `flipbook_create_by_file`
   (field File = the PDF path; set Name and Title from the task).
3. Read the result. Every FlipLink response has a top-level `Result` field
   that is "OK" or "ERROR". If `Result` is "ERROR", STOP and report the
   `Message` — do NOT retry blindly or proceed.
4. On success, capture the returned flipbook ID.
5. Publish it with `flipbook_publish` using that ID. Check `Result` again.
6. Fetch the share link with `flipbook_get_share_link`.
7. Report back: the flipbook ID, the published share URL, and the quota left.

Never invent tool names or IDs. If a step has no clear next action,
stop and explain rather than guessing.

TASK:
Publish this month's report. File: ./reports/2026-06-report.pdf
Title: "June 2026 Report". Name: "june-2026-report".

Twee dingen maken deze prompt effectief. Ten eerste vertelt hij de agent om op het Result-veld te vertakken — FlipLink geeft applicatiefouten terug als HTTP 200 met Result: "ERROR", dus een naïeve controle van “gaf de aanroep 200 terug?” zou mislukkingen stilletjes als successen behandelen. Ten tweede geeft hij een expliciete stopvoorwaarde voor elk faalpad, wat voorkomt dat een onbemande run in herhaalpogingen blijft hangen.

Stap 3 — Vangrails voor onbemande runs

Hier moet je helder zijn. De standaard MCP-modus is safe (79 tools): leesacties plus omkeerbare schrijfacties, met geen delete en geen commerce-tools. Onze maandrapport-agent maakt, publiceert en leest alleen — allemaal acties die binnen de safe-modus passen — dus voor deze taak kun je de standaard laten staan en draait de agent van begin tot eind zonder gedoe.

Destructieve acties zijn een ander verhaal. Als je agent ooit een flipbook moet verwijderen of aan prijzen/verkoop moet komen, moet hij in de full-modus (87 tools) draaien. In de full-modus draaien delete- en geldtools nooit bij de eerste aanroep: de server geeft een preview van één regel terug plus een kortlevende confirm_token (gebonden aan de exacte argumenten, verloopt na 5 minuten), en de assistent moet opnieuw aanroepen met dat token. Die poort zit in de server — de FlipLink API zelf is ongewijzigd.

Wees eerlijk over wat dit betekent voor “volledig autonoom”:

• Een agent die leest, maakt en publiceert in de safe-modus kan onbemand netjes draaien. Niets wat hij doet, is via een poort beveiligd.
• Een agent die dingen verwijdert, kan niet tegelijk wrijvingsloos en onbemand zijn. De confirm-token-poort zit er met opzet. Of een mens keurt de destructieve stap goed, of je harness draait in de full-modus en handelt de preview → confirm-token → tweede-aanroep-handshake expliciet af in code. Ontwerp geen pipeline die ervan uitgaat dat een flipbook zichzelf stilletjes en zonder bevestiging verwijdert — dat gebeurt niet, en dat is precies de bedoeling.

Voor de volledige uitleg van de modi en de confirm-token-flow, zie Veiligheid en vangrails van de MCP-server. De tools dragen ook MCP-annotaties (readOnlyHint, destructiveHint, idempotentHint) zodat een zorgvuldige harness over het risico kan redeneren voordat hij iets aanroept.

🚀

Probeer FlipLink Gratis

Converteer je PDF in seconden. Geen registratie, geen creditcard — gewoon uploaden en starten.

Drop your PDF here or click to browse

Max. 40MB

Met een betaald abonnement vanaf $39 verhoog je dit naar 150 MB.

Stap 4 — Zet hem op een schema

Zodra de agent betrouwbaar met de hand draait, zet je hem op een timer. Hoe je dat doet, hangt af van je client — een cronjob die Claude headless aanroept met de task-prompt, een geplande workflow, of je eigen orkestratie. De technische details vallen buiten het bestek hier; het belangrijke is dat de prompt en de modus een geplande run veilig maken, niet de scheduler zelf. Houd de agent in de safe-modus voor maak-/publiceertaken, en de run blijft onbemand zonder tegen een bevestigingsmuur aan te lopen.

Stap 5 — Controleer de output

Vertrouw niet op “de agent zei dat het werkte.” Controleer het echte resultaat:

• Het eindrapport van de agent hoort een flipbook-ID en een deel-URL te bevatten. Open de URL — die hoort het gepubliceerde flipbook te laden.
• Doe een steekproef op de whoami-quota voor en na, zodat je weet dat het maken echt één slot heeft verbruikt en niet stilletjes is mislukt.
• Omdat elk toolresultaat een Result-veld bevat, brengt een goed gebouwde agent het exacte Message naar boven bij een mislukking. Als de run Result: "ERROR" meldt, lees dan het bericht in plaats van opnieuw te draaien — een quotalimiet of een te groot bestand lost zichzelf niet op bij een herhaalpoging.

Wanneer de CLI de betere keuze is

Hier is het eerlijke tegengeluid op al het bovenstaande: voor een headless, deterministische taak in CI wil je meestal helemaal geen LLM-agent.

Een AI-agent blinkt uit wanneer de taak om inschatting vraagt — beslissen hoe je iets noemt, reageren op dubbelzinnige invoer, of stappen aan elkaar rijgen die je niet volledig hebt uitgeschreven. Maar “neem dit exacte bestand, maak een flipbook, publiceer het, print de link” kent nul dubbelzinnigheid. Een LLM ervoor draaien voegt kosten, vertraging en non-determinisme toe zonder enig voordeel, en je moet alsnog hetzelfde vertakken op Result afhandelen.

Pak daarvoor de FlipLink CLI. Die is gegenereerd uit dezelfde spec als de MCP-server en de API, dus hij kan niet uit de pas lopen, en hij geeft schone exitcodes terug (0 succes, 1 requestfout, 2 applicatiefout) waarop CI kan vertakken zonder ook maar iets te hoeven parsen:

fliplink config set-key "$FLIPLINK_API_KEY"
ID=$(fliplink flipbook create ./reports/2026-06-report.pdf \
  --title "June 2026 Report" --name june-2026-report --json | jq -r '.ID')
fliplink flipbook publish "$ID"
fliplink flipbook share-link "$ID"

Dat is de hele maandtaak, geen model nodig. Voor een volledige pipeline — inclusief hem binnen continuous integration draaien — zie Automatiseer het publiceren van flipbooks in CI/CD.

Vuistregel: gebruik een AI-agent wanneer de taak inschatting vereist; gebruik de CLI wanneer de taak elke keer hetzelfde moet zijn. Veel teams draaien allebei — de agent voor ad-hocverzoeken als “publiceer dit even voor me”, de CLI voor de geplande, mechanische runs.

Begin met bouwen

Een AI-agent voor documenten haalt het handmatige middenstuk uit publiceren weg: jij benoemt het resultaat, hij roept de tools aan. Met FlipLink MCP in de safe-modus draait een maak-en-publiceer-agent van begin tot eind zonder gedoe — en waar destructieve acties in beeld komen, houdt de confirm-token-poort onbemande runs eerlijk in plaats van gevaarlijk.

Klaar? Sluit de MCP-server aan, richt een agent op een rapport en kijk hoe hij publiceert. Voor het deterministische CI-pad heeft de CLI-documentatie je gedekt. De volledige endpoint-catalogus vind je in de API-referentie.

Verder lezen

• Verbind FlipLink met Claude via de MCP-server
• Veiligheid en vangrails van de MCP-server
• Flipbook-automatisering in natuurlijke taal
• Automatiseer het publiceren van flipbooks in CI/CD
• De documentatie van de FlipLink CLI
• De FlipLink API-referentie