Cursor

Cursor ha un supporto MCP di prima classe. Crea un file mcp.json, riavvia Cursor e OAuth parte nel tuo browser la prima volta che l’agente usa Engram. Per il contesto sul protocollo, 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.

Endpoint

https://mcp.engram.page

Configurazione

1. Modifica mcp.json. Crea o modifica ~/.cursor/mcp.json (globale per l’utente) oppure .cursor/mcp.json nella radice del progetto (a livello di progetto, prevale su quello globale per lo stesso nome di server):

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

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

3. Verifica. Apri Settings → Tools & MCP e conferma che engram compaia nell’elenco dei server.

Autenticazione al primo avvio

Cursor non propone OAuth alla connessione. Parte alla prima chiamata di uno strumento. Apri una nuova chat e chiedi all’agente di cercare in Engram. Il browser si apre per accedere a Engram e approvare la connessione. Cursor salva il token e lo riutilizza da lì in poi. La concessione è l’intero ambito mcp. Gli ambiti granulari per singola azione sono nella roadmap.

Per saltare OAuth (per configurazioni headless o con archivio condiviso), sostituisci il blocco con una chiave API:

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page",
      "headers": { "Authorization": "Bearer ${env:ENGRAM_API_KEY}" }
    }
  }
}

Ottieni una chiave su app.engram.page/settings/api-keys.

Di’ a Cursor come usarlo

Aggiungi lo snippet qui sotto alle Rules di Cursor: ~/.cursor/rules (a livello utente) oppure un file .cursor/rules/*.mdc 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.

Provalo

Una volta collegato, chiedi all’agente di Cursor:

• 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.

Cursor chiama lo strumento search di Engram (oppure get_note, write_note, ecc.), recupera i risultati e risponde nel contesto. Se lo strumento parte, hai finito.

Risoluzione dei problemi (specifica di Cursor)

• Due voci engram in Tools & MCP. Il server è definito sia in ~/.cursor/mcp.json sia in .cursor/mcp.json. Rimuovine una (prevale quella a livello di progetto).
• Il server compare in Settings ma l’agente non lo chiama mai. Problema noto di iniezione della configurazione globale su alcune build di Cursor. Soluzione alternativa: sposta la configurazione nel file .cursor/mcp.json a livello di progetto.
• OAuth non viene mai proposto. L’agente non ha ancora invocato uno strumento. Forzalo: chiedi all’agente di chiamare per nome lo strumento search di engram. Se resta in silenzio, riavvia Cursor; uno stato di connessione obsoleto può bloccare la prima chiamata.

Per i problemi comuni a tutti i client, vedi Risoluzione dei problemi.

Revoca

Per scollegare Cursor da Engram:

1. In Cursor, trova la voce del connettore o del server MCP e rimuovila.
2. In Engram, apri il tuo account → API Keys & Sessions e revoca la sessione corrispondente.
3. Il token OAuth viene invalidato lato server. Cursor dovrà autenticarsi di nuovo per riconnettersi.

Per rimuoverlo lato client, elimina il blocco engram dal tuo mcp.json e riavvia Cursor.

Passi successivi

MCPPanoramica del protocollo.

AmbitiCosa copre la concessione.

Tutte le integrazioniScegli un altro client.