Memoria persistente per IA: guida MemPalace per Claude, LM Studio, Cursor & VSCode

Ogni volta che inizi una nuova sessione AI, dimentica tutto. MemPalace risolve questo problema — un livello di memoria gratuito e open-source che offre a Claude Code, Claude Desktop, LM Studio, Cursor e VSCode un cervello condiviso, ricercabile e persistente. Nessuna chiave API. Nessun cloud. Tutto rimane sulla tua macchina. Ecco come configurarlo in meno di 25 minuti.

Perché la tua IA continua a dimenticare — e come risolverlo

Ogni volta che apri una nuova conversazione con un assistente AI, ricominci da zero. Non ricorda il progetto che hai descritto martedì scorso, la decisione sullo stack tecnologico che hai preso ieri, o il contesto del cliente che hai spiegato una dozzina di volte. Non è un problema del modello — è un problema di architettura della memoria.

MemPalace (sostenuto dall’attrice Milla Jovovich) risolve il problema dando alla tua IA una memoria locale, strutturata e semanticamente ricercabile che persiste tra le sessioni. Lo configuri una volta e da quel momento la tua IA accumula conoscenza reale sul tuo lavoro.

Il modello mentale è un armadietto: Wings sono i tuoi progetti o clienti, Rooms sono argomenti all’interno di un progetto e Drawers contengono i singoli ricordi. Il recupero è semantico: chiedi in linguaggio naturale, non con parole chiave esatte, e trova ciò che è rilevante.

Funziona con Claude Code, LM Studio e altri strumenti compatibili con MCP. Tutto è memorizzato localmente — nessun account cloud, nessuna chiave API, nessun abbonamento.

Una volta terminata l’installazione e la configurazione, puoi persino mantenere MemPalace sincronizzato su tutte le tue macchine utilizzando lo script open-source mempalace-cloud-sync che ho realizzato, gratuitamente!

Prerequisiti

• Python 3.9 o superiore (consigliato 3.11+)
• Uno o più di: Claude Code, Claude Desktop, LM Studio 0.3.5+ (questo è l’unico metodo 100% privato, dove i tuoi ricordi non lasciano mai il tuo PC), Cursor o VSCode 1.99+ con l’estensione GitHub Copilot
• ~300 MB di spazio libero su disco (per il modello locale sentence-transformer)
• Un terminale (PowerShell su Windows, Terminale su macOS/Linux)

Parte 1 — Installa MemPalace

Opzione A: pip (la più semplice)

pip install mempalace

Opzione B: uv

uv tool install mempalace

Al primo avvio, MemPalace scarica un modello sentence-transformer di circa 80 MB per la ricerca semantica. Questo accade una volta sola — gli avvii successivi sono istantanei.

Verifica l’installazione:

python -c "import mempalace; print(mempalace.__version__)"

Dovresti vedere 3.3.5 o superiore.

La Struttura del Palace

MemPalace crea una cartella di configurazione in ~/.mempalace/ (Windows: C:\Utenti\NomeUtente\.mempalace\ ). Apri mempalace.yaml per vedere le tue Wings:

wing: .mempalace
rooms:
- name: general
description: Tutti i file di progetto
keywords: []
- name: work
description: Progetti di lavoro
keywords:
- work
- name: personal
description: Progetti personali
keywords:
- personal

Wings sono progetti o persone di alto livello. Rooms sono argomenti all’interno di una wing. Drawers sono singole voci di memoria. Puoi aggiungere wings e rooms liberamente modificando questo file YAML.

Parte 2 — Collega MemPalace con Claude Code

Passo 1: Registra il server MCP

claude mcp add mempalace -- python -m mempalace.mcp_server

Passo 2: Verifica la connessione

claude mcp list

Dovresti vedere mempalace elencato con stato ✓ Connesso.

Passo 3: Riavvia Claude Code

Chiudi e riapri Claude Code in modo che rilevi il nuovo server. Dopo il riavvio, i 29 strumenti di MemPalace diventano disponibili in ogni conversazione.

Strumenti più utilizzati a cui Claude ottiene accesso

Passo 4: Comunica a Claude di usarlo effettivamente (CLAUDE.md)

Claude Code legge un file chiamato CLAUDE.md all’inizio di ogni sessione. Aggiungere una sezione MemPalace in questo file fornisce a Claude regole chiare su quando scrivere e quando leggere — senza bisogno di richieste manuali.

Apri (o crea) il file in ~/.claude/CLAUDE.md e aggiungi:

## MemPalace Memory — Regole di Lettura e Scrittura
MemPalace è un server MCP di memoria semantica locale. Usalo per persistere il contesto della conversazione in modo progressivo.
### Quando SCRIVERE (proattivo — fallo automaticamente)
Salva i ricordi in modo incrementale man mano che la conversazione si svolge — non solo alla fine. Ogni volta che emerge qualcosa che vale la pena conservare, scrivilo immediatamente:
- Decisioni prese o ragionamento spiegato
- Strumenti configurati, comandi eseguiti, percorsi di file usati
- Contesto del progetto, dettagli del cliente, preferenze espresse
- Problemi risolti e come
Usa la wing più rilevante (work, personal, general) e la room. Crea nuove room se nessuna è adatta.
Non aspettare che ti venga chiesto.
### Quando LEGGERE (solo su richiesta — NON cercare automaticamente)
Cerca in MemPalace solo quando l'utente ti chiede esplicitamente di ricordare qualcosa:
- "ti ricordi…"
- "l'ultima volta abbiamo…"
- "cosa abbiamo deciso su…"
- "puoi ricordare…"
NON cercare all'inizio delle conversazioni o in modo proattivo. Aspetta che ti venga chiesto.
### Strumenti
- mempalace_search — ricerca semantica, query in linguaggio naturale
- mempalace_status — panoramica del palace
- mempalace_list_wings — elenca wings e rooms
- tool_add_drawer — salva un ricordo (wing, room, content)

Con questo in atto, Claude scrive i ricordi in modo silenzioso mentre lavori — senza bisogno di richieste. Non inonderà nemmeno l’inizio di ogni sessione con ricerche; cerca solo quando gli chiedi di ricordare qualcosa di specifico.

Parte 3 — Collega MemPalace con LM Studio

Passo 1: Trova il file di configurazione MCP

Se il file non esiste ancora, crealo.

Passo 2: Aggiungi la voce MemPalace

Apri mcp.json e aggiungi il blocco mempalace all’interno di mcpServers . Se il file è vuoto, usa questo come modello iniziale:

{
"mcpServers": {
"mempalace": {
"command": "python",
"args": ["-m", "mempalace.mcp_server"]
}
}
}

Se hai già altri server MCP configurati, aggiungi la voce insieme a loro:

{
"mcpServers": {
"some-other-server": { ... },
"mempalace": {
"command": "python",
"args": ["-m", "mempalace.mcp_server"]
}
}
}

Passo 3: Caricalo in LM Studio

1. Apri LM Studio
2. Vai alla scheda Program nella barra laterale destra
3. Clicca Install → Edit mcp.json
4. Salva il file — LM Studio rileva automaticamente la modifica, nessun riavvio richiesto

Passo 4: Comunica al modello di LM Studio di usarlo

Nella scheda Chat, apri il campo del prompt di sistema per il modello che usi più spesso e aggiungi:

Hai accesso a un server MCP MemPalace che ti fornisce una memoria semantica persistente.
Regole di scrittura (automatiche — non aspettare che ti venga chiesto):
- Man mano che la conversazione si svolge, salva tutto ciò che vale la pena conservare nella wing e nella room giuste:
decisioni, configurazioni, percorsi di file, contesto del progetto, preferenze, problemi risolti.
- Salva in modo incrementale man mano che emergono gli argomenti, non solo alla fine della sessione.
- Usa mempalace_list_wings prima per scegliere la posizione giusta prima di scrivere.
Regole di lettura (solo su richiesta):
- Cerca in MemPalace solo quando l'utente ti chiede esplicitamente di ricordare qualcosa —
"ti ricordi...", "l'ultima volta abbiamo...", "cosa abbiamo deciso su...".
- NON cercare automaticamente all'inizio delle conversazioni.
- Quando ti viene chiesto di ricordare, usa mempalace_search con le parole chiave dell'utente.

Salva come preset — questo prompt persiste in tutte le future sessioni con quel modello.

Parte 4 — Collega MemPalace con Claude Desktop

Passo 1: Trova (o crea) il file di configurazione

Se il file non esiste, crea sia la cartella Claude che il file. Claude Desktop legge questo file ad ogni avvio.

Passo 2: Aggiungi la voce MemPalace

Claude Desktop utilizza lo stesso formato mcpServers di LM Studio e Cursor:

{
"mcpServers": {
"mempalace": {
"command": "python",
"args": ["-m", "mempalace.mcp_server"]
}
}
}

Passo 3: Riavvia Claude Desktop

Chiudi completamente e riapri l’app. Puoi confermare che funziona cliccando sull’icona degli strumenti (icona martello) nell’input della chat — gli strumenti MemPalace dovrebbero apparire nell’elenco.

Passo 4: Comunica a Claude di usarlo

Claude Desktop non ha un file di prompt di sistema globale come CLAUDE.md. L’approccio migliore è usare un Progetto:

1. Apri Claude Desktop e clicca Nuovo Progetto
2. Apri il campo Istruzioni del progetto
3. Incolla le regole di memoria MemPalace:

Hai accesso a un server MCP MemPalace che ti fornisce una memoria semantica persistente.
Regole di scrittura (automatiche — non aspettare che ti venga chiesto):
- Man mano che la conversazione si svolge, salva tutto ciò che vale la pena conservare nella wing e nella room giuste:
decisioni, configurazioni, percorsi di file, contesto del progetto, preferenze, problemi risolti.
- Salva in modo incrementale man mano che emergono gli argomenti, non solo alla fine della sessione.
- Usa mempalace_list_wings prima per scegliere la posizione giusta prima di scrivere.
Regole di lettura (solo su richiesta):
- Cerca in MemPalace solo quando l'utente ti chiede esplicitamente di ricordare qualcosa —
"ti ricordi...", "l'ultima volta abbiamo...", "cosa abbiamo deciso su...".
- NON cercare automaticamente all'inizio delle conversazioni.

Tutte le conversazioni all’interno di quel progetto seguiranno automaticamente queste regole. Crea un progetto per cliente o dominio per mantenere il contesto ben organizzato.

Parte 5 — Collega MemPalace con Cursor

Passo 1: Trova (o crea) la configurazione MCP globale

Passo 2: Aggiungi la voce MemPalace

Cursor utilizza lo stesso formato mcpServers di LM Studio — nessun campo type necessario:

{
"mcpServers": {
"mempalace": {
"command": "python",
"args": ["-m", "mempalace.mcp_server"]
}
}
}

Passo 3: Riavvia Cursor

Chiudi completamente e riapri Cursor. Apri una chat in modalità Agent — gli strumenti MemPalace appariranno ora nell’elenco degli strumenti.

Passo 4a: Imposta la regola di comportamento globale (una volta — si applica a ogni progetto)

Vai su Cursor Settings → Rules → User Rules e incolla quanto segue. Questo dice all’IA di Cursor esattamente quando scrivere, quando leggere e come capire quale room MemPalace appartiene al progetto corrente — automaticamente, per ogni codebase che apri.

## MemPalace (Memoria Persistente)
Usa il server MCP `mempalace` per tutta la memoria persistente.
### Rilevamento della room di progetto (in ordine — fermati al primo match)
1. La regola attiva del progetto dichiara `mempalace_room: <nome>` → usa quel nome esattamente
2. Esegui `git remote get-url origin` → prendi l'ultimo segmento del percorso, rimuovi `.git` e qualsiasi
suffisso di versione finale (_1.2.3, -v1.46, _1.46.0 ecc.) → usa il risultato
3. Usa il nome della cartella della directory di lavoro corrente, rimuovendo i suffissi di versione allo stesso modo
4. Nessuno dei precedenti funziona → chiedi all'utente una volta: "Come dovrei chiamare questo progetto in
MemPalace?" — salva la loro risposta come ricordo immediatamente
### Scrivi in modo proattivo — non aspettare che ti venga chiesto
Salva in MemPalace durante la sessione ogni volta che:
- Viene presa una decisione significativa o spiegato un ragionamento
- Viene configurato uno strumento, scoperto un pattern di comando o stabilito un percorso di file importante
- Viene risolto un bug non ovvio o trovata una soluzione alternativa
- Viene chiarita l'architettura, il flusso di lavoro o la struttura del progetto
- L'utente esprime una preferenza o un vincolo
### Leggi su richiesta — solo quando attivato
Cerca in MemPalace quando:
- L'utente dice "ti ricordi", "l'ultima volta", "cosa abbiamo deciso", "puoi ricordare"
- Si avvia un'attività complessa in più passaggi in cui il contesto precedente cambierebbe chiaramente l'approccio
### Strumenti
- Scrittura: mempalace_add_drawer(wing, room, content) — usa wing `work` per i ricordi di progetto
- Ricerca: mempalace_search(query) — limita prima alla room del progetto rilevata</nome>

Questo è l’unico passo globale. Cursor legge queste User Rules in ogni sessione in ogni progetto — non dovrai mai più toccarle.

Passo 4b: Fissa il nome della room per progetto (opzionale — elimina ogni ipotesi)

La regola globale sopra può rilevare automaticamente i nomi dei progetti dall’URL del git remote o dal nome della cartella. Ma se la cartella del tuo progetto cambia con i salti di versione (ad es. myapp_1.46.0 → myapp_1.47.0 ), o se il nome del repo git non corrisponde a come chiami il progetto, il rilevamento automatico può dare risultati inconsistenti. La soluzione è una singola riga nelle regole del progetto di Cursor.

Opzione A — Aggiungi alla tua regola di progetto esistente (l’approccio più pulito se hai già un .cursor/rules/myproject.mdc ):

mempalace_room: myproject

Inserisci quella riga ovunque nel corpo della regola. La User Rule globale la legge e usa quella room.

Opzione B — Crea un file dedicato (se non hai ancora regole di progetto):

---
description: Room MemPalace per questo progetto
alwaysApply: true
---
mempalace_room: myproject

Salvalo come .cursor/rules/mempalace.mdc nella root del progetto. Cursor lo carica automaticamente in ogni sessione, indipendentemente dal nome della cartella — quindi quando cloni myapp_1.47.0 , la room giusta viene rilevata immediatamente senza passaggi manuali.

Parte 6 — Collega MemPalace con VSCode

Passo 1: Trova (o crea) la configurazione MCP globale

Puoi anche aggiungere server tramite la Command Palette: MCP: Add Server.

Passo 2: Aggiungi la voce MemPalace

VSCode usa una chiave servers (non mcpServers ) e richiede un campo esplicito "type": "stdio" :

{
"servers": {
"mempalace": {
"type": "stdio",
"command": "python",
"args": ["-m", "mempalace.mcp_server"]
}
}
}

Passo 3: Riavvia VSCode

Chiudi completamente e riapri VSCode. Nel pannello Copilot Chat, imposta il selettore di modalità su Agent. Gli strumenti MemPalace saranno ora disponibili.

Passo 4: Comunica a Copilot di usarlo

Crea il file .github/copilot-instructions.md nella root del tuo progetto — Copilot lo legge automaticamente in modalità Agent:

## MemPalace Memory — Regole di Lettura e Scrittura
mempalace_room: myproject
MemPalace è un server MCP di memoria semantica locale. Usalo per persistere il contesto della conversazione in modo progressivo.
Regole di scrittura (automatiche — non aspettare che ti venga chiesto):
- Salva decisioni, configurazioni, percorsi di file, contesto del progetto, preferenze e problemi risolti.
- Salva in modo incrementale man mano che emergono gli argomenti, non solo alla fine.
- Usa mempalace_list_wings per scegliere la wing e la room giuste prima di scrivere.
- Scrivi sempre nella room dichiarata sopra (mempalace_room).
Regole di lettura (solo su richiesta):
- Cerca in MemPalace solo quando l'utente ti chiede esplicitamente di ricordare qualcosa.
- NON cercare automaticamente all'inizio delle conversazioni.

Sostituisci myproject con il nome effettivo del tuo progetto. Questo file viaggia con il repo — quando ti sposti in una nuova cartella di versione, Copilot rileva automaticamente lo stesso nome di room.

Per una regola globale che si applica a tutti i progetti, vai su VSCode Settings → cerca “copilot instructions” e aggiungi le regole di scrittura/lettura (senza la riga mempalace_room ) in github.copilot.chat.codeGeneration.instructions .

Risoluzione dei problemi

Errore “Cannot import chromadb” al primo avvio

Questo è un noto conflitto di versioni tra chromadb e i pacchetti opentelemetry. Risolvilo eseguendo:

pip install --upgrade "opentelemetry-sdk>=1.41.0" "opentelemetry-exporter-otlp-proto-common>=1.41.0"

Quindi riprova ad avviare il server MCP.

Claude Code mostra mempalace come disconnesso

Esegui where python (Windows) o which python (macOS/Linux) per ottenere il percorso esatto di Python, quindi aggiorna il comando MCP per usare il percorso completo invece di solo python .

LM Studio non rileva il server

Controlla attentamente la sintassi del tuo JSON — una virgola mancante o una barra inversa non escaped lo romperà in modo silenzioso. Incolla il tuo mcp.json su jsonlint.com per validarlo prima di salvare.

Prossimi Passi

Una volta che MemPalace è in esecuzione sui tuoi strumenti, Claude Code, Claude Desktop, LM Studio, Cursor e VSCode condividono tutti lo stesso archivio di memoria persistente. Una decisione che hai registrato in una sessione di Claude Code è ricercabile da Claude Desktop, Cursor o Copilot — e viceversa. Col tempo la tua IA accumula contesto reale sul tuo lavoro invece di ricominciare da zero ogni sessione.

Alcune idee per iniziare:

• Crea una Wing per cliente o progetto principale
• Chiedi a Claude di riassumere e salvare le decisioni chiave alla fine di ogni sessione di lavoro
• Usa identity.txt in ~/.mempalace/ per memorizzare il contesto permanente che vuoi sempre che l’IA conosca — il tuo stack tecnologico, le preferenze del team, i vincoli ricorrenti

MemPalace è open-source e gratuito: github.com/mempalace/mempalace

Want a Custom Local AI Setup for Your Business?
Let's build it right.

Setting up local AI the right way — private, fast, and actually useful — takes more than following a tutorial. We design and deploy custom local AI workflows tailored to your team’s tools, data, and processes. No cloud dependency. No vendor lock-in. Full ownership.

Whether you need a fully configured AI assistant, custom memory pipelines, document processing, or an AI integrated with your existing software stack — we handle the full setup for you.

Get in Touch

or email info@shambix.com

Abilita JavaScript nel browser per completare questo modulo.

Nome *

Nome

Cognome

Email *

Budget progetto Privacy

Message

Budget del progetto— Budget (facoltativo) —Sotto i 5.000 €MedioGrandeNon sono sicuro/a

Lavoriamo con budget flessibili e di ogni tipo, per piccoli e grandi progetti. Serve a orientare meglio la soluzione più adatta al tuo progetto.

Informativa Privacy *

• Ho letto la Privacy Policy ed acconsento al trattamento dei miei dati da parte di Shambix, affinché possa rispondere alla mia richiesta. *

Invia