Cos'è un server MCP?

Un server MCP (Model Context Protocol) è un piccolo programma che il tuo client AI esegue in locale e che espone strumenti all'assistente. Il server di FlipLink espone la stessa API REST di FlipLink sotto forma di strumenti, così Claude, Cursor o qualsiasi client MCP possono creare, configurare e pubblicare flipbook in linguaggio naturale.

Quali client AI sono supportati?

Qualsiasi client compatibile con MCP — tra cui Claude Code, Claude Desktop, Cursor e Codex. Basta aggiungere FlipLink alla configurazione mcpServers del client e questo avvia il server quando serve con npx fliplink-mcp.

Cosa sono le modalità readonly, safe e full?

Le modalità decidono quali strumenti vengono esposti. readonly espone 19 strumenti di sola lettura; safe (quella predefinita) aggiunge scritture reversibili e il controllo degli accessi, per un totale di 79 strumenti; full espone tutti gli 87, con gli strumenti di eliminazione e di vendita protetti da un passaggio di conferma. Imposta la modalità con FLIPLINK_MCP_MODE.

È sicuro lasciare che un'AI gestisca i miei flipbook?

Sì. In modalità full, le azioni distruttive (eliminazione) e quelle legate al denaro (vendita / prezzi) non vengono mai eseguite alla prima chiamata: il server restituisce un'anteprima di una riga e un token di conferma a breve scadenza, legato agli argomenti esatti, e l'assistente deve confermare prima che accada qualcosa. Le protezioni girano in locale; l'API di FlipLink resta invariata.

Mi serve una mia API key?

Sì — ogni utente fornisce la propria chiave dalla pagina di abbonamento di FlipLink, impostandola come FLIPLINK_API_KEY nella configurazione. Se la chiave manca, ogni strumento restituisce istruzioni di configurazione chiare, così l'assistente può guidarti passo dopo passo.

Model Context Protocol

Server MCP di FlipLink

Gestisci FlipLink dal tuo assistente AI. Lascia che Claude, Cursor o qualsiasi client compatibile con MCP crei, configuri, pubblichi e gestisca i tuoi flipbook in linguaggio naturale — con protezioni integrate su tutto ciò che è distruttivo.

Inizia ora Vedi l'API REST

Collega tutto con un copia-incolla

Copia il prompt iniziale in Claude Code: aggiunge il server MCP di FlipLink e lo verifica.

Modalità

Sostituisci YOUR_API_KEY con la tua chiave API di FlipLink.

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.

Ottieni la tua chiave API

Funziona con i tuoi strumenti AI

Claude
Cursor
ChatGPT
Codex
VS Code
Windsurf

Si installa con npx fliplink-mcp · usa la tua chiave API · 87 strumenti

Come funziona

Il server MCP di FlipLink è un piccolo programma che il tuo client AI esegue sul tuo computer. Espone come strumenti MCP la stessa API REST di FlipLink, così l'assistente può richiamarli in linguaggio naturale. È una terza porta d'accesso alla stessa API — fratello della CLI. L'API non cambia in nulla: questo server è semplicemente un altro client, e tutte le protezioni vengono eseguite in locale prima che qualsiasi richiesta lasci il tuo computer.

Installazione

Non devi installare nulla a mano — è il tuo client AI ad avviare il server con npx. Ti serve soltanto la tua chiave API di FlipLink (vedi sotto).

Claude Code

terminale

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

Claude Desktop · Cursor · Codex

Aggiungi questo alla configurazione MCP del client (un blocco mcpServers):

configurazione mcp

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

Ottieni la tua chiave API

Ogni utente usa la propria chiave — non ne precompiliamo mai una. Accedi e copia la tua chiave dalla pagina dell'abbonamento, poi incollala nella configurazione qui sopra come FLIPLINK_API_KEY.

Ottieni la tua chiave →

Se la chiave manca, ogni strumento restituisce istruzioni chiare per aggiungerla — così l'assistente può guidarti nella configurazione prima ancora di leggere la documentazione.

Prompt iniziale

Incolla questo in una nuova sessione AI per avviare un flusso di lavoro sicuro:

prompt

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>

Modalità

Gli strumenti sono suddivisi in livelli in base al rischio, e una modalità decide quali livelli vengono esposti. Imposta FLIPLINK_MCP_MODE nella configurazione (il valore predefinito è safe).

Modalità	Espone	Note
readonly	Solo letture (19 strumenti)	whoami, elenchi, ricerche
safe (predefinita)	Letture + scritture reversibili + controllo accessi (79 strumenti)	Nessuno strumento di eliminazione o di vendita
full	Tutto (87 strumenti)	Gli strumenti di eliminazione e di vendita richiedono conferma

Nuovo a questi termini? Scopri cos'è un'API e l'automazione.

Modello di sicurezza

In modalità full, gli strumenti distruttivi (eliminazione) e quelli legati al denaro (vendita / prezzi) non vengono mai eseguiti alla prima chiamata. Il server restituisce un'anteprima di una riga e un confirm_token di breve durata; l'assistente deve mostrarti l'anteprima e richiamarlo di nuovo con quel token. Il token è vincolato agli argomenti esatti e scade dopo 5 minuti. Questo controllo vive nel server — l'API di FlipLink non lo vede mai.

Ogni strumento porta con sé anche annotazioni MCP (readOnlyHint, destructiveHint, idempotentHint), così i client possono mostrare le proprie richieste di conferma.

Strumenti

Gli strumenti sono generati dalla specifica dell'API e seguono lo schema <noun>_<verb> — per esempio flipbook_publish, flipbook_set_skin, leads_list, cname_add. L'unico strumento di controllo di livello superiore è whoami. Per il riferimento completo dei parametri di ogni endpoint sottostante, consulta la documentazione dell'API REST.

Domande frequenti

Cos'è un server MCP?: Un server MCP (Model Context Protocol) è un piccolo programma che il tuo client AI esegue in locale e che espone strumenti all'assistente. Il server di FlipLink espone la stessa API REST di FlipLink sotto forma di strumenti, così Claude, Cursor o qualsiasi client MCP possono creare, configurare e pubblicare flipbook in linguaggio naturale.
Quali client AI sono supportati?: Qualsiasi client compatibile con MCP — tra cui Claude Code, Claude Desktop, Cursor e Codex. Basta aggiungere FlipLink alla configurazione mcpServers del client e questo avvia il server quando serve con npx fliplink-mcp.
Cosa sono le modalità readonly, safe e full?: Le modalità decidono quali strumenti vengono esposti. readonly espone 19 strumenti di sola lettura; safe (quella predefinita) aggiunge scritture reversibili e il controllo degli accessi, per un totale di 79 strumenti; full espone tutti gli 87, con gli strumenti di eliminazione e di vendita protetti da un passaggio di conferma. Imposta la modalità con FLIPLINK_MCP_MODE.
È sicuro lasciare che un'AI gestisca i miei flipbook?: Sì. In modalità full, le azioni distruttive (eliminazione) e quelle legate al denaro (vendita / prezzi) non vengono mai eseguite alla prima chiamata: il server restituisce un'anteprima di una riga e un token di conferma a breve scadenza, legato agli argomenti esatti, e l'assistente deve confermare prima che accada qualcosa. Le protezioni girano in locale; l'API di FlipLink resta invariata.
Mi serve una mia API key?: Sì — ogni utente fornisce la propria chiave dalla pagina di abbonamento di FlipLink, impostandola come FLIPLINK_API_KEY nella configurazione. Se la chiave manca, ogni strumento restituisce istruzioni di configurazione chiare, così l'assistente può guidarti passo dopo passo.

Continua a sviluppare

Riferimento API RESTIl riferimento completo degli endpoint che il server MCP avvolge.Strumento da riga di comandoLa stessa API come CLI scriptabile per terminali e CI.Panoramica dell'accesso APICosa fa l'accesso per sviluppatori di FlipLink e a chi è rivolto.Collega FlipLink a ClaudeUna guida passo passo alla configurazione di MCP per Claude e altri client.