Configurazione MCP

La maggior parte degli utenti non avrà bisogno di questa pagina. Ogni client IA moderno (Claude, Cursor, ChatGPT, VS Code, Windsurf, Zed) offre un’interfaccia grafica che aggiunge Engram in pochi clic. Vedi Integrazioni IA per la guida di ogni client.

Se preferisci modificare un file di configurazione (o il tuo client non ha un’interfaccia grafica), ci sono tre strade, dalla più semplice: affidare la configurazione alla tua IA, seguire le schede per client, oppure saltare del tutto OAuth con una chiave API.

Fai configurare tutto alla tua IA

La via più rapida: incolla il prompt qui sotto nel tuo assistente IA. Riconoscerà in quale client sta girando, modificherà il file di configurazione giusto (o eseguirà il comando CLI giusto) e ti dirà cosa fare dopo.

Add Engram as an MCP server in this AI client, then teach the AI to use it.

URL: https://mcp.engram.page
Transport: HTTP
Auth: OAuth — a browser opens on first connect.

First, pick the right path for this client (CLI like `claude mcp add`, editing an mcp.json, etc.), do the setup, and tell me how to restart so the new server registers.

After that's done, add the text below to my long-lived system / global prompt for this client (e.g. ~/.claude/CLAUDE.md for Claude Code, Cursor Rules for Cursor, the personal preferences field at claude.ai/settings/general for Claude Desktop). If it's a web UI you can't edit, just tell me where to paste it:

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.

Reference: https://engram.page/docs/mcp/manual-config/

Se qualcosa va storto (o preferisci fare da solo), le schede per client qui sotto contengono la procedura manuale completa.

Endpoint MCP di Engram

https://mcp.engram.page

Engram parla MCP su HTTPS. Ci sono due modi per autenticarsi:

• OAuth (predefinito). La prima volta che il tuo client si collega all’URL qui sopra, si apre una finestra del browser per l’accesso. Dopo di che il client conserva un token e si riconnette in modo silenzioso. Nessuna chiave da copiare.
• Chiave API per configurazioni headless, automatizzate o con archivi condivisi. Invia la chiave come token Bearer in un’intestazione Authorization. Vedi Autenticazione con chiave API più sotto.

In entrambi i casi nessuna variabile d’ambiente e nessun processo server locale.

Configura il tuo client

Scegli il tuo client qui sotto. Ogni scheda è una procedura completa: configurazione, ricaricamento, autenticazione al primo avvio e dove insegnare all’IA a usare davvero Engram.

Per il self-host, sostituisci l’URL del cloud con l’URL /api/mcp del tuo backend in uno qualsiasi degli snippet qui sotto. Vedi la sezione endpoint qui sopra per i segnaposto di riferimento.

Claude Code

1. Aggiungi Engram. Usa la CLI di Claude Code, che modifica la configurazione al posto tuo:

claude mcp add --transport http --scope user engram https://mcp.engram.page

Il flag --scope user rende Engram disponibile in ogni progetto. Toglilo (o usa --scope project) per limitare Engram al file .mcp.json del progetto corrente.

Preferisci fare a mano? Aggiungi a ~/.claude.json (a livello utente) o a .mcp.json nella radice del progetto:

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Ricarica. Esci dalla sessione corrente di Claude Code ed esegui di nuovo claude. Esegui claude mcp list per confermare che Engram sia registrato.

3. Autenticazione al primo avvio. Claude Code non la propone da solo. Nella nuova sessione esegui /mcp, seleziona engram (compare come △ needs authentication), poi scegli Authenticate. Il browser si apre per OAuth. Accedi a Engram, approva la connessione e Claude Code salva il token e lo riutilizza da lì in poi. Oggi la concessione è l’intero ambito mcp; gli ambiti granulari per singola azione sono nella roadmap.

4. Di’ a Claude di usarlo. Aggiungi in coda lo snippet qui sotto a ~/.claude/CLAUDE.md, il tuo file di istruzioni a livello utente, applicato a ogni progetto.

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.

Cursor

1. Modifica la configurazione. Aggiungi Engram a ~/.cursor/mcp.json (a livello utente) oppure a .cursor/mcp.json nella radice del progetto (a livello di progetto):

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Ricarica. Chiudi Cursor completamente (Cmd+Q / File → Exit) e riaprilo. Ricaricare la finestra non basta: i server MCP si registrano all’avvio dell’app.

3. Autenticazione al primo avvio.

La prima volta che Cursor chiama Engram, il browser si apre per OAuth. Accedi a Engram, approva la connessione e il gioco è fatto: il token viene salvato e riutilizzato da lì in poi. Oggi la concessione è l’intero ambito mcp; gli ambiti granulari per singola azione sono nella roadmap.

4. Di’ a Cursor di usarlo. Aggiungi lo snippet qui sotto alle Rules di Cursor: ~/.cursor/rules (a livello utente) oppure .cursor/rules in un progetto.

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.

VS Code

1. Modifica la configurazione. Aggiungi Engram a .vscode/mcp.json nel tuo workspace. VS Code usa servers invece di mcpServers e richiede "type": "http":

{
  "servers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page"
    }
  }
}

2. Ricarica. Esegui Developer: Reload Window dalla palette dei comandi (Cmd+Shift+P / Ctrl+Shift+P). Non serve riavviare del tutto VS Code.

3. Autenticazione al primo avvio.

La prima volta che Copilot Chat (o la tua estensione compatibile con MCP) chiama Engram, il browser si apre per OAuth. Accedi a Engram, approva la connessione e il gioco è fatto: il token viene salvato e riutilizzato da lì in poi. Oggi la concessione è l’intero ambito mcp; gli ambiti granulari per singola azione sono nella roadmap.

4. Di’ a VS Code di usarlo. Aggiungi lo snippet qui sotto alle custom instructions del tuo workspace (Copilot Chat → impostazioni → Custom Instructions, o l’equivalente della tua estensione).

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.

Windsurf

1. Modifica la configurazione. Aggiungi Engram a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Ricarica. Chiudi Windsurf completamente e riaprilo. Ricaricare la finestra potrebbe non attivare la registrazione dei server MCP.

3. Autenticazione al primo avvio.

La prima volta che Windsurf chiama Engram, il browser si apre per OAuth. Accedi a Engram, approva la connessione e il gioco è fatto: il token viene salvato e riutilizzato da lì in poi. Oggi la concessione è l’intero ambito mcp; gli ambiti granulari per singola azione sono nella roadmap.

4. Di’ a Windsurf di usarlo. Aggiungi lo snippet qui sotto al pannello AI Rules di Windsurf (Workspace → AI Rules) oppure a ~/.codeium/windsurf/global_rules.md per regole valide per tutto l’utente.

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.

Zed

1. Modifica la configurazione. Apri ~/.config/zed/settings.json e aggiungi Engram sotto context_servers (la chiave contenitore di Zed, non lo standard mcpServers):

{
  "context_servers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Ricarica. Esegui zed: reload settings dalla palette dei comandi (Cmd+Shift+P). Nei casi ostinati, chiudi del tutto Zed e riaprilo.

3. Autenticazione al primo avvio.

La prima volta che l'assistente di Zed chiama Engram, il browser si apre per OAuth. Accedi a Engram, approva la connessione e il gioco è fatto: il token viene salvato e riutilizzato da lì in poi. Oggi la concessione è l’intero ambito mcp; gli ambiti granulari per singola azione sono nella roadmap.

4. Di’ a Zed di usarlo. Aggiungi lo snippet qui sotto al prompt predefinito del tuo assistente in settings.json (sotto assistant.default_prompt) oppure dalle impostazioni dell’assistente.

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.

Other / Custom

1. Modifica la configurazione. La maggior parte dei client MCP accetta il contenitore standard mcpServers:

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

Se il tuo client non riconosce questa forma, controlla nella sua documentazione quale chiave contenitore si aspetta (VS Code usa servers, Zed usa context_servers).

2. Ricarica. La maggior parte dei client richiede un riavvio completo, non solo il ricaricamento della finestra, perché i nuovi server MCP vengano registrati.

3. Autenticazione al primo avvio.

La prima volta che il client chiama Engram, il browser si apre per OAuth. Accedi a Engram, approva la connessione e il gioco è fatto: il token viene salvato e riutilizzato da lì in poi. Oggi la concessione è l’intero ambito mcp; gli ambiti granulari per singola azione sono nella roadmap.

4. Di’ alla tua IA di usarlo. Inserisci lo snippet qui sotto dove il tuo client accetta istruzioni di sistema o globali di lunga durata.

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.

Autenticazione con chiave API

OAuth è il metodo predefinito. Usa una chiave API per accessi headless o automatizzati, per un controllo per singola connessione (bot con scrittura oppure agente di sola lettura) o per condividere un archivio senza concedere l’accesso completo. Una chiave autentica sia MCP sia la REST API. Oggi ogni chiave porta con sé l’accesso completo del tuo account; gli ambiti granulari per singola chiave sono nella roadmap.

Ottieni una chiave

Generane una su app.engram.page/settings/api-keys. Engram mostra la chiave completa una sola volta, alla creazione, poi solo il suo prefisso. Trattala come una password e conservala in un posto sicuro.

Aggiungila alla configurazione

Aggiungi un blocco headers che invia la chiave come token Bearer. La chiave contenitore (mcpServers / servers / context_servers) segue il client che stai configurando, quindi usa la stessa forma mostrata nella tua scheda qui sopra. Per i client con mcpServers standard:

{
  "mcpServers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page",
      "headers": {
        "Authorization": "Bearer engram_YOUR_KEY_HERE"
      }
    }
  }
}

Con una chiave API configurata, alla prima connessione non si apre nessun browser: la chiave autentica subito. Per ruotarla, genera una nuova chiave nelle impostazioni e sostituisci il valore nella tua configurazione.

Attenzione

Trattala come una password. Non inserirla nel controllo di versione; tieni le chiavi API fuori dai file mcp.json che vengono sottoposti a commit. Usa la sostituzione tramite variabile d’ambiente dove il tuo client la supporta, oppure limita la configurazione a un file a livello utente (non di progetto).

Risoluzione dei problemi

• Il client non vede Engram dopo la modifica. Riavvia il client completamente, non solo la finestra.
• Il browser non si apre per l’autenticazione. Verifica che nessun blocco dei popup sia attivo; alcuni client fanno passare la finestra OAuth dalla propria logica del browser, che fallisce in silenzio se bloccata.
• Failed to connect. Controlla che l’URL sia raggiungibile. Vedi Risoluzione dei problemi per i problemi comuni a tutti i client.

Per i flussi grafici specifici di ogni client, vedi Integrazioni IA.