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

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

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

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

تحتاج إلى 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? Codex
added to Codex (/Users/you/.codex/config.toml)
  previous file saved as /Users/you/.codex/config.toml.knowtarium-backup-<time>

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

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

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

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

$ codex plugin marketplace add Knowtarium/knowtarium-plugins$ codex plugin add knowtarium@knowtarium

أو، بعد إضافة متجر الإضافات (marketplace)، اكتب /plugins في Codex لتفتح متصفح الإضافات، وثبّت Knowtarium من متجر knowtarium. فهو ليس في دليل الإضافات العام لدى OpenAI، لذا أضف المتجر أولًا.

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

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

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

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

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

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

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

يأخذ Codex تعليماته الدائمة من ملفات AGENTS.md: ملف في ~/.codex يسري على كل المشاريع، والملفات الموجودة في المجلدات بين جذر git والمكان الذي تشغّله منه (توثيق Codex). وهي تصلح لشرح طريقة العمل في مستودع، لكنها لا تصلح موطنًا للمعرفة نفسها: القرارات، والأبحاث، وملاحظات الاجتماعات، والحقائق التي يعتمد عليها أكثر من وكيل وأكثر من شخص.

وهنا يأتي دور قاعدة المعرفة. أبقِ قواعد البرمجة في ملف AGENTS.md لدى Codex، ودع Codex يبحث في Knowtarium ويدوّن فيه ما يتعلمه، حيث يرى كل وكيل آخر تربطه الملاحظات نفسها، وتقرؤها أنت وتعدّلها في التطبيق. ويقارن دليلنا العقل الثاني مع Claude Code بين طريقة قراءة Codex وCursor وClaude Code لملفات تعليماتها.

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

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

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

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

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

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

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

Codex لا يرى Knowtarium

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

Codex غير موجود في قائمة الوكلاء

تتعرّف الأداة على Codex من مجلده ~/.codex (أو $CODEX_HOME). وإن كان Codex يحفظ إعداداته في مكان آخر، فاضبط CODEX_HOME في تلك الطرفية. ولإضافة Knowtarium إلى Codex في كل الأحوال، شغّل npx knowtarium agents --agent codex من مجلدك الرئيسي (إلا إن كنت تستخدم الإضافة).

تخطّت الأداة Codex

لا تكتب الأداة شيئًا إن لم يكن config.toml ملف TOML صالحًا، أو إن كانت خوادم MCP فيه مكتوبة بصيغة لا تستطيع تعديلها بأمان، وتخبرك أيهما السبب. وتطبع أيضًا سطر «add it by hand» ومعه إدخال خادم: تجاهله، لأن الإدخال الذي تكتبه بنفسك يشغّل npx في مجلد المشروع. أصلح الملف (أو انقله جانبًا)، ثم شغّل npx knowtarium agents --agent codex مرة أخرى.

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

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

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

شغّل npx knowtarium@latest agents من مجلدك الرئيسي، فيوجّه وكلاءك إلى الإصدار الجديد، ثم أعد تشغيل Codex.

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

وإن كنت تستخدم الإضافة، فحدّث المتجر (وهذا يحدّث القائمة فقط)، ثم أعد إضافتها لتثبيت الإصدار الجديد، وأعد تشغيل Codex:

$ codex plugin marketplace upgrade knowtarium$ codex plugin add knowtarium@knowtarium

لديك الإضافة وإدخال الأمر معًا

في هذه الحالة يعمل الإدخال الموجود في config.toml بدلًا من خادم الإضافة. وتُبقيه الأداة محدّثًا وتخبرك بذلك. ولاستخدام خادم الإضافة، احذف الجدول [mcp_servers.knowtarium] من ~/.codex/config.toml (أو من $CODEX_HOME) وأعد تشغيل Codex.

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

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