مايو 2026 · 7 دقائق قراءة · Fran Olivares، مؤسس OlivaresAI
@olivaresai/alma-mcp كخادم، ألصق كتلة JSON واحدة في إعدادات عميل MCP الخاص بك (Claude Desktop، Cursor، Windsurf، Claude Code أو أي عميل متوافق آخر) مع مفتاح API الخاص بـ Alma، وأعد التشغيل. يكشف الخادم 35 أداة ذاكرة يستطيع الذكاء الاصطناعي استدعاءها باستقلال: حفظ ذكرى، بحث في الذكريات، تجميع السياق، استخراج الحقائق، تكوين كتل Soul. إجمالي وقت الإعداد نحو خمس دقائق ويعمل في الطبقة المجانية لـ Alma.Model Context Protocol (MCP) هو المعيار المفتوح الذي يتيح لعملاء الذكاء الاصطناعي التحدث مع أدوات ومصادر بيانات خارجية. حالما يتحدث عميلك MCP، يمكنك توصيل خادم ذاكرة ويكتسب الذكاء الاصطناعي فوراً أدوات للقراءة من والكتابة إلى مخزن ذاكرة دائم — عبر كل محادثة وكل مشروع وكل يوم. يأخذك هذا الدليل عبر إعداد الخمس دقائق للعملاء الأربعة الأكثر شيوعاً في 2026 ويُجيب على الأسئلة التي تأتي بعد ذلك.
عندما يكون خادم Alma MCP متصلاً، يحصل عميل الذكاء الاصطناعي الخاص بك على 35 أداة جديدة يستطيع استدعاءها دون أن تكتب أي شيء. الأكثر أهمية: alma_remember (حفظ حقيقة أو تفضيل)، alma_recall (بحث في الذكريات باستعلام لغة طبيعية)، alma_assemble_context (بناء سياق مهيكل للسؤال الحالي من كل طبقات الذاكرة)، alma_extract (تنقيب الحقائق من كتلة نص)، alma_update_block (تكوين كتل Soul Engine لهوية الذكاء الاصطناعي)، إضافة إلى أدوات للمقاطع والإجراءات والبيئات والمحادثات والبحث الويبي وتوليد الملفات والمزيد.
في الممارسة، ينادي الذكاء الاصطناعي هذه الأدوات عندما يسأل المستخدم شيئاً ذا صلة بالذاكرة. "تذكّر أنني أُفضّل وحدات ESM" → ينادي الذكاء الاصطناعي alma_remember. "ما المكدس الذي اتفقنا عليه للخدمة الجديدة؟" → ينادي الذكاء الاصطناعي alma_recall. ذهاب وإياب الأداة أقل من ثانية؛ يرى المستخدم فقط إجابة أكثر تأنياً قليلاً.
الخطوة 1. سجّل في alma.olivares.ai. ابدأ بخطة Starter ($14/شهرياً) للطبقة المدخل.
الخطوة 2. في الإعدادات ← مفاتيح API، أنشئ مفتاحاً وانسخه.
الخطوة 3. افتح ملف إعدادات Claude Desktop. على macOS يعيش في ~/Library/Application Support/Claude/claude_desktop_config.json؛ على Windows في %APPDATA%\Claude\claude_desktop_config.json.
الخطوة 4. أضف خادم Alma داخل كائن mcpServers: { "alma": { "command": "npx", "args": ["-y", "@olivaresai/alma-mcp"], "env": { "ALMA_API_KEY": "your-key" } } }. إذا لم يكن mcpServers موجوداً بعد، أنشئه في المستوى الأعلى من JSON.
الخطوة 5. أعد تشغيل Claude Desktop. تظهر أدوات Alma في قائمة slash ويستطيع Claude استدعاءها باستقلال. جرّب: "تذكّر أن محرري المفضل هو Helix". في دور لاحق: "ما محرري المفضل؟" — يستحضر Claude.
واجهة MCP في Cursor تعيش في الإعدادات ← الميزات ← MCP. أضف خادماً جديداً باسم alma، وcommand npx، وargs -y @olivaresai/alma-mcp، وأضف متغير env ALMA_API_KEY مع مفتاحك. احفظ وأعد تشغيل Cursor. تظهر أدوات Alma في مؤشر استخدام أدوات المحادثة؛ Composer والمحادثة المُدمَجة كلاهما لهما وصول. مع سياق مشروع Cursor، هذا يُعطي الذكاء الاصطناعي كلاً من الوعي بقاعدة كودك و الذاكرة الدائمة عبر المشاريع.
يقرأ Windsurf إعدادات MCP من ~/.windsurf/mcp_config.json. الهيكل يعكس Claude Desktop: كائن mcpServers بنفس كتلة Alma. أعد تشغيل Windsurf بعد التحرير. تظهر أدوات Alma في Cascade ويستطيع Windsurf استخدامها خلال تدفقات agentic — مفيد بشكل خاص لإعادة هيكلة متعددة الملفات حيث تريد للذكاء الاصطناعي استحضار الاتفاقيات من جلسات سابقة.
Claude Code (عميل Claude الأصلي للطرفية) له إعدادات MCP خاصة به في ~/.config/claude-code/mcp.json. أسقط نفس كتلة Alma. شغّل claude mcp list للتحقق من تسجيل الخادم. حالما يتصل، يستطيع Claude Code استخدام أدوات Alma خلال جلسات البرمجة؛ قوي بشكل خاص مع ميزة بيئات Alma بحيث يكون لكل مستودع مساحة اسم ذاكرة خاصة به. انظر وثائق تكامل Claude Code لـ JSON الدقيق.
يتحدث خادم MCP الخاص بـ Alma MCP عادي عبر stdio، فأي عميل متوافق يعمل. النمط دائماً هو نفسه: يتوقع العميل كتلة إعدادات command + args + env، ويُشغّل الخادم كعملية فرعية، ويكتشف الأدوات عبر مصافحة MCP. إذا علقت على عميل غير مذكور، سجلات الخادم (اضبط ALMA_DEBUG=1 في env) تُخبرك ما إذا نجحت المصافحة.
التقاط المكدس. أخبر الذكاء الاصطناعي "أنا أستخدم Bun + Hono + D1 للخدمة الجديدة" — ينادي alma_remember. بعد يومين في محادثة مختلفة: "اصنع معالج route لـ /users" — يستحضر الذكاء الاصطناعي المكدس وينتج كود Bun + Hono اصطلاحياً، دون إعادة شرح.
تسجيل القرارات. "قررنا تخطي Redis لـ MVP واستخدام D1 مباشرة." يحفظ الوكيل القرار بفئة decision وأهمية عالية. بعد أسابيع عند استعراض المعمارية، "لماذا لا Redis؟" يعيد القرار الأصلي مع المبرر.
استمرارية عبر العملاء. احفظ ذكرى في Claude Desktop في الصباح، أرجع إليها من Cursor في الظهيرة، استعلم عنها من Claude Code على الطرفية في الليل. نفس حساب Alma، نفس مخزن الذاكرة، كل عميل يرى كل شيء.
نعم. خادم Alma MCP يكشف أيضاً موارد (بيانات للقراءة فقط يستطيع العميل الاشتراك بها): soul، memories، environments، conversations، budget، blocks، episodes، procedures، والمزيد. العملاء الذين يعرضون موارد MCP (Claude Desktop خاصة) يُظهرونها في شريط جانبي ويستطيعون بث التحديثات. يمكنك تصفح مخزن الذاكرة الكامل من داخل Claude Desktop دون فتح متصفح.
خادم MCP يفعل فقط ما يُخبره الذكاء الاصطناعي بفعله، وفقط بمفتاح API الخاص بك — لا يوجد بث ضمني. كل كتابات الذاكرة محصورة بحساب Alma الخاص بك، ومُشفّرة في الراحة، وقابلة للتصدير عند الطلب. الخادم يعمل محلياً على جهازك؛ لا يُمرّر عبر أي طرف ثالث غير API الخاص بـ Alma نفسه. من حيث التكلفة: الخادم مجاني للتثبيت؛ خطة Starter ($14/شهرياً) هي طبقة Alma المدخل وتشمل كل ما يلزم لتشغيل خادم MCP.
حالما يعمل الخادم، الحركة الأعلى رافعة هي ملء كتل Soul Engine (شخصية، وخبرة، وأسلوب تواصل، وقواعد صارمة) بحيث يكون للذكاء الاصطناعي هوية متسقة إضافة إلى الذاكرة الواقعية. تطبيق Alma الويبي في alma.olivares.ai يكشف محرر Soul؛ انظر Soul Engine: شخصية ذكاء اصطناعي تثبت للنمط الكامل.
قراءة ذات صلة: خادم MCP لذاكرة الذكاء الاصطناعي · كيف تُعطي الذكاء الاصطناعي ذاكرة دائمة · الذاكرة الدائمة للذكاء الاصطناعي: الدليل الكامل 2026 · وثائق خادم MCP · تكامل Claude Code.