الوكلاء و MCP · التوثيق

أنشئ مفتاح وصول

افتح خزنة وانتقل إلى الوكلاء و MCP. في خطوة اربط أدوات الذكاء الاصطناعي، انقر إنشاء مفتاح: تُملأ أوامر الإعداد أدناه بمفتاحك الجديد وتصبح جاهزة للنسخ. يظهر المفتاح مرة واحدة فقط، فانسخه فورًا. وما إن تقرأ أداتك الخزنة لأول مرة حتى يؤكد التبويب الاتصال.

بعد أول بناء مباشرةً، تتيح شاشة ما تعلّمه Context OS الأمر نفسه بنقرة واحدة: يفتح زرا إضافة إلى Cursor وإضافة إلى VS Code نافذة التثبيت في المحرر والخادم مُعدّ مسبقًا، وأمر Claude Code جاهز للنسخ.

عند فتح رابط مشاركة مجلد (Team) في المتصفح تظهر صفحة للضيف: من شارك أي مجلد وحتى متى، مع الإعداد نفسه بنقرة واحدة لوكيل الضيف. ويبدأ وكيل الضيف من المجلد المشارَك: تعرض خريطته ذلك المجلد والمجلدات الفرعية التي يتيحها الرابط. ولا يُحتسب وكيل الضيف وكيلًا لك أبدًا: فلا يطلق لحظة «اتصل وكيلك» ولا يوقف إضافة متصفحك. وتتوقف روابط المشاركة إذا عُلّق حساب منشئها أو حساب أحد مالكي الخزنة (راجع الفرق والمؤسسات).

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

ويمكنك أيضًا إنشاء مفاتيح وصول بدور محدد (المالك أو المسؤول أو العضو) وصلاحية ومدة صلاحية من بطاقة مفاتيح الوصول (API). وتُرشَّح كل عملية بحسب المجلدات المسموح لهذا الدور بقراءتها. والصلاحية واحدة مما يلي:

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

مفاتيح النقرة الواحدة (خطوة اربط أدوات الذكاء الاصطناعي وشاشة ما تعلّمه Context OS) تذكر دورها ومدة صلاحيتها، ويمكنك تغييرهما (90 يومًا افتراضيًا، ودور العضو في خزائن الفريق). ويمكن أن تضم الخزنة ما يصل إلى 50 مفتاحًا نشطًا: ألغِ ما لم تعد تستخدمه لإفساح المجال. وتحتاج إضافة المتصفح إلى مفتاح مالك أو مسؤول بصلاحية كاملة (انظر أدناه).

البوابة نقطة نهاية Streamable HTTP على العنوان https://app.contextos.dev/api/mcp، وتُصادَق بالترويسة Authorization: Bearer ctxos_…. أما الخوادم ذاتية الاستضافة فتستخدم https://your-domain/api/mcp.

لا تستطيع موصلات ChatGPT إرسال ترويسات، لذا تتصل عبر رابط ChatGPT (/api/mcp/k/…): انقر إنشاء رابط ChatGPT في إعداد ChatGPT. يحمل الرابط مفتاحًا محدودًا خاصًا به، بصلاحية «مع المراجعة» (أو «للقراءة فقط» في الخطط التي لا تسمح بكتابة الوكلاء)، وتنتهي صلاحيته بعد 90 يومًا. ولا يُقبل مفتاح بصلاحية كاملة داخل رابط أبدًا، لأن الروابط تنتهي في السجلات وسجل المتصفح ولقطات الشاشة. احتفظ بالرابط لنفسك، وألغِه من بطاقة مفاتيح الوصول (API) كأي مفتاح آخر.

يولّد تبويب الوكلاء و MCP مقتطفات جاهزة للصق في Claude Code وClaude Desktop وCursor وWindsurf وChatGPT وأي عميل MCP آخر، إضافةً إلى زر اختبر الاتصال. ولا يُحتسب الاختبار نشاطًا لوكيل: فلا يوقف إضافة متصفحك ولا يزيد عدد استدعاءات وكلائك.

الأدوات

الأداة	ما تفعله
`get_master_map`	تُرجع `AGENTS.md` و`SOUL.md` مرشّحين على المجلدات التي يراها دورك
`read_folder_readme`	تُرجع فهرس المجلد: غرضه وقاعدة توجيهه وملفاته مع ملخصاتها
`read_context_file`	تقرأ ملف Markdown واحدًا (والملفات الطويلة على أجزاء من 40,000 حرف عبر `offset` و`limit`) وتُحتسب ضمن «الرموز المقدَّمة»
`search`	تجد الملفات الأقرب إلى السؤال (ترتيب محلي بلا تكلفة ذكاء اصطناعي) مع السطر المطابق
`fetch`	تفتح نتيجة بحث واحدة بمسارها أو معرّف ملفها، مع ملخصها ووسومها
`propose_context_update`	تحفظ حقائق جديدة؛ وتذهب الملفات السيادية والحقائق منخفضة الثقة وكتابات أعضاء الفريق إلى الحجر
`remember`	تحفظ حقيقة واحدة دون اختيار ملف: توجّهها الخزنة كما تفعل `propose_context_update`
`record_agent_feedback`	تضيف التصحيحات والأخطاء إلى `Lessons_And_Mistakes.md` لتتعلّم منها الجلسات القادمة

تتبع search وfetch الصيغة التي تتوقعها موصلات ChatGPT ووكلاء البحث المعمّق.

في الخطة المجانية تكون البوابة للقراءة فقط: تعمل أدوات القراءة (get_master_map وread_folder_readme وread_context_file وsearch وfetch)، أما كتابة الحقائق فتتطلب Pro أو شهرًا فعّالًا من حزمة الاستيراد أو خطة الفريق.

في خزنة الفريق، تنتظر كتابات مفتاح العضو (الحقائق والدروس) دائمًا في الحجر حتى يوافق عليها مالك أو مسؤول؛ أما مفاتيح المالك والمسؤول فتكتب مباشرة، إلا في الملفات السيادية. ولا يرى الوكلاء إلا المجلدات التي يستطيع دور مفتاحهم فتحها: تُعاد كتابة الخرائط وفهارس المجلدات وسجل التغييرات لذلك الدور، فلا تذكر مجلدات لا يستطيع قراءتها. وتُرفض المسارات التي تحتوي على مقاطع «..» أو على أحرف تحكم أو أحرف اتجاه نص مخفية، وتُحفظ الإصدارات السابقة لكل ملف تغيّر (انظر الخصوصية والتخزين).

لا يكتب الوكلاء أبدًا في الملفات التي يديرها Context OS: تُرفض الكتابة في خرائط التوجيه وفهارس README.md في المجلدات و.cursorrules و.windsurfrules وChangelog.md، وكذلك في المجلدات المخفية ومجلدات .git. والحقيقة الموجّهة إلى اسم آخر تحجزه الخزنة (مثل Historical_Archive.md، أو Lessons_And_Mistakes.md داخل مجلد) تُحفظ بدلًا من ذلك بلاحقة _Notes (Historical_Archive_Notes.md). وتُستبدل الأسرار في كل ما يرسله الوكيل (الحقائق والأسباب وأسماء الأقسام والوكلاء) بعناصر نائبة مثل [REDACTED_SECRET_1] قبل تخزين أي شيء.

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

لكل مفتاح ولكل رابط مشاركة حدّ استدعاءات خاص به (240 و120 استدعاءً في الدقيقة)، فلا يحجبك ضيف كثير الاستدعاءات أبدًا. ولا يُسمح لرابط المشاركة بأكثر من 25 اقتراحًا منتظرًا في الحجر (وللمفتاح 100)، وتعرض كل بطاقة في الحجر المفتاح أو رابط المشاركة الذي قدّم الاقتراح.

إضافة المتصفح

تملأ الإضافة محادثات ChatGPT وClaude وGemini وGrok الجديدة مسبقًا بخريطة خزنتك، وتلتقط المحادثات الجديدة وتعيدها إلى الخزنة.

تخزّن AGENTS.md وSOUL.md محليًا، فيكون الحقن فوريًا ومجانيًا.
يُضاف السياق مرة واحدة في كل محادثة، وفي مربع رسائل المحادثة نفسه فقط (لا في المنشورات أو الرسائل المباشرة أو أي محرر آخر في الصفحة)، حتى عند التنقل بين المحادثات دون إعادة تحميل.
تتخطّى الحقن فقط في الموقع الذي يعمل موصل MCP الخاص به (مثل ChatGPT المتصل برابط ChatGPT)، فلا يُضاف السياق مرتين. أما الوكلاء خارج المتصفح، مثل Cursor وClaude Code وVS Code، فلا يوقفونها أبدًا، ولا يعتمد الالتقاط على MCP.
تُزال الأسرار من المحادثات الملتقطة داخل المتصفح، ولا تُرسل إلا بعد فترة هدوء من 5 إلى 10 دقائق. ولا يُرسل إلا الجديد أو المعدَّل من الرسائل، لا المحادثة كاملة من جديد، وتُقطَّر معًا المحادثات الملتقطة خلال 10 دقائق من بعضها.
لا تُحقن المحادثات المؤقتة ومحادثات وضع التصفح الخفي ولا تُلتقط أبدًا.
يحتاج التقاط المحادثات إلى مفتاح مالك أو مسؤول بصلاحية كاملة: فبمفتاح العضو تملأ الإضافة المحادثات بسياقك فقط، وتُرفض عمليات الالتقاط. وينشئ المالكون والمسؤولون هذا المفتاح بزر أنشئ مفتاحًا للإضافة في بطاقة الإضافة داخل تبويب الوكلاء، وتعرض البطاقة أيضًا رابط الخادم الذي تلصقه؛ أما الأعضاء فيطلبون مفتاحًا من مالك أو مسؤول.
تنتظر المحادثات الملتقطة في صندوق صادر محلي حتى يؤكد الخادم استلامها: انقطاع الاتصال أو أخطاء الخادم أو نفاد رموزك تؤخرها فقط، فلا يضيع شيء. وتعرض النافذة المنبثقة ما ينتظر الإرسال. وتغيير رابط الخادم أو المفتاح يُسقط المحادثات التي ما زالت تنتظر، فلا تصل أي محادثة إلى خزنة أو خادم آخر.
لا تُملأ المحادثات بسياق خزنة مقفلة بعبارة مرور حتى تفتح قفلها، وتنتظر المحادثات الملتقطة حتى ذلك الحين.
رابط الخادم هو عنوان التطبيق، لا نقطة اتصال MCP (يُصحَّح عنوان /api/mcp الملصوق، ويُبلَّغ عن أي عنوان لا يستجيب عليه خادم Context OS). ويجب أن يبدأ بـ https:// (ولا يُقبل http:// إلا مع localhost). ويُظهر فحص الصفحة في النافذة المنبثقة هل وجدت الإضافة مربع رسائل المحادثة في الصفحة الحالية.

تثبيتها (وصول مبكر)

إدراج الإضافة في متجر Chrome قيد المراجعة. وإلى أن يصبح متاحًا، ثبّت الحزمة الجاهزة بوضع المطوّر، وتعمل في Chrome وEdge وBrave:

افتح الوكلاء في خزنتك وانقر تنزيل لـ Chrome وEdge وBrave، ثم فُكّ ضغط الملف. تعرض البطاقة إصدار الحزمة وبصمتها بصيغة SHA-256.
افتح chrome://extensions (أو edge://extensions أو brave://extensions) وفعّل وضع المطوّر.
انقر تحميل الإضافة غير المضغوطة واختر المجلد الذي فككت ضغطه.
افتح خيارات الإضافة والصق رابط الخادم الظاهر في بطاقة الإضافة (أبقِ القيمة الافتراضية https://app.contextos.dev في Context OS السحابي) والمفتاح الذي ينشئه زر أنشئ مفتاحًا للإضافة (أو مفتاحًا أعطاك إياه مالك أو مسؤول).

لا تتحدّث الإضافات المثبّتة بوضع المطوّر تلقائيًا، لذا نزّل الحزمة الجديدة من تبويب الوكلاء عند الإعلان عن إصدار جديد. وعندما يصبح الإدراج في المتجر متاحًا، سيعرض تبويب الوكلاء رابطه بدلًا من ذلك.