Documentazione

Server MCP

Sono necessari i diritti di accesso previsti per l'account

L’accesso MCP è disponibile solo quando è già incluso nei diritti attuali dell’account Savebase con cui hai effettuato l’accesso.

Savebase espone un Model Context Protocol (MCP) server affinché gli assistenti IA cerchino e leggano i segnalibri. Chiedi a Claude, ChatGPT o Cursor qualcosa come «Che cosa ho salvato sull’allenamento con i kettlebell?» e interrogherà direttamente la libreria Savebase.

Panoramica

MCP è uno standard aperto che consente alle applicazioni AI di collegarsi a fonti di dati esterne. Savebase implementa un endpoint HTTP compatibile con MCP che offre al tuo assistente AI accesso in sola lettura a segnalibri, cartelle e tag.

Per ChatGPT, installa il componente pubblicato Plugin Savebase. Per Claude, Cursor, VS Code e gli altri client MCP, usa questo indirizzo del server:

text
https://mcp.savebase.space/mcp

Accedi con l’account Savebase come in qualsiasi altra app, senza chiavi API o token da copiare. L’accesso è in sola lettura: niente collegato via MCP può aggiungere, modificare o eliminare elementi.

Requisiti

  • Un account Savebase le cui autorizzazioni attuali includano l'accesso MCP
  • Il plugin Savebase pubblicato per ChatGPT o un client MCP come Claude, Cursor o VS Code

Claude (web, desktop, mobile)

1

Apri i connettori Claude

In claude.ai o nell’app desktop, vai in Impostazioni → Connettori.
2

Aggiungi un connettore personalizzato

Fai clic su Aggiungi connettore personalizzato, assegnagli il nome Savebase, poi incolla https://mcp.savebase.space/mcp.
3

Connetti e accedi

Fai clic su Aggiungi → Connetti, accedi con il tuo account Savebase e autorizza. Gli strumenti Savebase sono ora disponibili nelle tue conversazioni.

Funziona anche su mobile

Un connettore remoto aggiunto su claude.ai può essere usato in Claude per iOS e Android, anche se non si possono aggiungere nuovi server direttamente da Claude Mobile. Consulta la documentazione di Anthropic: note attuali sul supporto MCP remoto.

Claude Code

1

Aggiungi il server

Esegui quanto segue nel terminale. Rimuovi --scope user se lo vuoi solo nel progetto attuale.
bash
claude mcp add --transport http --scope user savebase https://mcp.savebase.space/mcp
2

Autentica

Avvia Claude Code ed esegui /mcp. Si apre una finestra del browser: accedi e autorizza.
3

Verifica

Esegui claude mcp list. Savebase dovrebbe risultare connesso.

Cursor

1

Apri la configurazione MCP

Vai a Impostazioni → MCP → Aggiungi server, oppure modifica ~/.cursor/mcp.json direttamente.
2

Aggiungi il server Savebase

Aggiungi la voce qui sotto. Nota che non è presente headers blocco: l’autenticazione avviene nel browser.
json
{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}
3

Ricarica e autorizza

Ricarica Cursor. Il server risulta richiedere l’accesso: fai clic, accedi e approva.

Importante per gli utenti Cursor

Seleziona sempre HTTP come tipo di server, non SSE. Se avevi una voce SSE, eliminala, aggiungila come HTTP e riavvia Cursor.

ChatGPT

1

Apri il plugin Savebase

Visita il sito ufficiale Scheda del plugin Savebase in ChatGPT.
2

Installa e accedi

Seleziona il pulsante più per installare Savebase. Quando richiesto, accedi al tuo account e approva l’accesso in sola lettura alla libreria.
3

Usare Savebase in chat

Avvia una nuova conversazione ChatGPT Work e richiama Savebase con @Savebase, oppure selezionalo dall'area di composizione quando vuoi che ChatGPT cerchi nella tua libreria.

Nessuna configurazione per sviluppatori necessaria

Il plugin pubblico sostituisce il vecchio modo Sviluppatore e la configurazione MCP personalizzata per ChatGPT. L’URL MCP sopra resta valido per altri client compatibili.

VS Code

1

Aggiungi il server

Apri la tavolozza comandi ed esegui MCP: Aggiungi server, scegli HTTP, poi incolla https://mcp.savebase.space/mcp.
2

Oppure modifica direttamente la configurazione

Aggiungi a .vscode/mcp.json nel tuo spazio di lavoro:
json
{
  "servers": {
    "savebase": {
      "type": "http",
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}
3

Accedi

Avvia il server dalla vista MCP. Si apre il browser per l’accesso: approva e gli strumenti appariranno nella modalità agente di Copilot Chat.

Gestione delle app collegate

Ogni app a cui accedi è elencata sotto Impostazioni → Server MCP → App collegate, con la data di connessione e l'ultima volta in cui ha letto la tua libreria. Fai clic su Disconnetti per revocare subito l’accesso.

Cosa può vedere un’app

Le app connesse ottengono accesso in sola lettura a segnalibri, note, trascrizioni, nomi delle cartelle e tag. Non vedono mai la password e non possono modificare la libreria.

Savebase invia dati solo quando una richiesta porta l’assistente collegato a interrogare il server MCP; non trasmette la libreria in background alle app collegate e non la usa per addestrare un modello Savebase. Quando i dati arrivano a un assistente, valgono le condizioni di privacy e utilizzo del suo fornitore. Vedi Informativa sulla privacy di Savebase per l’elenco completo dei dati ricevibili da un’app collegata.

Avanzato: token di accesso manuale

Alcuni vecchi client MCP non accedono tramite browser e richiedono un token inviato in un header. In quel caso, apri Impostazioni → Server MCP → Avanzate, inserisci un'etichetta e fai clic su Genera token. Il token inizia con sb- e resta valido finché non lo revochi.

json
{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp",
      "headers": {
        "Authorization": "Bearer sb-YOUR_MCP_TOKEN"
      }
    }
  }
}

Sicurezza del token

Savebase non conserva mai il token grezzo, solo un hash SHA-256. Viene mostrato una sola volta alla creazione: copialo subito. Puoi revocarlo quando vuoi da Impostazioni → Server MCP.

Strumenti disponibili

Una volta collegato, il tuo assistente IA può accedere a questi nove strumenti. Tutti si limitano a leggere: nessuno può modificare la tua libreria.

StrumentoDescrizione
search_bookmarksCerca parole chiave in titoli, contenuti, note, autori, URL e trascrizioni video. Restringi a campi specifici e filtra per piattaforma, cartella, tag, creatore, date o presenza di trascrizione.
list_bookmarksSfoglia senza una parola chiave, con filtri facoltativi per piattaforma, cartella, tag e data
list_recent_bookmarksCosa hai salvato oggi, questa settimana, questo mese o negli ultimi 7 o 30 giorni
get_bookmarkDettagli completi di un segnalibro, con tag, cartelle e anteprima della trascrizione
get_bookmark_transcriptLeggi la trascrizione di un video lungo a blocchi, senza caricarla tutta insieme
find_bookmark_by_urlControlla se un link è già salvato. Ignora parametri di tracciamento come utm_source.
list_foldersElenca le tue cartelle, inclusa la struttura nidificata
list_tagsElenca tutti i tuoi tag
get_library_statsTotali, ripartizione per piattaforma, cartelle e tag più usati e attività recente di salvataggio

Esempi di prompt

Prova a chiedere all’assistente IA:

  • «Che cosa ho salvato sull’allenamento con i kettlebell?»
  • «Mostrami tutto ciò che ho salvato da Reddit il mese scorso.»
  • «Trova il video salvato in cui qualcuno spiega come configurare un Cloudflare Worker.»
  • «Ho già salvato questo link?» — incolla un URL
  • «Trova tutti i segnalibri nella mia cartella “Ispirazione per il design”.»
  • «A quali articoli ho assegnato il tag “AI”?»
  • «Fammi un riepilogo della mia libreria: quantità, provenienza e tag principali.»
  • «Riassumi i post che ho salvato la settimana scorsa.»

Cercare le parole dette in un video

Se hai trascritto un video salvato, puoi cercare anche nel suo contenuto parlato. Una domanda come «come faccio a fare X» può ritrovare un passaggio spiegato a voce in una clip salvata mesi fa.

Risoluzione dei problemi

ProblemaSoluzione
Savebase non è disponibile in ChatGPTApri plugin Savebase pubblicato, installalo e avvia una nuova conversazione ChatGPT Work. Non è più necessario creare un'app personalizzata in modalità sviluppatore.
L’app non chiede mai di accedereControlla che l'URL sia esattamente https://mcp.savebase.space/mcp — un errore di battitura impedisce al client di trovare il passaggio di accesso.
«Accesso MCP non disponibile» durante l'accessoAccedi con un account che ha attualmente diritto all’accesso MCP o contatta l’assistenza se ritieni che il diritto sia errato.
«Questa richiesta è scaduta»Le richieste di autorizzazione sono valide per 10 minuti. Avvia nuovamente la connessione dalla tua app IA.
La connessione ha smesso di funzionareControlla se l'app compare ancora in Impostazioni → Server MCP → App connesse. Se è stata disconnessa, riconnettila dall'app.
Il server mostra «errored» in CursorElimina la vecchia voce Savebase in Impostazioni di Cursor → MCP. Aggiungila di nuovo come Tipo: HTTP (non SSE), poi riavvia completamente Cursor.
Gli strumenti non compaionoRiavvia il client IA dopo aver aggiunto la configurazione. Alcuni client richiedono un riavvio completo per rilevare nuovi server MCP.
Risultati vuotiAssicurati di avere segnalibri salvati nella libreria Savebase. Il server MCP cerca solo nei tuoi dati.
Token manuale smarritoI token vengono mostrati una sola volta. Revoca il vecchio in Impostazioni → Server MCP → Avanzate e generane uno nuovo.

Passaggi rapidi di ripristino

Se qualcosa non funziona: (1) scollega Savebase nella tua app AI, (2) rimuovilo da Impostazioni → Server MCP → App collegate, (3) aggiungi nuovamente il connettore e accedi, (4) riavvia completamente il client AI.