اربط Claude Code بقاعدة معرفة مشفّرة عبر MCP

Knowtarium قاعدة معرفة مشفّرة تشفيرًا تامًا بين الطرفين، يعمل فيها الناس ووكلاء الذكاء الاصطناعي الذين يختارونهم. ويتصل بها Claude Code عبر MCP، من خلال خادم صغير يعمل على حاسوبك ويفك تشفير الملاحظات عليه. وبعد ربطه، يصبح Claude Code قادرًا على:

• البحث في ملاحظاتك وقراءتها، وتتبّع الروابط بينها والعثور على ما يتصل بها، داخل مساحة العمل والمجلدات التي منحته إياها.
• إنشاء الملاحظات وتعديلها. يُحفظ كل تغيير فورًا، موقّعًا بمفتاح Claude Code نفسه، ويبقى في السجل، فترى ما فعله وتتراجع عنه بنقرة واحدة.
• اتباع تعليمات مجلداتك. ما تكتبه في التطبيق لمساحة عمل أو مجلد (ملف AGENTS.md) يصل إلى Claude Code أينما قرأ أو كتب هناك. ويمكنه أن يقترح تعديلات على هذه التعليمات، لكنه لا يجريها بنفسه أبدًا.
• انتظار موافقتك حيث تريد. فعّل المراجعة («Ask me first») لمساحة عمل أو مجلد، فتنتظر تعديلات Claude Code على الملاحظات هناك في صورة فروقات، لتقبلها أو ترفضها. أما تغييرات المجلدات هناك فتُرفض، ويخبرك Claude Code بما كان سيغيّره.
• نقل الملاحظات أو حذفها وتغيير المجلدات، إن منحته هذه الصلاحيات فقط، وتعليماته ألا يفعل ذلك إلا إذا طلبته منه في المحادثة.

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

تحتاج إلى Node.js 20 أو أحدث (ونوصي بالإصدار 22 أو 24)، وإلى حساب مجاني في Knowtarium. افتح الطرفية وشغّل الأمر من مجلدك الرئيسي. والسبب أن npx يثق بالمجلد الذي يعمل فيه، فلو شغّلته داخل مشروع، لاستطاعت ملفات ذلك المشروع أن تحل محل ملفات Knowtarium.

$ cd ~                          # مجلدك الرئيسي، لا مجلد مشروع$ npx knowtarium connect
Opening the browser to connect this computer to Knowtarium.
Connected to workspace ws_8f2k (read and write).
Add Knowtarium to which agents? Claude Code
added to Claude Code (/Users/you/.claude.json)
  previous file saved as /Users/you/.claude.json.knowtarium-backup-<time>

1. وافق على هذا الحاسوب. يُفتح Knowtarium في متصفحك. سمِّ الوكيل، واختر ما يمكنه الوصول إليه (انظر أدناه)، ثم انقر Allow، بشرط أن تكون أنت من شغّل الأمر. وإن كنت تعمل عبر SSH، حيث لا يصل المتصفح إلى الطرفية، فستؤكد بدلًا من ذلك رمزًا يظهر متطابقًا في المكانين.
2. اختر الوكلاء. تعرض الأداة الوكلاء الذين وجدتهم على حاسوبك، وكلهم محدَّدون. اضغط Enter لإضافة Knowtarium إليهم جميعًا، أو ألغِ تحديد بعضهم أولًا (الأسهم للتنقل، والمسافة للتحديد أو الإلغاء، وa لتحديد الكل أو إلغائه، وEsc لعدم إضافة أي وكيل).
3. يُضاف Knowtarium إلى Claude Code. تكتبه الأداة في إعدادات المستخدم في Claude Code، في الملف ~/.claude.json (أو في $CLAUDE_CONFIG_DIR إن كنت ضبطته). ولا تمس خوادمك وإعداداتك الأخرى، وتحفظ نسخة احتياطية من الملف السابق بجواره. ويشغّل هذا الإدخال الخادم من مجلدك الرئيسي دائمًا، لا من المشروع المفتوح في Claude Code.
4. أعد تشغيل Claude Code. فهو لا يتعرّف على الخوادم الجديدة إلا عند بدء تشغيله، لذا أغلق أي جلسة مفتوحة وابدأها من جديد.

لا يُكتب في إعدادات Claude Code أي كلمة سر أو رمز وصول أو مفتاح. فالاتصال محفوظ مشفّرًا، ومفتاحه في سلسلة مفاتيح نظامك (أو في ملف لا يقرؤه غيرك إن لم تتوفر سلسلة مفاتيح). وإن أردت أن ترى ما ستغيّره الأداة قبل أن تكتب أي شيء، فشغّل npx knowtarium agents --dry-run. والأداة مفتوحة المصدر، وشيفرتها على GitHub.

(تُفتح بحجمها الكامل في علامة تبويب جديدة) (تُفتح بحجمها الكامل في علامة تبويب جديدة)

تضم إضافة Knowtarium خادم MCP نفسه، مقيّدًا بإصدار مُختبَر من knowtarium، ومعه مهارة (skill) للعمل داخل مساحة عمل Knowtarium (knowtarium-conventions). وتحتاج هي أيضًا إلى Node.js 20 أو أحدث، وأداة الإطلاق فيها تشغّل الخادم من مجلدك الرئيسي. في Claude Code:

/plugin marketplace add Knowtarium/knowtarium-plugins/plugin install knowtarium@knowtarium

في Claude Code 2.1.275 أو أحدث، يكفي سطر واحد للخطوتين:

/plugin install knowtarium --marketplace Knowtarium/knowtarium-plugins

ومن الطرفية، في Claude Code 2.1.292 أو أحدث:

$ claude plugin install knowtarium --marketplace Knowtarium/knowtarium-plugins

بعدها اربط هذا الحاسوب مرة واحدة. اطلب من Claude أن يربط Knowtarium، فيُفتح متصفحك لتوافق على هذا الحاسوب. أو شغّل الأمر مع --no-agents من مجلدك الرئيسي: فالإضافة تشغّل الخادم أصلًا، ومن دون هذا الخيار سيضيف الأمر خادمًا ثانيًا.

$ cd ~$ npx knowtarium connect --no-agents

الإضافة أم أمر الربط؟

في الحالتين يحصل Claude Code على الأدوات نفسها، ومعها قواعد العمل نفسها. اختر طريقة واحدة: إن كانت الإضافة مثبّتة، يترك الأمر Claude Code دون تحديد كي لا يعمل الخادم مرتين. أما إن شغّلت الأمر أولًا ثم ثبّتَّ الإضافة، فستواصل الأداة تحديث إدخالها هي، فيعمل خادم ثانٍ. ولتُبقي على خادم الإضافة وحده، شغّل claude mcp remove --scope user knowtarium.

الصفحة التي يفتحها الأمر هي التي تحدد صلاحيات هذا الاتصال. وكل صلاحية تخص هذا الوكيل وحده، ويفرضها الخادم:

• مساحة عمل واحدة. يصل كل اتصال إلى مساحة عمل واحدة فقط. ولتمنح Claude Code مساحة أخرى، شغّل npx knowtarium connect مرة أخرى، واختر المساحة الأخرى، ثم أعد تشغيل Claude Code. ويبقى الاتصال الأول كما هو.
• مجلدات بعينها، إن أردت. حدّد المجلدات التي يحتاجها فقط. وسيقرأ أيضًا تعليمات المجلدات التي تعلوها، لكنه لا يستطيع اقتراح تغييرات عليها.
• قراءة فقط، أو قراءة وكتابة. ابدأ بالقراءة فقط إن كان كل ما تريده إجابات من ملاحظاتك.
• ما يتجاوز التعديل، فقط إن حدّدته. نقل الملاحظات، وحذفها، وإنشاء المجلدات وإعادة تسميتها ونقلها وحذفها: ست صلاحيات منفصلة، كلها معطّلة افتراضيًا.

ويمكنك تغيير ذلك كله لاحقًا في التطبيق من Settings ثم Agents، وتوقّع الصلاحيات الجديدة في كل مرة. وإذا ألغيت وصول Claude Code من هناك، ينقطع فورًا، وتحصل مساحة العمل على مفتاح جديد، فلا يستطيع قراءة أي شيء يُكتب بعد ذلك. ومن الطرفية، يلغي npx knowtarium disconnect وصول هذا الحاسوب ويحذف مفاتيحه وذاكرته المؤقتة المحلية.

لدى Claude Code ذاكرة أصلًا: ملف CLAUDE.md تكتبه أنت ويُحمَّل في كل جلسة، وذاكرة تلقائية يكتبها هو وتبقى على جهاز واحد. كلاهما يصلح لشرح طريقة العمل في مشروع، لكن لا يصلح أيٌّ منهما موطنًا للمعرفة نفسها: القرارات، والأبحاث، وملاحظات الاجتماعات، والحقائق التي يعتمد عليها أكثر من وكيل وأكثر من شخص.

وهنا يأتي دور قاعدة المعرفة. أبقِ قواعد مشروعك في CLAUDE.md، ودع Claude Code يبحث في Knowtarium ويدوّن فيه ما يتعلمه، حيث يرى كل وكيل آخر تربطه الملاحظات نفسها. ويشرح دليلنا العقل الثاني مع Claude Code ملف CLAUDE.md والذاكرة التلقائية بالتفصيل.

لا تحتاج إلى أوامر خاصة: اطلب ما تريد بكلماتك، وسيختار Claude Code الأدوات بنفسه. هذه طلبات جيدة للبداية، تتدرج من القراءة فقط إلى تعديلات صغيرة ومحددة:

> ما الذي يمكنك فعله في مساحة عملي على Knowtarium؟
 
> ابحث في ملاحظاتي عن قرار التسعير، وأجبني
  مع روابط للملاحظات التي اعتمدت عليها.
 
> اقرأ مجلد الاجتماعات واكتب ملخص هذا الأسبوع
  في ملاحظة جديدة. لا تغيّر ملاحظات الاجتماعات.
 
> أضف ملاحظات مكالمة اليوم إلى ملاحظة مشروع Acme،
  ولا تغيّر فيها شيئًا آخر.
 
> ماذا في صندوق الوارد؟ اقترح إجراءً واحدًا لكل صفحة محفوظة.

الطلب الأول اختبار سريع للاتصال: عادةً ما يذكر Claude Code اسم مساحة العمل، ويخبرك هل تُحفظ تغييراته فورًا أم تنتظر موافقتك. والأخير يقرأ الصفحات التي حفظتها عبر Web Clipper. اجعل تعديلاتك الأولى محدودة، وحدّد ما يجب ألا يتغير: فمراجعة أربع ملاحظات معدّلة أسهل من مراجعة أربعين.

كل تغيير يجريه Claude Code موقّع بمفتاحه هو، فتعرف دائمًا أي التعديلات من صنعه:

• نقطة في الشريط الجانبي تميّز كل ملاحظة عدّلها حتى تفتحها، وتجمعها صفحة مساحة العمل تحت Edited by agents.
• تحت عنوان الملاحظة، سطر يذكر أن Claude Code عدّلها، ومعه See changes لعرض الفروقات وUndo لاستعادة النسخة السابقة.
• تظهر عمليات الحذف والنقل وتغييرات المجلدات في صفحة مساحة العمل لمدة أسبوعين، أو طوال مدة السجل لديك إن كانت أقصر، تحت Deleted and reorganized by agents، ومعها Undo وUndo this agent's last 24 hours. ويمكنك استعادة الملاحظة المحذوفة ما دامت ضمن مدة السجل لديك.
• يحتفظ السجل بكل نسخة طوال المدة التي تحددها، من يوم واحد إلى سنة. وفي المجلدات التي فعّلت فيها المراجعة، تنتظر التغييرات في قائمة المراجعة بدلًا من ذلك.

(تُفتح بحجمها الكامل في علامة تبويب جديدة) (تُفتح بحجمها الكامل في علامة تبويب جديدة)

وفي دليلنا عن مراجعة تعديلات الوكلاء روتين بسيط لفحص ما غيّره الوكيل قبل أن تعتمد عليه.

Claude Code لا يرى Knowtarium

أعد تشغيل Claude Code بعد إضافة Knowtarium: فالجلسة المفتوحة من قبل لا تتعرّف على الخوادم الجديدة. وإن كنت تستخدم الإضافة، فتأكد أنها مثبّتة ومفعّلة في /plugin.

تحقّق من الاتصال

يعرض npx knowtarium status مساحات العمل المربوطة، وصلاحيات كل منها وتغييراتها، ورمز الوصول، والذاكرة المؤقتة المحلية، ويخبرك أين تُحفظ المفاتيح.

knowtarium يطلب منك التحديث

شغّل npx knowtarium@latest agents من مجلدك الرئيسي، فيوجّه وكلاءك إلى الإصدار الجديد، ثم أعد تشغيل Claude Code. وإن كنت تستخدم الإضافة، فحدّث متجر الإضافات (marketplace) ثم الإضافة نفسها داخل Claude Code (/plugin marketplace update knowtarium، ثم /plugin واختر Update now)، وأعد التشغيل.

$ cd ~$ npx knowtarium@latest agents$ npx knowtarium status

تنتظر التغييرات موافقتك وكنت تتوقع حفظها فورًا

يخبرك Claude Code عن كل تغيير: هل حُفظ أم اقتُرح، ولماذا. فقد يكون المجلد يطلب المراجعة، أو تعذّر التحقق من إعدادات مساحة العمل، أو بلغت التغييرات المباشرة حدها لهذا اليوم، أو أن هذا الاتصال لا يملك إلا الاقتراح. وفي الحالة الأخيرة، شغّل npx knowtarium connect مرة أخرى من مجلدك الرئيسي، ثم أعد تشغيل Claude Code.

على Windows

استخدم npx knowtarium connect (أو npx knowtarium agents) من مجلدك الرئيسي بدلًا من الإضافة، كما شرحنا أعلاه.