FlipLink CLI, API o MCP: quale integrazione conviene usare?

FlipLink ti offre tre modi per automatizzare i flipbook senza toccare il pannello di controllo: uno strumento da riga di comando, un'API REST e un server MCP per gli assistenti AI. Sembrano tre prodotti diversi, ma non lo sono. Sono tre porte d'ingresso allo stesso motore — gli stessi endpoint, gli stessi dati, lo stesso account.

Quindi la vera domanda non è “qual è il migliore?”. È “quale si adatta a ciò che stai facendo proprio ora?”. Questa guida ti offre un confronto neutrale e una rapida regola del “scegline uno”.

Tre porte d'ingresso, una sola API

Tutto ciò che FlipLink può fare a livello programmatico passa attraverso un'unica API REST su https://go.fliplink.me, autenticata con un header X-Api-Key. La CLI e il server MCP sono entrambi costruiti direttamente sopra quella stessa API — anzi, l'elenco dei comandi della CLI e l'elenco degli strumenti MCP vengono generati dalla stessa specifica degli endpoint, quindi non possono andare fuori sincrono.

Questo ha una conseguenza utile: qualunque cosa tu possa fare in uno, puoi farla in tutti e tre. Le differenze riguardano chi è alla guida e quanto codice vuoi scrivere — non le funzionalità.

Matrice decisionale

Tutti e tre condividono lo stesso modello di risposta: ogni risposta è in JSON con un Result di primo livello pari a "OK" o "ERROR", e lo stesso limite di 300 richieste al minuto per chiave.

Quando scegliere ciascuna

CLI — per script, terminali e CI/CD

Usa la CLI quando vivi in un terminale o in una pipeline. È il percorso più rapido da “ho un PDF” a “ho un flipbook pubblicato” senza scrivere un client HTTP. Inseriscila in uno script di shell, in un cron job o in uno step di GitHub Actions e ottieni un'automazione ripetibile. Aggiungi --json a qualsiasi comando e mandala in pipe a jq per scriptare. Vedi come iniziare con la CLI.

API — per le applicazioni

Usa l'API quando FlipLink è una funzionalità all'interno di qualcosa che stai costruendo — un portale clienti che genera flipbook al momento della registrazione, una dashboard che recupera i dati di acquisizione contatti o una sincronizzazione con il CRM. Hai il controllo completo e puoi richiamarla da qualsiasi linguaggio che parli HTTP. Il riferimento API elenca ogni endpoint con una console Try-It dal vivo.

MCP — per gli assistenti AI e chi non programma

Usa il server MCP quando la persona (o l'agente) che svolge il lavoro non dovrebbe nemmeno sapere che esiste un endpoint. Collega FlipLink a Claude, Cursor o un altro client MCP e puoi dire “pubblica il deck del Q3 e dammi il link di condivisione” in linguaggio semplice. L'assistente sceglie lo strumento giusto e compila i parametri. È l'opzione con meno attriti per chi non programma — e arriva con protezioni di sicurezza che richiedono prima una conferma per le azioni distruttive.

🚀

Prova FlipLink Gratis

Converti il tuo PDF in pochi secondi. Senza registrazione, senza carta di credito — basta caricare il file.

Drop your PDF here or click to browse

Max 40MB

I piani a pagamento da $39 portano questo limite a 150 MB.

Puoi combinarli

Non si escludono a vicenda. Una configurazione comune li usa tutti e tre: l'API alimenta la tua app in produzione, la CLI esegue i batch notturni in CI e il server MCP permette al tuo team di creare flipbook estemporanei chiedendolo a un assistente AI. Stesso account, stessi flipbook, stessi dati — solo porte diverse per momenti diversi.

Lo stesso compito, in tre modi

Ecco esattamente lo stesso risultato — creare un flipbook da un PDF — attraverso ciascuna porta.

CLI — un solo comando nel tuo terminale:

fliplink flipbook create ./q3-report.pdf --title "Q3 Report" --name q3

API — una richiesta HTTP che fai dal codice:

curl -X POST 'https://go.fliplink.me/api/create-by-file' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'File=@q3-report.pdf' \
  -F 'Name=q3' \
  -F 'Title=Q3 Report'

MCP — linguaggio naturale nel tuo client AI:

“Crea un flipbook da q3-report.pdf intitolato ‘Q3 Report’.”

Dietro le quinte l'assistente richiama lo strumento flipbook_create_by_file con gli stessi parametri della richiesta curl qui sopra. Tutti e tre restituiscono lo stesso JSON — {"Result":"OK","ID":"90001","URL":"https://go.fliplink.me/view/<slug>", ...} — perché tutti e tre colpiscono lo stesso endpoint.

Guida rapida "scegline uno"

• Stai scrivendo uno script o una pipeline CI/CD? → CLI
• Stai integrando i flipbook nella tua app? → API
• Vuoi che lo faccia un assistente AI o chi non programma? → MCP
• Non sei sicuro? Parti dalla CLI — è il modo più rapido per vedere i risultati, e ciò che impari si trasferisce direttamente sull'API.

Qualunque porta tu attraversi, stai usando lo stesso motore FlipLink. Scegli quella che corrisponde al tuo modo di lavorare oggi — puoi sempre aggiungerne un'altra in seguito.

Letture correlate

• Come iniziare con la FlipLink CLI
• Collega FlipLink a Claude con un server MCP
• Che cos'è un server MCP?
• Come usare l'API di FlipLink per integrazioni personalizzate
• Automazione e integrazioni
• Accesso API