Come collegare FlipLink a Claude con il server MCP

E se potessi semplicemente chiedere a Claude di — “trasforma questo PDF in un flipbook e pubblicalo” — e lui lo facesse davvero? È esattamente ciò che rende possibile il server MCP Claude di FlipLink. Una volta collegato, Claude può creare, elencare, pubblicare e gestire i tuoi flipbook attraverso una conversazione naturale, senza bisogno di cliccare nella dashboard.

Questa guida ti accompagna in tutta la configurazione — meno di cinque minuti dall'inizio alla prima attività.

Cosa ti serve

Prima di collegare qualsiasi cosa, assicurati di avere:

• Node.js 18 o più recente — il server gira tramite npx, quindi Node è l'unica dipendenza di runtime. (Non installi il server a mano; è il tuo client AI a lanciarlo all'occorrenza.)
• Una chiave API di FlipLink — accedi su go.fliplink.me e prendi la tua chiave dalla pagina Subscription. Questa chiave autentica ogni azione che Claude compie, quindi trattala come una password.

Tutto qui. Se non hai mai usato un server Model Context Protocol, vale la pena dedicare due minuti a questa lettura: cos'è un server MCP.

Collega FlipLink a Claude Code (un solo comando)

Se usi Claude Code, l'intera configurazione si riduce a un solo comando. Inserisci la tua chiave ed esegui:

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

Così registri FlipLink come server MCP, passi la tua chiave API come variabile d'ambiente e dici a Claude di lanciare il server tramite npx ogni volta che ne ha bisogno. Il flag -y consente a npx di scaricare il pacchetto senza prompt interattivo. Riavvia la sessione di Claude Code e gli strumenti di FlipLink diventano disponibili.

Collega Claude Desktop (blocco di configurazione)

Claude Desktop (e altri client come Cursor o Codex) usano invece una configurazione JSON. Aggiungi una voce mcpServers come questa:

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

Sostituisci <YOUR_KEY> con la tua chiave reale, salva la configurazione e riavvia il client. Al lancio successivo, gli strumenti di FlipLink si caricano automaticamente. Il valore FLIPLINK_MCP_MODE definisce quali azioni sono consentite — ne parliamo meglio più avanti.

Verifica la connessione

Prima di chiedere a Claude di fare un lavoro vero, conferma che tutto sia collegato. Il controllo più semplice è lo strumento di diagnostica di primo livello, whoami. Basta chiedere a Claude:

“Esegui lo strumento whoami di FlipLink.”

Claude chiama lo strumento e restituisce l'identità del tuo account e la dimensione massima di caricamento. Se la tua chiave manca o è errata, il server risponde invece con istruzioni di configurazione chiare — così un errore confuso diventa un errore risolvibile.

🚀

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.

Com'è fatta una chiamata a uno strumento

Non digiti mai il nome di uno strumento. Descrivi ciò che vuoi in linguaggio naturale e Claude sceglie lo strumento giusto, compila gli argomenti e lo esegue. Gli strumenti di FlipLink sono generati direttamente dalle specifiche dell'API e seguono lo schema <noun>_<verb> — così, mentre Claude lavora, vedrai passare chiamate come flipbook_create_by_file, flipbook_publish, flipbook_set_skin o leads_list.

Dietro le quinte, ogni strumento corrisponde a un vero endpoint dell'API di FlipLink. Se vuoi vedere la struttura delle richieste sottostanti, i parametri e una console Try-It dal vivo, il riferimento API completo li documenta tutti — ed è anche da lì che ottieni la tua chiave API.

La tua prima attività

Ora viene il bello. Passa a Claude un PDF e chiedi:

“Crea un flipbook da questo PDF e chiamalo Report Q3.”

Claude chiama flipbook_create_by_file, carica il file e restituisce l'ID del nuovo flipbook e l'URL di condivisione. Da lì puoi continuare nella stessa conversazione:

“Ora pubblicalo e dammi il link di condivisione.”

Claude concatena flipbook_publish e flipbook_get_share_link e restituisce un link che puoi inviare subito. Niente cambio di schede, niente passaggi manuali — solo una conversazione che produce flipbook veri e pubblicati. Per un quadro più ampio di ciò che questo ti permette di fare, leggi l'automazione dei flipbook in linguaggio naturale.

Due parole sulle modalità (sicura per impostazione predefinita)

Il server MCP integra una protezione che è bene conoscere: l'impostazione FLIPLINK_MCP_MODE controlla quali strumenti può raggiungere Claude.

• readonly — 19 strumenti, sola lettura. Claude può elencare e ispezionare, ma non modifica mai nulla.
• safe — 79 strumenti, ed è il valore predefinito. Letture più scritture reversibili e controllo degli accessi; nessuna eliminazione, nessuna azione commerciale. È il punto di partenza giusto per quasi tutti.
• full — tutti gli 87 strumenti, comprese le azioni distruttive e quelle legate al denaro.

Anche in modalità full c'è una seconda rete di sicurezza: gli strumenti di eliminazione e di vendita/prezzo non vengono mai eseguiti alla prima chiamata. Il server restituisce un'anteprima di una riga più un token di conferma a breve durata (legato a quegli esatti argomenti e con scadenza dopo cinque minuti), e Claude deve mostrarti l'anteprima e richiamare lo strumento con il token prima che accada qualcosa di irreversibile. Se vuoi il quadro completo di come funzionano queste protezioni, leggi le protezioni di sicurezza del server MCP.

Inizia a parlare con i tuoi flipbook

Collegare FlipLink a Claude trasforma la gestione dei flipbook in una conversazione. Un comando (o un blocco di configurazione), un rapido controllo con whoami e già chiedi a Claude di creare e pubblicare flipbook al posto tuo — in sicurezza, con la modalità safe che ti protegge fin da subito.

Pronto a partire? Prendi la tua chiave dalla pagina Subscription, esegui il comando di configurazione e chiedi a Claude di creare il suo primo flipbook.

Letture correlate

• Panoramica del server MCP di FlipLink
• Cos'è un server MCP?
• Protezioni di sicurezza del server MCP (readonly / safe / full)
• Automazione dei flipbook in linguaggio naturale
• Funzionalità API Access
• Riferimento della CLI di FlipLink