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

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

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

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

تحتاج إلى 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? Cursor
added to Cursor (/Users/you/.cursor/mcp.json)
  previous file saved as /Users/you/.cursor/mcp.json.knowtarium-backup-<time>

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

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

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

إن كنت مسجّل الدخول إلى Knowtarium، فبإمكان التطبيق أن يضيف الخادم إلى Cursor نيابةً عنك. لكنك ما زلت تحتاج إلى Node.js 20 أو أحدث، لأن Cursor يشغّل الخادم نفسه من npm.

1. افتح Connect an agent. في تطبيق الويب، انتقل إلى Settings ثم Agents ثم Connect an agent (app.knowtarium.com/settings/agents/new)، على الحاسوب الذي يعمل عليه Cursor.
2. انقر Add to Cursor. يُفتح Cursor ويعرض عليك تثبيت خادم knowtarium. وافق على ذلك.
3. اربط هذا الحاسوب، إن لم تكن فعلت ذلك بعد. اطلب من وكيل Cursor أن يربط Knowtarium، أو شغّل الأمر مرة واحدة من مجلدك الرئيسي مع --no-agents، فلا يمس إعدادات Cursor. وفي الحالتين يُفتح متصفحك لتوافق على هذا الحاسوب وتختار ما يصل إليه Cursor.

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

يبدأ الخادم الذي يضيفه الرابط من مجلدك الرئيسي قبل أن يشغّل npx، لأن Cursor يشغّل الخوادم في مجلد المشروع المفتوح لديك، ولولا ذلك لاستطاع مشروع هناك أن يضع شيفرته مكان شيفرة Knowtarium.

الرابط أم أمر الربط؟

في الحالتين يحصل Cursor على الخادم نفسه والأدوات نفسها، ومعها قواعد العمل نفسها. ولتبقى الأمور بسيطة، استخدم طريقة واحدة: الرابط أو الأمر.

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

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

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

يقرأ Cursor أصلًا القواعد التي تكتبها: قواعد المشروع في .cursor/rules، وملف AGENTS.md في المستودع، وقواعد المستخدم التي تضبطها في Cursor. وهي تصلح لشرح طريقة العمل في قاعدة الشيفرة، لكنها لا تصلح موطنًا للمعرفة التي تحيط بها: لماذا اتُّخذ قرار ما، والأبحاث، وملاحظات الاجتماعات، والحقائق التي يعتمد عليها أكثر من وكيل وأكثر من شخص، في كل مشروع تفتحه.

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

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

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

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

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

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

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

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

Cursor لا يرى Knowtarium

أعد تشغيل Cursor بعد إضافة Knowtarium. ثم تأكد أن knowtarium ظاهر ومفعّل في المكان الذي يعرض فيه Cursor خوادم MCP (Customize في الإصدارات الحديثة). وإن لم يظهر Cursor في قائمة npx knowtarium connect، فأضفه باسمه: npx knowtarium agents --agent cursor، من مجلدك الرئيسي.

تخطّت الأداة إعدادات Cursor

لا تكتب الأداة أبدًا فوق ملف لا تستطيع تعديله بأمان. فإن لم يكن ~/.cursor/mcp.json ملف JSON صالحًا، أو كانت فيه تعليقات، تخبرك بذلك وتتركه كما هو. وتطبع أيضًا سطر «add it by hand» ومعه إدخال خادم: تجاهله، لأن الإدخال الذي تكتبه بنفسك يشغّل npx في مجلد المشروع. أصلح الملف (أو احذف التعليقات، أو انقله جانبًا)، ثم شغّل npx knowtarium agents مرة أخرى.

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

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

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

إن كنت استخدمت الأمر، فشغّل npx knowtarium@latest agents من مجلدك الرئيسي، فيحدّث إدخال knowtarium في ~/.cursor/mcp.json (وإدخالات وكلائك الآخرين) إلى الإصدار الجديد. وإن كنت استخدمت الرابط، فانقر Add to Cursor مرة أخرى في التطبيق. ثم أعد تشغيل Cursor.

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

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

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