Integrazione assistente IA (MCP)

Collega Linkflare al tuo assistente IA preferito e gestisci i tuoi segnalibri con una conversazione naturale. Salva link, cerca nella tua libreria, organizza le raccolte, tutto senza uscire dalla chat.

Cos'è l'MCP?

Il Model Context Protocol (MCP) è uno standard aperto che permette agli assistenti IA di interagire con strumenti e dati esterni. Immaginalo come se conferissi alla tua IA una serie di superpoteri, in questo caso la capacità di leggere, scrivere e organizzare i tuoi segnalibri Linkflare.

Linkflare mette a disposizione un server MCP ospitato all'indirizzo https://mcp.linkflare.io/mcp, che funziona con qualsiasi client compatibile con MCP, tra cui Claude Desktop, ChatGPT, Cursor, Windsurf e altri.

Cosa puoi farci?

Una volta stabilita la connessione, puoi parlare con il tuo assistente IA in linguaggio naturale e questo interagirà con la tua libreria Linkflare per tuo conto. Ecco alcune cose che puoi dire:

Salvare segnalibri

• «Salva questo link nella mia raccolta Ricette: https://example.com/pasta-recipe"
• «Aggiungi https://arxiv.org/abs/2401.12345 e assegnagli i tag machine-learning e research"
• «Ecco un mucchio di link presi dai miei appunti, salvali tutti:" (incolla un blocco di testo con gli URL)

Cercare e trovare

• «Trova tutti i miei segnalibri sull'argomento TypeScript"
• «Mostrami i video con il tag scotland"
• «Quali ricette ho salvato di recente?"
• «Trova gli articoli che ho valutato con pollice in su"
• «Cerca nelle mie schede di conoscenza ripetizione dilazionata"

Organizzare

• «Sposta i link 42 e 43 nella mia raccolta Lavoro"
• «Crea una nuova raccolta chiamata Viaggio in Giappone"
• «Crea un tag chiamato must-read"
• «Cosa c'è nella mia Inbox? Aiutami a organizzarla."

Catturare la conoscenza Pro

Le schede di conoscenza sono note gerarchiche con contenuto ricco, tag e ripetizione dilazionata opzionale. Gli strumenti di conoscenza richiedono un piano Pro.

• «Crea una scheda di conoscenza dal titolo React Server Components con queste note: …"
• «Sotto Basi di cucina, aggiungi una scheda figlia per Tecniche con il coltello"
• «Aggiorna la scheda 42, aggiungi: funziona anche con gli async iterator"
• «Mostrami tutte le schede di conoscenza di primo livello"
• «Cosa so sui database vettoriali? Riassumi le mie schede."

Esempi pratici

Prerequisiti

1. Un account Linkflare: registrati qui se non ne hai ancora uno.
2. La tua chiave API: apri l'app Linkflare, clicca sul menu utente (in alto a destra) e seleziona Copia chiave API.
3. Un client IA che supporti i server MCP remoti (vedi le guide alla configurazione qui sotto).

Configurazione: Claude

Claude supporta connettori MCP remoti personalizzati in Claude, Claude Desktop e nei piani team compatibili. Aggiungi Linkflare come connettore web personalizzato.

Passo 1: aprire Connectors

Vai su Settings → Connectors e clicca su Add custom connector.

Passo 2: compilare i dettagli del connettore

• Name: linkflare
• Remote MCP server URL: https://mcp.linkflare.io/mcp

Passo 3: configurare OAuth (Advanced settings)

Apri Advanced settings e imposta:

• OAuth Client ID: linkflare-claude

Passo 4: autorizzare

Quando usi gli strumenti Linkflare per la prima volta in una conversazione, Claude apre una pagina di autorizzazione in cui incolli la tua chiave API Linkflare. Trovi la tua chiave API cliccando sul menu utente (in alto a destra) nell'app Linkflare e scegliendo Copia chiave API. Dopo l'autorizzazione, Claude ricorda la tua connessione.

Passo 5: provalo

Avvia una conversazione e di' qualcosa come:

• «Cosa c'è nella mia Inbox di Linkflare?"
• «Cerca nei miei segnalibri gli articoli sulla produttività"
• «Salva https://example.com nella mia Lista di lettura"

Claude chiede il permesso prima di usare uno strumento per la prima volta.

Configurazione: ChatGPT

ChatGPT supporta i server MCP remoti tramite le app di ChatGPT e il Developer Mode. Linkflare supporta l'autenticazione OAuth, così ChatGPT può connettersi in modo sicuro.

Passo 1: aprire le impostazioni di ChatGPT

Vai su Settings → Apps, poi scorri fino a Advanced settings e clicca su Create app.

Passo 2: creare una nuova app

Compila quanto segue:

• Name: Linkflare
• MCP Server URL: https://mcp.linkflare.io/mcp
• Authentication: OAuth

Se ChatGPT chiede ulteriori dettagli OAuth:

• Client ID: linkflare-chatgpt
• Client Secret: lascia vuoto

ChatGPT individua automaticamente gli endpoint di autorizzazione e dei token dal server MCP.

Passo 3: autorizzare

Quando usi gli strumenti Linkflare per la prima volta in una conversazione, ChatGPT apre una pagina di autorizzazione in cui incolli la tua chiave API Linkflare. Trovi la tua chiave API cliccando sul menu utente (in alto a destra) nell'app Linkflare e scegliendo Copia chiave API. Dopo l'autorizzazione, ChatGPT ricorda la tua connessione.

Passo 4: testare

Avvia una nuova conversazione e chiedi a ChatGPT di «elencare le mie raccolte Linkflare" per verificare che la connessione funzioni.

Configurazione: VS Code

Usa il file di configurazione MCP in VS Code. OAuth apre il browser alla prima connessione.

{
  "servers": {
    "linkflare": {
      "type": "http",
      "url": "https://mcp.linkflare.io/mcp",
      "oauth": {
        "clientId": "linkflare-vscode"
      }
    }
  }
}

Configurazione: Cursor

Aggiungi Linkflare a ~/.cursor/mcp.json o .cursor/mcp.json. Cursor usa un callback OAuth fisso e dati client OAuth statici.

{
  "mcpServers": {
    "linkflare": {
      "url": "https://mcp.linkflare.io/mcp",
      "auth": {
        "CLIENT_ID": "linkflare-cursor",
        "scopes": ["mcp"]
      }
    }
  }
}

Configurazione: Windsurf

Aggiungi Linkflare dal pannello di configurazione MCP o modifica ~/.codeium/windsurf/mcp_config.json. Se OAuth non è disponibile nella tua versione, usa il fallback con chiave API qui sotto.

{
  "mcpServers": {
    "linkflare": {
      "serverUrl": "https://mcp.linkflare.io/mcp"
    }
  }
}

{
  "mcpServers": {
    "linkflare": {
      "serverUrl": "https://mcp.linkflare.io/mcp",
      "headers": {
        "Authorization": "Bearer ${env:LINKFLARE_API_KEY}"
      }
    }
  }
}

Configurazione: Zed

Aggiungi Linkflare come server di contesto personalizzato in Zed. Quando non è configurato alcun header Authorization, Zed avvia il flusso OAuth MCP standard.

{
  "context_servers": {
    "linkflare": {
      "url": "https://mcp.linkflare.io/mcp"
    }
  }
}

Fallback legacy per versioni precedenti di Zed o client senza supporto nativo per MCP remoto:

{
  "context_servers": {
    "linkflare": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linkflare.io/mcp"]
    }
  }
}

Dettagli di connessione

Impostazione	Valore
URL endpoint	https://mcp.linkflare.io/mcp
Trasporto	Streamable HTTP
Autenticazione	Bearer token tramite l'header Authorization
Header di autenticazione	Authorization: Bearer YOUR_API_KEY

Alternativa: alcuni client usano invece un header x-api-key. Linkflare accetta entrambi.

Strumenti disponibili

Una volta stabilita la connessione, il tuo assistente IA avrà a disposizione i seguenti strumenti. Non devi memorizzarli: parla in modo naturale e l'IA sceglierà quello giusto.

Strumenti per i segnalibri

Strumento	Cosa fa
add_link	Salva un segnalibro, opzionalmente con raccolta, tag, note e tipo
add_links_from_text	Estrae e salva tutti gli URL da un blocco di testo incollato
search_links	Cerca tra i segnalibri con filtri (testo, raccolta, tag, tipo, Inbox, valutazione)
get_link	Recupera tutti i dettagli di un determinato segnalibro
update_link	Aggiorna titolo, note, tag o altre proprietà di un segnalibro
delete_link	Elimina un segnalibro
move_links	Sposta uno o più segnalibri in un'altra raccolta
rate_link	Valuta un segnalibro con pollice in su o in giù
get_inbox	Elenca tutti gli elementi della Inbox

Strumenti di organizzazione

Strumento	Cosa fa
list_collections	Visualizza tutte le tue raccolte come albero
create_collection	Crea una nuova raccolta
list_tags	Visualizza tutti i tuoi tag
create_tag	Crea un nuovo tag

Strumenti di conoscenza Pro

Le schede di conoscenza sono note rich-text gerarchiche (pensa a Notion / Obsidian) che possono essere collegate ai tuoi segnalibri e ripassate con la ripetizione dilazionata. Questi strumenti richiedono un piano Pro.

Strumento	Cosa fa
search_knowledge	Cerca tra le schede di conoscenza per parola chiave in titolo, contenuto e tag
add_knowledge	Crea una nuova scheda di conoscenza, opzionalmente con contenuto, tag, scheda principale e colore
get_knowledge	Recupera una scheda tramite ID con il suo contenuto completo e la navigazione breadcrumb principale
update_knowledge	Aggiorna titolo, contenuto, tag, scheda principale o colore di una scheda
delete_knowledge	Elimina una scheda. Attenzione: elimina anche tutte le schede figlie annidate.
list_knowledge_children	Sfoglia la gerarchia: elenca le schede radice o le schede figlie di una determinata scheda

Prompt IA

Questi sono modelli di prompt predefiniti che la tua IA può usare per i flussi più comuni:

Prompt	Cosa fa
organize_inbox	Ottieni suggerimenti per organizzare gli elementi della tua Inbox
summarize_collection	Riassumi il contenuto di una raccolta
find_related	Trova segnalibri su un determinato argomento
weekly_digest	Ottieni una panoramica dei segnalibri salvati di recente
suggest_tags	Ottieni suggerimenti di tag per i segnalibri senza tag
explore_knowledge Pro	Cerca nella tua base di conoscenza un argomento, riassumi ciò che hai catturato ed evidenzia le lacune

Risoluzione dei problemi

Errore «Unauthorized" o «Missing authentication"

Ricontrolla la tua chiave API. Nell'app Linkflare, clicca sul menu utente (in alto a destra) e seleziona Copia chiave API per copiare la chiave esatta. Assicurati che non ci siano spazi aggiuntivi e che sia inclusa la chiave completa.

Gli strumenti non compaiono in Claude Desktop

• Assicurati di aver chiuso completamente Claude Desktop (non solo la finestra) e di averlo riaperto.
• Ricontrolla che il nome del connettore sia linkflare e che l'URL sia esattamente https://mcp.linkflare.io/mcp (senza barra finale).
• Verifica che l'OAuth Client ID nelle Advanced settings sia impostato su linkflare-claude.

Nessun risultato nella ricerca

La ricerca è una ricerca full-text. Se una richiesta non restituisce risultati, prova con termini più generici. Puoi anche filtrare per raccolta, tag o tipo invece che per testo.

Raccolta o tag non trovati

Puoi usare i nomi delle raccolte e dei tag (non solo gli ID). La corrispondenza dei nomi non distingue tra maiuscole e minuscole, quindi funzionano sia «ricette" sia «Ricette".

Gli strumenti di conoscenza restituiscono «Forbidden" o «Pro plan required"

Gli strumenti di conoscenza (search_knowledge, add_knowledge, get_knowledge, update_knowledge, delete_knowledge, list_knowledge_children e il prompt explore_knowledge) sono riservati agli account Pro. Gli strumenti per segnalibri, raccolte e tag funzionano nel piano gratuito. Esegui l'upgrade nella pagina dei prezzi.

Ho eliminato una scheda di conoscenza, ma le mie schede figlie sono sparite

delete_knowledge agisce in cascata: eliminare una scheda principale rimuove ogni scheda annidata al suo interno. Se l'IA propone di eliminare una scheda con schede figlie, ricontrolla prima di accettare. Per fare ordine senza perdere le schede figlie, spostale prima con update_knowledge (imposta parent_id a 0 per la radice o sull'ID di un'altra scheda).

Privacy e sicurezza

La tua chiave API identifica il tuo account. Il server MCP accede solo ai tuoi segnalibri personali: non può vedere i dati di altri utenti. Tutta la comunicazione è crittografata tramite HTTPS.

L'assistente IA vede solo ciò che gli chiedi. Non ha accesso permanente all'intera tua libreria, a meno che tu non lo richieda esplicitamente.