Maggio 2026 · lettura 7 min · Fran Olivares, Founder di OlivaresAI
@olivaresai/alma-mcp come server, incolli un singolo blocco di JSON nella configurazione del Suo client MCP (Claude Desktop, Cursor, Windsurf, Claude Code o qualsiasi altro client compatibile) con la Sua API key Alma e riavvii. Il server espone 35 strumenti di memoria che l'AI può chiamare autonomamente: salvare una memoria, cercare memorie, assemblare contesto, estrarre fatti, configurare blocchi Soul. Il tempo totale di configurazione è di circa cinque minuti e funziona sul piano Starter di Alma.Il Model Context Protocol (MCP) è lo standard aperto che permette ai client AI di parlare con strumenti e fonti di dati esterni. Una volta che il Suo client parla MCP, può collegare un server di memoria e l'AI ottiene immediatamente strumenti per leggere e scrivere su un archivio di memoria persistente, in ogni conversazione, ogni progetto, ogni giorno. Questa guida illustra la configurazione in cinque minuti per i quattro client più comuni nel 2026 e risponde alle domande che emergono in seguito.
Quando il server MCP di Alma è collegato, il Suo client AI ottiene 35 nuovi strumenti che può chiamare senza che Lei digiti nulla. I più importanti: alma_remember (salva un fatto o preferenza), alma_recall (cerca memorie con query in linguaggio naturale), alma_assemble_context (costruisce un contesto strutturato per la domanda corrente da tutti i livelli di memoria), alma_extract (estrae fatti da un blocco di testo), alma_update_block (configura i blocchi Soul Engine per l'identità AI), più strumenti per episodi, procedure, ambienti, conversazioni, ricerca web, generazione di file e altro.
In pratica, l'AI chiama questi strumenti quando l'utente chiede qualcosa di rilevante per la memoria. «Ricorda che preferisco i moduli ESM» → l'AI chiama alma_remember. «Quale stack abbiamo concordato per il nuovo servizio?» → l'AI chiama alma_recall. Il round-trip dello strumento è sub-secondo; l'utente vede solo una risposta leggermente più attenta.
Passo 1. Si registri su alma.olivares.ai. Inizi con il piano Starter ($14/mese) per il livello di ingresso.
Passo 2. In Impostazioni → API Keys, generi una chiave e la copi.
Passo 3. Apra il file di configurazione di Claude Desktop. Su macOS si trova in ~/Library/Application Support/Claude/claude_desktop_config.json; su Windows in %APPDATA%\Claude\claude_desktop_config.json.
Passo 4. Aggiunga il server Alma all'interno dell'oggetto mcpServers: { "alma": { "command": "npx", "args": ["-y", "@olivaresai/alma-mcp"], "env": { "ALMA_API_KEY": "your-key" } } }. Se mcpServers non esiste ancora, lo crei al livello superiore del JSON.
Passo 5. Riavvii Claude Desktop. Gli strumenti Alma appaiono nello slash-menu e Claude può chiamarli autonomamente. Provi: «ricorda che il mio editor preferito è Helix». Un turno dopo: «qual è il mio editor preferito?» — Claude ricorda.
L'UI MCP di Cursor si trova in Impostazioni → Features → MCP. Aggiunga un nuovo server con nome alma, comando npx, args -y @olivaresai/alma-mcp e aggiunga la variabile env ALMA_API_KEY con la Sua chiave. Salvi e riavvii Cursor. Gli strumenti Alma appaiono nell'indicatore di tool-use della chat; sia Composer che la chat inline hanno accesso. Combinato con il contesto di progetto di Cursor, questo dà all'AI sia la consapevolezza del Suo codebase che la memoria persistente cross-progetto.
Windsurf legge le configurazioni MCP da ~/.windsurf/mcp_config.json. La struttura rispecchia Claude Desktop: un oggetto mcpServers con lo stesso blocco Alma. Riavvii Windsurf dopo la modifica. Gli strumenti Alma appaiono poi in Cascade e Windsurf può usarli durante i flussi agentici, particolarmente utile per refactor multi-file in cui vuole che l'AI ricordi le convenzioni delle sessioni precedenti.
Claude Code (il client Claude nativo da terminale) ha la propria configurazione MCP in ~/.config/claude-code/mcp.json. Inserisca lo stesso blocco Alma. Esegua claude mcp list per verificare che il server sia registrato. Una volta collegato, Claude Code può usare gli strumenti di Alma durante le sessioni di programmazione; particolarmente potente quando combinato con la funzione ambienti di Alma in modo che ogni repo abbia il proprio namespace di memoria. Vedi i documenti di integrazione Claude Code per il JSON esatto.
Il server MCP di Alma parla MCP vanilla su stdio, quindi qualsiasi client conforme funziona. Lo schema è sempre lo stesso: il client si aspetta un blocco di configurazione comando + args + env, esegue il server come processo figlio e scopre gli strumenti tramite l'handshake MCP. Se rimane bloccato su un client non elencato, i log del server (imposti ALMA_DEBUG=1 nell'env) Le dicono se l'handshake è riuscito.
Cattura dello stack. Dica all'AI «Sto usando Bun + Hono + D1 per il nuovo servizio»: chiama alma_remember. Due giorni dopo in una conversazione diversa: «crea un route handler per /users»: l'AI ricorda lo stack e produce codice Bun + Hono idiomatico, nessuna spiegazione ripetuta.
Registrazione delle decisioni. «Abbiamo deciso di saltare Redis per l'MVP e usare D1 direttamente.» L'agente salva la decisione con categoria decision e alta importanza. Settimane dopo, durante la revisione dell'architettura, «perché no Redis?» restituisce la decisione originale con la motivazione.
Continuità cross-client. Salvi una memoria in Claude Desktop al mattino, la referenzi da Cursor nel pomeriggio, la interroghi da Claude Code sul terminale di notte. Stesso account Alma, stesso archivio di memoria, ogni client vede tutto.
Sì. Il server MCP di Alma espone anche risorse (dati di sola lettura a cui il client può abbonarsi): soul, memories, environments, conversations, budget, blocks, episodes, procedures e altro. I client che mostrano le risorse MCP (Claude Desktop in particolare) le mostrano in una barra laterale e possono streamare gli aggiornamenti. Può sfogliare l'intero archivio di memoria da dentro Claude Desktop senza aprire un browser.
Il server MCP fa solo ciò che l'AI gli dice di fare, e solo con la Sua API key: non c'è trasmissione implicita. Tutte le scritture di memoria sono limitate al Suo account Alma, cifrate a riposo ed esportabili su richiesta. Il server gira localmente sulla Sua macchina; non fa da proxy attraverso terze parti diverse dall'API Alma stessa. In termini di costo: il server è gratuito da installare; il piano Starter ($14/mese) è il livello di ingresso di Alma e include tutto il necessario per eseguire il server MCP.
Una volta che il server è in esecuzione, la mossa a più alta leva è popolare i blocchi Soul Engine (personalità, competenze, stile di comunicazione, regole rigide) in modo che l'AI abbia un'identità coerente oltre alla memoria fattuale. La web app Alma su alma.olivares.ai espone l'editor Soul; vedi Soul Engine: personalità AI che persiste per lo schema completo.
Letture correlate: Server MCP per memoria AI · Come dare memoria persistente all'AI · Memoria persistente per l'AI: guida completa 2026 · Documentazione server MCP · Integrazione Claude Code.