Claude Desktop

L’interfaccia Connectors di Claude Desktop è il modo più semplice per collegare Engram. Basta incollare l’URL e accedere: nessun file di configurazione e nessuna chiave API da copiare. Per capire cosa succede sotto il cofano, vedi MCP.

Prerequisiti

Prima di iniziare, verifica che:

Hai un account Engram su app.engram.page.
Almeno un archivio è sincronizzato. Apri il plugin di Obsidian o l’app web e controlla che le note siano state sincronizzate nell’ultimo giorno.
Puoi accedere tramite browser. Il flusso di autenticazione MCP apre una finestra del browser.
Se prevedi di usare una chiave API invece di OAuth: le chiavi API richiedono Pro. L’accesso con OAuth funziona su ogni piano, Free compreso, ed è il percorso consigliato. Free e Starter non possono creare né usare chiavi API.

Configurazione

Apri la pagina Add Engram connector. Avvia la configurazione dei connettori di Claude con nome e URL di Engram già compilati. Queste impostazioni valgono sia per l’app desktop sia per claude.ai.

Preferisci farlo a mano? Vai su claude.ai/customize/connectors e premi il pulsante + per aggiungere un connettore personalizzato.
Compila i due campi, poi fai clic su Add. Arrivano già compilati se hai aperto la finestra dal link qui sopra; altrimenti inseriscili tu.

Name: quello che vuoi, per esempio:
```
Engram
```
Remote MCP server URL:
```
https://mcp.engram.page
```
Si apre una finestra del browser per l’autorizzazione. Vedi Autenticazione al primo avvio per cosa aspettarti.
Controlla i permessi richiesti nella schermata degli ambiti e approva.
Di’ a Claude come usarlo così da fargli usare Engram in automatico.
Provalo per confermare che il connettore funzioni.

Autenticazione al primo avvio

La prima volta che ti colleghi, Claude Desktop apre automaticamente una finestra del browser che ti chiede di accedere a Engram. Accedi, seleziona i permessi che vuoi concedere e fai clic su Approve. Il browser ti riporta automaticamente a Claude Desktop. Nessun token da copiare e incollare, nessuna variabile d’ambiente. È lo stesso tipo di accesso che useresti per collegare qualsiasi app a Google, Dropbox o GitHub.

Se preferisci evitare il flusso nel browser (configurazioni headless, automatizzate o con archivio condiviso), puoi autenticarti con una chiave API. Vedi Configurazione MCP → Autenticazione con chiave API.

Di’ a Claude come usarlo

Aggiungere il connettore è metà del lavoro. Claude non userà Engram se non glielo dici. Inserisci una breve istruzione nelle preferenze globali di Claude, così ogni conversazione sa di dover usare Engram come memoria.

Apri claude.ai/settings/general.
Trova il campo What personal preferences should Claude consider in responses? (la casella delle istruzioni globali).
Incolla questo snippet. Tienilo su una riga a sé, così resta valido per ogni conversazione:

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

Ora Claude usa Engram in automatico quando deve cercare qualcosa o salvare qualcosa che hai condiviso.

Provalo

Una volta collegato e con il prompt globale al suo posto, il connettore compare nella barra laterale. Prova a chiedere:

Cerca nel mio archivio le note sul processo di colloquio per ingegneri e riassumi le prime tre.
Trova tutto ciò che ho scritto sugli embedding nell'ultimo mese.
Leggi la mia nota intitolata 'Pianificazione Q3' ed estrai le azioni da fare.
Mostrami il frontmatter e i link in uscita di 'project-ideas.md'.
Scrivi una nuova nota intitolata 'Sync con il design, 21 maggio' nella mia cartella 'Note delle riunioni' con le conclusioni di oggi.
Aggiungi una sezione 'Decisioni' a 'roadmap.md' con queste tre voci.
Elenca le cartelle di primo livello del mio archivio.
Sposta tutto ciò che in 'inbox' menziona 'Q4' in 'Q4-planning'.

Claude chiama lo strumento search di Engram (oppure get_note, write_note, ecc.), recupera i risultati e risponde nel contesto.

Ambiti concessi

Claude Desktop richiede l’ambito mcp nella schermata di approvazione. È un’unica concessione che copre l’intera superficie di strumenti MCP sul tuo archivio. Gli ambiti granulari per singola azione (sola lettura, senza eliminazione, ecc.) sono nella roadmap. Vedi Ambiti per i dettagli e il flusso di revoca.

Risoluzione dei problemi (specifica di Claude Desktop)

La finestra di autorizzazione non si apre mai. Verifica che Claude Desktop sia all’ultima versione e che nessun blocco dei popup sia attivo.
“Connector failed to load.” Verifica che l’URL MCP sia raggiungibile. Incollalo in una scheda del browser. Se vedi una pagina con una risposta strutturata invece di un errore, la connessione è a posto e il problema è lato Claude Desktop. Riavvialo e riprova.

Per i problemi comuni a tutti i client (autenticazione rifiutata, errori sugli ambiti, lacune nella sincronizzazione), vedi Risoluzione dei problemi.

Revoca

La disconnessione ha effetto da entrambi i lati. Scegli quello più comodo:

Dall’app Claude: apri Settings → Connectors, trova Engram e scegli Disconnect.

Da Claude sul web: vai su claude.ai/customize/connectors, fai clic sul connettore Engram e scegli Disconnect.

Da Engram: vai su app.engram.page/settings/connections e disconnetti la sessione.

In ogni caso il token OAuth viene invalidato lato server e Claude Desktop dovrà autenticarsi di nuovo per riconnettersi.

Passi successivi

MCPPanoramica del protocollo.

AmbitiScegli i permessi minimi.

Tutte le integrazioniScegli un altro client.