Mei 2026 · 7 min leestijd · Fran Olivares, oprichter van OlivaresAI
@olivaresai/alma-mcp als server, plakt u één JSON-blok in de configuratie van uw MCP-client (Claude Desktop, Cursor, Windsurf, Claude Code of een andere compatibele client) met uw Alma API-sleutel, en herstart u. De server biedt 35 geheugentools die de AI autonoom kan aanroepen: een herinnering opslaan, herinneringen doorzoeken, context samenstellen, feiten extraheren, Soul-blokken configureren. Totale installatietijd is ongeveer vijf minuten en werkt op de gratis Alma-laag.Het Model Context Protocol (MCP) is de open standaard waarmee AI-clients kunnen communiceren met externe tools en gegevensbronnen. Zodra uw client MCP spreekt, kunt u een geheugenserver aansluiten en krijgt de AI direct tools om uit een permanente geheugenopslag te lezen en ernaar te schrijven — over elk gesprek, elk project en elke dag heen. Deze gids doorloopt de installatie van vijf minuten voor de vier meest voorkomende clients in 2026 en beantwoordt de vragen die daarna opkomen.
Wanneer de Alma MCP-server is verbonden, krijgt uw AI-client 35 nieuwe tools die hij kan aanroepen zonder dat u iets typt. De belangrijkste: alma_remember (sla een feit of voorkeur op), alma_recall (zoek herinneringen op een natuurlijke taal-query), alma_assemble_context (bouw een gestructureerde context op voor de huidige vraag uit alle geheugenlagen), alma_extract (haal feiten uit een tekstblok), alma_update_block (configureer Soul Engine-blokken voor AI-identiteit), plus tools voor episodes, procedures, omgevingen, gesprekken, webzoekopdrachten, bestandsgeneratie en meer.
In de praktijk roept de AI deze tools aan wanneer de gebruiker iets vraagt dat geheugenrelevant is. „Onthoud dat ik de voorkeur geef aan ESM-modules" → de AI roept alma_remember aan. „Welke stack hebben we afgesproken voor de nieuwe service?" → de AI roept alma_recall aan. De tool-roundtrip duurt minder dan een seconde; de gebruiker ziet alleen een iets meer doordacht antwoord.
Stap 1. Registreer u op alma.olivares.ai. Begin met het Starter-abonnement ($14/maand) voor het instapniveau.
Stap 2. Genereer in Instellingen → API Keys een sleutel en kopieer deze.
Stap 3. Open het configuratiebestand van Claude Desktop. Op macOS staat het op ~/Library/Application Support/Claude/claude_desktop_config.json; op Windows op %APPDATA%\Claude\claude_desktop_config.json.
Stap 4. Voeg de Alma-server toe binnen het mcpServers-object: { "alma": { "command": "npx", "args": ["-y", "@olivaresai/alma-mcp"], "env": { "ALMA_API_KEY": "your-key" } } }. Als mcpServers nog niet bestaat, maak het dan aan op het topniveau van de JSON.
Stap 5. Herstart Claude Desktop. De Alma-tools verschijnen in het slash-menu en Claude kan ze autonoom aanroepen. Probeer: „onthoud dat mijn favoriete editor Helix is". Een beurt later: „wat is mijn favoriete editor?" — Claude haalt het op.
De MCP-UI van Cursor staat in Instellingen → Features → MCP. Voeg een nieuwe server toe met naam alma, command npx, args -y @olivaresai/alma-mcp, en voeg de env-variabele ALMA_API_KEY met uw sleutel toe. Sla op en herstart Cursor. De Alma-tools verschijnen in de chat-tool-indicator; zowel Composer als de inline chat hebben toegang. Gecombineerd met de projectcontext van Cursor geeft dit de AI zowel bewustzijn van uw codebase als permanent cross-project geheugen.
Windsurf leest MCP-configuraties uit ~/.windsurf/mcp_config.json. De structuur is identiek aan Claude Desktop: een mcpServers-object met hetzelfde Alma-blok. Herstart Windsurf na het bewerken. De Alma-tools verschijnen vervolgens in Cascade en Windsurf kan ze gebruiken tijdens agentische workflows — vooral nuttig voor multi-file refactors waar u de AI conventies wilt laten ophalen uit eerdere sessies.
Claude Code (de terminal-native Claude-client) heeft zijn eigen MCP-configuratie op ~/.config/claude-code/mcp.json. Plak hetzelfde Alma-blok erin. Voer claude mcp list uit om te verifiëren dat de server is geregistreerd. Eenmaal verbonden kan Claude Code de tools van Alma gebruiken tijdens codeersessies; bijzonder krachtig in combinatie met de Alma environments-functie zodat elke repository zijn eigen geheugen-namespace heeft. Zie de documentatie voor Claude Code-integratie voor de exacte JSON.
De Alma MCP-server spreekt standaard MCP via stdio, dus elke compatibele client werkt. Het patroon is altijd hetzelfde: de client verwacht een command + args + env-configuratieblok, voert de server uit als een child-process en ontdekt tools via de MCP-handshake. Als u vastloopt op een niet-vermelde client, vertellen de serverlogboeken (zet ALMA_DEBUG=1 in de env) u of de handshake is geslaagd.
Stack vastleggen. Vertel de AI „Ik gebruik Bun + Hono + D1 voor de nieuwe service" — hij roept alma_remember aan. Twee dagen later in een ander gesprek: „bouw een route handler voor /users" — de AI haalt de stack op en produceert idiomatische Bun + Hono-code, zonder opnieuw uitleggen.
Beslissingen vastleggen. „We hebben besloten Redis over te slaan voor de MVP en D1 direct te gebruiken." De agent slaat de beslissing op met categorie decision en hoge belangrijkheid. Weken later bij het herzien van de architectuur retourneert „waarom geen Redis?" de oorspronkelijke beslissing met motivering.
Cross-client continuïteit. Sla 's ochtends een herinnering op in Claude Desktop, refereer er 's middags aan vanuit Cursor, vraag het 's nachts op vanuit Claude Code op de terminal. Hetzelfde Alma-account, dezelfde geheugenopslag, elke client ziet alles.
Ja. De Alma MCP-server biedt ook resources (alleen-lezen gegevens waarop de client zich kan abonneren): soul, memories, environments, conversations, budget, blocks, episodes, procedures en meer. Clients die MCP-resources presenteren (met name Claude Desktop) tonen deze in een zijbalk en kunnen updates streamen. U kunt de hele geheugenopslag doorbladeren vanuit Claude Desktop zonder een browser te openen.
De MCP-server doet alleen wat de AI hem opdraagt, en alleen met uw API-sleutel — er is geen impliciete uitzending. Alle geheugen-schrijfacties zijn beperkt tot uw Alma-account, versleuteld in rust en op verzoek exporteerbaar. De server draait lokaal op uw machine; hij stuurt niet door via een derde partij anders dan de Alma API zelf. Wat de kosten betreft: de server is gratis te installeren; het Starter-abonnement ($14/maand) is het instapabonnement van Alma en bevat alles wat nodig is om de MCP-server uit te voeren.
Zodra de server draait, is de volgende meest waardevolle stap het invullen van Soul Engine-blokken (persoonlijkheid, expertise, communicatiestijl, harde regels) zodat de AI een consistente identiteit heeft naast feitelijk geheugen. De Alma-web-app op alma.olivares.ai stelt de Soul-editor beschikbaar; zie Soul Engine: AI-persoonlijkheid die blijft bestaan voor het volledige patroon.
Verwante lectuur: MCP-server voor AI-geheugen · Hoe u AI permanent geheugen geeft · Permanent geheugen voor AI: complete gids 2026 · MCP-server documentatie · Claude Code-integratie.