أفضل خادم MCP لربط Obsidian مع Claude: الإعداد والخيارات

Claude ذكي، لكنه لم يرَ ملاحظاتك قط. اسأله عن ملاحظات اجتماع الربع الماضي أو عن المقال نصف المكتوب المدفون في خزنتك، وسيكتفي بالتخمين. يسدّ خادم Obsidian MCP هذه الفجوة. فهو يفتح بوابة مضبوطة إلى ملفات markdown الخاصة بك، فيستطيع Claude البحث في الملاحظات وقراءتها وكتابتها، بينما تبقى أنت المتحكم في ما يمسّه.

المشكلة في كثرة الخيارات. هناك أكثر من اثني عشر خادمًا، وقد تغيّرت أسماء الحزم والإضافات والمنافذ كثيرًا خلال عام 2026. يحدد هذا المقال الخادم الذي يستحق وقتك، ويشرح الإعداد الدقيق لـ Claude Desktop وClaude Code، ويُنبّه إلى الأخطاء التي تُضيّع بعد الظهر كاملًا. الخلاصة السريعة: اختر mcpvault لبدء سريع بلا إضافة، وانتقل إلى خادم قائم على REST مثل obsidian-mcp-server من cyanheads عندما تريد أن يكون Obsidian نفسه جزءًا من العملية.

💡 الحكم السريع: لا تحتاج إلى إضافة ولا إلى تطبيق مفتوح؟ استخدم خادم نظام الملفات. تريد الملاحظة النشطة والأوامر والملاحظات الدورية؟ استخدم خادم Local REST API.

ما الذي يفعله خادم Obsidian MCP؟

MCP اختصار لعبارة Model Context Protocol، وهو البروتوكول المفتوح الذي قدّمته Anthropic لتتمكن تطبيقات الذكاء الاصطناعي من الوصول إلى أدوات خارجية عبر برامج صغيرة تسمى servers (خوادم). خادم Obsidian MCP واحد من هذه البرامج. يقع بين Claude وخزنتك، وهي مجلد عادي من ملفات markdown، ويعرض قائمة قصيرة من الأدوات: عرض الملفات، وقراءة ملاحظة، والبحث، وإلحاق النص، وتعديل قسم، وفي بعض الخوادم نقل الملاحظات أو حذفها.

كيف يقرأ Claude خزنتك

عندما تطرح سؤالًا، يقرر Claude إن كان استدعاء أداة سيفيد. اكتب "ابحث عن ملاحظاتي حول تجربة التسعير"، فيستدعي أداة البحث، ويتلقى مسارات الملفات والمقتطفات، ثم يستدعي أداة القراءة على أفضل النتائج. يعمل الخادم على جهازك أنت، ويطلب Claude Desktop موافقتك قبل أن يستخدم أي أداة.

ومن الأمور التي يجب تذكرها أن أي ملاحظة يقرؤها Claude تصبح جزءًا من المحادثة، أي أن هذا النص يُرسل إلى Anthropic للمعالجة. أبقِ المواد الخاصة فعلًا خارج المجلد الذي تعرضه.

نظام الملفات مقابل Local REST API

تنتمي كل خوادم Obsidian إلى أحد تصميمين، واختيارك بينهما يحدد كل ما بعده:

• خوادم نظام الملفات تقرأ ملفات .md وتكتبها مباشرة. تحتاج إلى مسار الخزنة فقط، وتعمل والتطبيق مغلق، وتُثبَّت في سطر واحد. لا ترى الحالة الحية لـ Obsidian، مثل الملاحظة المفتوحة حاليًا.
• خوادم Local REST API تتواصل مع Obsidian عبر الإضافة المجتمعية المسماة Local REST API. تستطيع الوصول إلى الملاحظة النشطة، وتشغيل أوامر Obsidian، واستخدام الملاحظات الدورية، لكن يجب أن يكون Obsidian قيد التشغيل وأن تزوّد الرمز المميز (token) من الإضافة.

أفضل الخوادم مقارنةً

تتغير قوائم الدليل أسبوعيًا، لذلك لن أعتمد على عدد النجوم، بل سأقارن ما يؤثر فعلًا في إعدادك. تحقق من README كل مشروع قبل نسخ أي أمر، فقد أعادت عدة مشاريع تسمية حزمها أو أصدرت إصدارات غير متوافقة مع السابق هذا العام.

مقارنة جنبًا إلى جنب

💡 فخ الأسماء: حزمة npm التي كانت تُسمى mcp-obsidian أُعيدت تسميتها إلى @bitbonsai/mcpvault في وقت سابق من عام 2026. قد تُوجّهك الدروس القديمة التي تستخدم الاسم القديم إلى الحزمة الخطأ، لذلك انسخ الأسماء من README الحالي.

mcpvault لإعداد سهل

mcpvault هو أقصر طريق من الصفر إلى اتصال عامل بالخزنة. تمرّر وسيطًا واحدًا، هو مسار الخزنة، فيقرأ الملفات مباشرة. وإذا حذفت المسار استخدم مجلد العمل الحالي، وهو مفيد عندما تشغّل Claude Code من داخل الخزنة. تغطي أدواته قراءة الملاحظات وكتابتها، وتعديلات على شكل تصحيحات، والبحث، وfrontmatter، والوسوم، رغم أن README يحتفظ بالقائمة الحالية.

ولأنه لا يمسّ واجهة Obsidian البرمجية أبدًا، يمكن أن يبقى التطبيق مغلقًا، ويظل سريعًا مع خزنة تضم آلاف الملاحظات. الثمن أنه لا يستطيع تشغيل أوامر Obsidian ولا يعرف الملاحظة التي تنظر إليها.

cyanheads للاستخدام المكثف

obsidian-mcp-server من cyanheads مكتوب بلغة TypeScript ويتصل عبر إضافة Local REST API. وقد سجّل أعلى عدد من التنزيلات الأسبوعية على npm في قوائم الدليل التي راجعتها، وأدخل أحد إصداراته الأخيرة توافقًا مع الإصدار 4 من الإضافة. ويذكر README الخاص به البحث العام، والبحث والاستبدال داخل الملاحظة، وإدارة frontmatter والوسوم.

اختره عندما يكون Claude شريكًا يوميًا لا تجربة عابرة. تدفع ثمن هذا العمق بعنصر متحرك إضافي: الإضافة ورمزها المميز ونافذة Obsidian قيد التشغيل.

خوادم REST للميزات الحية

mcp-obsidian من MarkusPfundstein هو الخيار المكتوب بلغة Python. تشغّله بالأمر uvx، فيتصل بالإضافة على 127.0.0.1 عبر منفذ HTTPS رقم 27124. وتشمل أدواته البحث، وإلحاق النص بملاحظة، وترقيع المحتوى تحت عنوان محدد. كان المشروع هادئًا لفترة طويلة قبل أن يعود مشرفه في مايو 2026، لذا انظر إلى الالتزامات الحديثة قبل أن تعتمد عليه.

يستحق خياران آخران النظر. Obsidian MCP Tools يُثبَّت من داخل Obsidian ويضيف بحثًا دلاليًا عبر Smart Connections مع دعم Templater. وتأتي الإصدارات الأحدث من Local REST API نفسها بنقطة وصول MCP مدمجة، ما يعني أنك قد تستطيع توجيه Claude مباشرة إلى الإضافة دون أي برنامج Node أو Python بينهما. تحقق من ملاحظات إصدار الإضافة لمعرفة العنوان الدقيق.

اختياري حسب الحالة:

1. تريد أن يعمل خلال خمس دقائق: mcpvault.
2. تستخدم Obsidian طوال اليوم وتريد أدوات غنية: cyanheads.
3. تعمل أصلًا ضمن أدوات Python: mcp-obsidian.
4. تريد أقل عدد من البرامج المثبتة: نقطة الوصول المدمجة في الإضافة، إن كان إصدارك يدعمها.

الإعداد لـ Claude Desktop

قبل أن تلمس أي ملف إعدادات، تحقق من ثلاثة أمور. يجب تثبيت Node.js (الإصدار LTS الحالي) إذا كنت ستستخدم خادم npx، أو uv إذا كنت ستستخدم uvx. ويجب أن يكون Claude Desktop مثبتًا ومسجّلًا للدخول. ويجب أن تعرف المسار المطلق إلى خزنتك، مثل /Users/you/Documents/MyVault أو C:\Users\you\Documents\MyVault.

بالنسبة لخادم REST تحتاج أيضًا إلى الإضافة. في Obsidian افتح Settings، ثم Community plugins، ثم Browse، وابحث عن Local REST API، وثبّتها وفعّلها، ثم انسخ الرمز المميز الظاهر في صفحة إعداداتها. تستمع الإضافة على منفذ HTTPS رقم 27124 بشهادة موقّعة ذاتيًا. يوجد منفذ HTTP رقم 27123 لكنه معطّل افتراضيًا.

تعديل ملف الإعدادات

في Claude Desktop افتح Settings، ثم Developer، ثم Edit Config. سيفتح ذلك الملف claude_desktop_config.json، الموجود في ~/Library/Application Support/Claude/ على macOS وفي %APPDATA%\Claude\ على Windows. أضف mcpvault بهذا الشكل:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["@bitbonsai/mcpvault@latest", "/Users/you/Documents/MyVault"]
    }
  }
}

نسخ الأمر النصي

على Windows ضاعف الشرطات المائلة الخلفية في المسار: "C:\\Users\\you\\Documents\\MyVault". احفظ الملف، ثم أغلق Claude Desktop بالكامل (من شريط القوائم أو من منطقة الإشعارات، لا من النافذة فقط) وأعد فتحه. يجب أن تعرض أيقونة الأدوات في مربع الدردشة الآن أدوات Obsidian.

💡 نصيحة PATH: لا يرث Claude Desktop متغير PATH من الصدفة (shell) لديك. إذا فشل الخادم في البدء، فاستبدل npx بالمسار المطلق الذي تطبعه which npx على macOS أو where npx على Windows.

توصيل خادم REST

يستخدم خادم REST الملف نفسه بإدخال مختلف. هذا هو شكل mcp-obsidian:

{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": ["mcp-obsidian"],
      "env": {
        "OBSIDIAN_HOST": "127.0.0.1",
        "OBSIDIAN_PORT": "27124"
      }
    }
  }
}

نسخ الأمر النصي

أضف إدخالًا آخر إلى كتلة env: رمز الإضافة المميز، تحت اسم المتغير الدقيق الذي يذكره README الخاص بالخادم. تختلف الأسماء بين المشاريع، ولهذا لن أخمّن اسمًا هنا. أبقِ Obsidian مفتوحًا أثناء الدردشة، لأن الخادم يصل إلى خزنتك عبر الإضافة.

الإعداد لـ Claude Code

يضيف Claude Code الخوادم من الطرفية، دون تعديل أي ملف JSON.

تثبيت بأمر واحد

بالنسبة لـ mcpvault:

claude mcp add obsidian --scope user -- npx @bitbonsai/mcpvault@latest /path/to/vault

نسخ الأمر النصي

تجعل العلامة --scope user الخادم متاحًا في كل المشاريع. أما النطاق المحلي الافتراضي فيحصره في المشروع الحالي، ويكتب نطاق المشروع ملف .mcp.json قد تضعه في git. لا تضع أبدًا رمزًا مميزًا في .mcp.json مشترك.

بالنسبة لخادم REST، مرّر قيم البيئة باستخدام -e:

claude mcp add obsidian --scope user -e OBSIDIAN_HOST=127.0.0.1 -e OBSIDIAN_PORT=27124 -- uvx mcp-obsidian

نسخ الأمر النصي

أضف الرمز المميز للإضافة بالطريقة نفسها، مستخدمًا اسم المتغير من README.

التحقق واختبار الأوامر النصية

شغّل claude mcp list لترى إن كان الخادم يظهر متصلًا، أو اكتب /mcp داخل الجلسة. ثم جرّب أوامر نصية تثبت أن كل أداة تعمل:

• "اعرض الملاحظات العشر الأحدث تغييرًا ولخّص كل واحدة في سطر واحد."
• "ابحث عن الملاحظات التي تذكر تجربة التسعير، وصِغ منها تحديثًا للحالة."
• "أضف قرارات اليوم الثلاثة إلى ملاحظتي اليومية تحت عنوان اسمه Decisions."
• "ابحث عن الملاحظات التي تذكر شخصًا بالاسم لكنها لا تربط أبدًا بصفحته."

يستطيع الفريق مشاركة خزنة واحدة عبر مجلد متزامن، ويضيف كل شخص الخادم على جهازه. اقصر صلاحية الكتابة على من يحتاجونها.

عادات آمنة قبل منح صلاحية الكتابة

صلاحية القراءة منخفضة الخطورة. أما الكتابة فليست كذلك، لأن تعليمة مفهومة بشكل خاطئ قد تكتب فوق ملاحظة أو تحذف ملفًا. تزيل بضع عادات معظم الخطر.

النسخ الاحتياطي أولًا

حوّل الخزنة إلى مستودع git باستخدام إضافة Obsidian Git، أو تأكد من تفعيل سجل إصدارات Obsidian Sync، أو على الأقل انسخ المجلد إلى قرص ثانٍ. ثم اختبر الاستعادة مرة واحدة. النسخة الاحتياطية التي لم تستعدها قط أمنية، لا نسخة احتياطية.

وافق على أدوات الكتابة والحذف استدعاءً تلو الآخر حتى تثق بسلوكها. اقرأ التغيير المقترح قبل أن تضغط Allow.

حدّد ما يمسّه Claude

تقبل خوادم نظام الملفات أي مسار لمجلد، لذلك وجّهها إلى مجلد فرعي مخصص بدلًا من الخزنة كلها. أبقِ اليوميات والمسودات الخاصة خارجه. وخزّن الرموز المميزة في إعداداتك المحلية فقط، لا في أي مستودع.

إصلاح أعطال الإعداد الشائعة

تفشل معظم المحاولات الأولى لأسباب بسيطة. اعمل على هذه الأمور بالترتيب.

الخادم يظهر بحالة فشل

• Node أو uv غير مثبت. شغّل node --version أو uv --version في الطرفية.
• PATH خاطئ. استخدم المسار المطلق إلى npx أو uvx في الإعدادات.
• اسم حزمة قديم. استبدل mcp-obsidian على npm بـ @bitbonsai/mcpvault.
• JSON معطوب. ابحث عن فاصلة زائدة في النهاية، أو علامة اقتباس ناقصة، أو شرطات مائلة خلفية مفردة في مسار Windows.
• تطبيق قديم. أغلق Claude Desktop بالكامل وأعد فتحه.

إذا لم يفد شيء، فافتح ملفات سجل MCP. على macOS تقع في ~/Library/Logs/Claude/، وعلى Windows في %APPDATA%\Claude\logs. عادةً ما تذكر آخر بضعة أسطر المشكلة بدقة.

أخطاء المنفذ والشهادة

تضيف خوادم REST أعطالها الخاصة. يجب أن يكون Obsidian قيد التشغيل والإضافة مفعّلة. تعني استجابة 401 أو 403 أن الرمز المميز لا يطابق، فانسخه من جديد دون مسافة زائدة في النهاية. وخطأ الشهادة على المنفذ 27124 مصدره الشهادة الموقّعة ذاتيًا للإضافة: اتبع README الخاص بالخادم لمعرفة كيفية الوثوق بها، أو فعّل منفذ HTTP رقم 27123 في إعدادات الإضافة واستخدمه على localhost فقط. وإذا كان برنامج آخر يشغل المنفذ، فغيّره في الإضافة وفي كتلة env معًا.

اكتب مسودات الملاحظات مع Claude على PicassoIA

يعمل MCP داخل Claude Desktop و Claude Code، لذلك لا تستطيع أداة متصفح أن تحل محله. ما يضيفه PicassoIA هو النصف الآخر من العمل: كتابة النص وتنظيفه قبل وصوله إلى خزنتك، دون أي شيء للتثبيت. Claude Sonnet 5 خيار مناسب، وClaude Opus 4.7 وClaude 4.5 Haiku يتعاملان مع المهام الأثقل والأخف.

كيفية استخدام Claude Sonnet 5 على PicassoIA:

1. افتح صفحة Claude Sonnet 5.
2. الصق مادتك الخام في Prompt: نصًا مكتوبًا بسرعة، أو نقاطًا متفرقة، أو ملف بحث مبعثرًا. ثم اذكر تنسيق الملاحظة الذي تريده.
3. املأ System Prompt مرة واحدة بقواعد خزنتك، مثل frontmatter بصيغة YAML، والروابط الداخلية (wikilinks) للأشخاص، وأسلوب العناوين لديك.
4. اختر مستوى Effort، ثم شغّل النموذج.
5. انسخ النتيجة إلى Obsidian، أو سلّمها إلى Claude المتصل بخادم MCP لديك ليحفظها في المجلد الصحيح.

💡 حقل الصورة مفيد للبحث: صوّر سبورة بيضاء، ودع Claude يحوّلها إلى ملاحظة منظمة، ثم احفظها في خزنتك.

أنشئ صورك الخاصة على PicassoIA

تصبح الخزنة المليئة بالنصوص أسهل في التصفح عندما تحمل الملاحظات عنصرًا بصريًا. صورة غلاف لملاحظة مشروع، أو لوحة مزاج لموجز تصميم، أو مشهد واقعي لمسودة قصة: كل ذلك يحتاج إلى أمر نصي قصير وبضع ثوانٍ على Picasso IA.

جرّب Seedream 4.5 للمشاهد التفصيلية المصقولة، وGPT Image 2 عندما يكون الأمر طويلًا ومحددًا، وFLUX 2 Pro للتصوير الفوتوغرافي الواقعي الحاد، أو P-Image عندما تريد نتائج سريعة. صِف الموضوع والإضاءة والعدسة، واجعل صياغتك ملموسة بقدر قائمة لقطات المصوّر.

اضبط خادم Obsidian MCP هذا الأسبوع، ثم افتح Picasso IA وأنشئ أول صورة لخزنتك الخاصة. جرّب بضعة أوامر نصية، واحتفظ بما يناسب ملاحظاتك، وابنِ عادة بصرية بجانب العادة الكتابية.