Mayıs 2026 · 7 dk okuma · Fran Olivares, OlivaresAI Kurucusu
@olivaresai/alma-mcp'yi yükleyin, MCP istemci yapılandırmanıza (Claude Desktop, Cursor, Windsurf, Claude Code veya başka uyumlu bir istemci) Alma API anahtarınızla tek bir JSON bloğu yapıştırın ve yeniden başlatın. Sunucu, AI'nin otonom olarak çağırabileceği 35 memory aracı sunar: bir memory kaydet, memories ara, bağlam derle, gerçek çıkar, Soul bloklarını yapılandır. Toplam kurulum süresi yaklaşık beş dakikadır ve ücretsiz Alma katmanında çalışır.Model Context Protocol (MCP), AI istemcilerinin harici araçlar ve veri kaynaklarıyla konuşmasını sağlayan açık standarttır. İstemciniz MCP konuştuğunda, bir memory sunucusu takabilir ve AI hemen kalıcı bir memory deposundan okuma ve yazma araçları kazanır — her konuşma, her proje, her gün boyunca. Bu rehber, 2026'daki en yaygın dört istemci için beş dakikalık kurulumu inceler ve sonradan ortaya çıkan soruları yanıtlar.
Alma MCP sunucusu bağlandığında, AI istemciniz hiçbir şey yazmadan çağırabileceği 35 yeni araç alır. En önemlileri: alma_remember (bir gerçeği veya tercihi kaydet), alma_recall (doğal dil sorgusuyla memories ara), alma_assemble_context (tüm memory katmanlarından mevcut soru için yapılandırılmış bir bağlam oluştur), alma_extract (bir metin bloğundan gerçekleri çıkar), alma_update_block (AI kimliği için Soul Engine bloklarını yapılandır), ayrıca episodes, procedures, environments, conversations, web araması, dosya oluşturma ve daha fazlası için araçlar.
Uygulamada, kullanıcı memory ile ilgili bir şey sorduğunda AI bu araçları çağırır. "ESM modüllerini tercih ettiğimi hatırla" → AI alma_remember'ı çağırır. "Yeni hizmet için hangi yığına karar verdik?" → AI alma_recall'ı çağırır. Araç gidiş-dönüşü saniyenin altındadır; kullanıcı yalnızca biraz daha düşünceli bir yanıt görür.
1. Adım. alma.olivares.ai adresinden kaydolun. Giriş katmanı için Starter planıyla ($14/month) başlayın.
2. Adım. Ayarlar → API Anahtarları'nda bir anahtar oluşturun ve kopyalayın.
3. Adım. Claude Desktop'ın yapılandırma dosyasını açın. macOS'ta ~/Library/Application Support/Claude/claude_desktop_config.json konumunda bulunur; Windows'ta %APPDATA%\Claude\claude_desktop_config.json'da.
4. Adım. mcpServers nesnesinin içine Alma sunucusunu ekleyin: { "alma": { "command": "npx", "args": ["-y", "@olivaresai/alma-mcp"], "env": { "ALMA_API_KEY": "your-key" } } }. mcpServers henüz yoksa, JSON'un en üst düzeyinde oluşturun.
5. Adım. Claude Desktop'ı yeniden başlatın. Alma araçları slash menüsünde görünür ve Claude bunları otonom olarak çağırabilir. Deneyin: "en sevdiğim editörün Helix olduğunu hatırla". Bir sıra sonra: "en sevdiğim editör nedir?" — Claude hatırlar.
Cursor'ın MCP UI'si Ayarlar → Özellikler → MCP'de bulunur. alma adıyla yeni bir sunucu ekleyin, npx komutu, -y @olivaresai/alma-mcp argümanları ve anahtarınızla ALMA_API_KEY ortam değişkenini ekleyin. Kaydedin ve Cursor'ı yeniden başlatın. Alma araçları sohbet araç-kullanım göstergesinde görünür; Composer ve satır içi sohbetin her ikisi de erişime sahiptir. Cursor'ın proje bağlamıyla birleştirildiğinde, bu AI'ye hem kod tabanı farkındalığı hem de kalıcı çapraz proje memory'si verir.
Windsurf MCP yapılandırmalarını ~/.windsurf/mcp_config.json'dan okur. Yapı Claude Desktop'ı yansıtır: aynı Alma bloğuyla bir mcpServers nesnesi. Düzenledikten sonra Windsurf'ü yeniden başlatın. Alma araçları daha sonra Cascade'de görünür ve Windsurf bunları ajansal akışlar sırasında kullanabilir — özellikle önceki oturumlardan kuralları hatırlatmak istediğiniz çoklu dosya yeniden düzenlemeleri için yararlıdır.
Claude Code (terminal yerel Claude istemcisi) kendi MCP yapılandırmasına ~/.config/claude-code/mcp.json'da sahiptir. Aynı Alma bloğunu bırakın. Sunucunun kaydedildiğini doğrulamak için claude mcp list çalıştırın. Bağlandıktan sonra, Claude Code kodlama oturumları sırasında Alma'nın araçlarını kullanabilir; özellikle her repo'nun kendi memory ad alanına sahip olması için Alma environments özelliğiyle birleştirildiğinde güçlüdür. Tam JSON için Claude Code entegrasyon belgelerine bakın.
Alma'nın MCP sunucusu stdio üzerinden düz MCP konuşur, bu nedenle herhangi bir uyumlu istemci çalışır. Örüntü her zaman aynıdır: istemci bir komut + argümanlar + ortam yapılandırma bloğu bekler, sunucuyu alt süreç olarak çalıştırır ve MCP el sıkışması yoluyla araçları keşfeder. Liste dışı bir istemcide takılırsanız, sunucu günlükleri (ortamda ALMA_DEBUG=1 ayarlayın) size el sıkışmasının başarılı olup olmadığını söyler.
Yığın yakalama. AI'ye "yeni hizmet için Bun + Hono + D1 kullanıyorum" deyin — alma_remember'ı çağırır. İki gün sonra farklı bir konuşmada: "/users için bir rota işleyicisi iskelet üret" — AI yığını hatırlar ve deyimsel Bun + Hono kodu üretir, yeniden açıklama yok.
Karar günlüğü. "MVP için Redis'i atlamaya ve doğrudan D1 kullanmaya karar verdik." Ajan kararı decision kategorisi ve yüksek önemle kaydeder. Haftalar sonra mimariyi gözden geçirirken, "neden Redis yok?" orijinal kararı gerekçesiyle döndürür.
Çapraz istemci sürekliliği. Sabah Claude Desktop'ta bir memory kaydedin, öğleden sonra Cursor'dan başvurun, geceleyin terminalde Claude Code'dan sorgulayın. Aynı Alma hesabı, aynı memory deposu, her istemci her şeyi görür.
Evet. Alma'nın MCP sunucusu ayrıca kaynaklar (istemcinin abone olabileceği salt okunur veriler) sunar: soul, memories, environments, conversations, budget, blocks, episodes, procedures ve daha fazlası. MCP kaynaklarını yüzeye çıkaran istemciler (özellikle Claude Desktop) bunları bir kenar çubuğunda gösterir ve güncellemeleri yayınlayabilir. Tüm memory deposunu bir tarayıcı açmadan Claude Desktop'ın içinden tarayabilirsiniz.
MCP sunucusu yalnızca AI'nin söylediğini ve yalnızca sizin API anahtarınızla yapar — örtük yayın yoktur. Tüm memory yazımları Alma hesabınıza kapsamlandırılmıştır, saklanırken şifrelenir ve talep üzerine dışa aktarılabilir. Sunucu makinenizde yerel olarak çalışır; Alma API'sinin kendisinden başka herhangi bir üçüncü taraf üzerinden proxy yapmaz. Maliyet açısından: sunucuyu yüklemek ücretsizdir; Starter planı ($14/mo) Alma'nın giriş katmanıdır ve MCP sunucusunu çalıştırmak için ihtiyaç duyulan her şeyi içerir.
Sunucu çalıştığında, en yüksek kaldıraçlı hareket Soul Engine bloklarını (kişilik, uzmanlık, iletişim üslubu, sert kurallar) doldurmaktır; böylece AI faktör memory'sine ek olarak tutarlı bir kimliğe sahip olur. alma.olivares.ai adresindeki Alma web uygulaması Soul editörünü açığa çıkarır; tam örüntü için Soul Engine: Kalıcı AI Kişiliği'na bakın.
İlgili okuma: AI Memory için MCP Sunucusu · AI'ye Kalıcı Memory Nasıl Verilir · AI için Kalıcı Memory: Eksiksiz 2026 Rehberi · MCP Sunucu belgeleri · Claude Code entegrasyonu.