# Mind Key مقابل JWT — ماذا ومتى؟
SUMMARY: دليل القرار: Mind Key للوصول لبيانات الوكيل، JWT لإدارة الحساب.

KEY CONTEXT:
Mind Key: tenant-scoped, never expires, for memory/chat/tasks/scripts/computers/webhooks.
JWT: user-scoped, 7-day expiry, for /register, /login, /minds (CRUD), /sharing, /push.
Simple rule: if it touches a single mind's data → Mind Key. If it manages the account → JWT.
Exception: /computers/me/* uses Computer Token (not Mind Key or JWT).

Mind Key مقابل JWT — ماذا ومتى؟
يمتلك Synapse رمزي مصادقة. اختيار الخاطئ يؤدي إلى أخطاء 401.
يمنحك هذا الدليل إطار قرار واضح.
جدول القرار السريع
| تريد... | استخدم |
|----------------|-----|
| تخزين / استدعاء الذكريات | Mind Key |
| إرسال / استطلاع رسائل الدردشة | Mind Key |
| إدارة المهام | Mind Key |
| تخزين السكربتات | Mind Key |
| تسجيل الـ webhooks | Mind Key |
| التحكم بالأجهزة | Mind Key (جانب المستخدم) / Computer Token (جانب الوكيل) |
| تسجيل حساب مستخدم | لا شيء (عام) |
| تسجيل الدخول | لا شيء (عام) |
| إنشاء / سرد / حذف العقول | JWT |
| مشاركة عقل مع مستخدم آخر | JWT |
| الاشتراك في إشعارات web push | JWT |
| عرض سجل التدقيق | Mind Key |
القاعدة البسيطة
> [!TIP]
> إذا كان يلامس بيانات عقل واحد → Mind Key.
> إذا كان يدير الحساب أو بيانات العقل الوصفية → JWT.
Mind Key — رمز وصول البيانات
يمنح Mind Key الوصول إلى بيانات عقل واحد. إنه رمز طويل الأمد
لا ينتهي (حتى يُحذف العقل). مثالي لـ:
- وكلاء LLM الذين يحفظون الذكريات عبر الجلسات
- مهام cron الخلفية
- إعداد خادم MCP
- تكاملات الـ webhooks
- تطبيقات الموبايل التي تقرأ الذاكرة
ما يستطيع Mind Key فعله
-  — قراءة جميع الذكريات في هذا العقل
-  — تخزين/تحديث الذكريات
-  — قراءة رسائل الدردشة
-  — إرسال رسائل الدردشة
-  — سرد المهام
-  — إنشاء المهام
-  — تخزين السكربتات
-  — تسجيل الـ webhooks
-  — إدراج أوامر الأجهزة في الطابور
ما لا يستطيع Mind Key فعله
- إنشاء / سرد / حذف العقول (يحتاج JWT)
- مشاركة عقل مع مستخدم آخر (يحتاج JWT)
- عرض معلومات حساب المستخدم (يحتاج JWT)
- الاشتراك في web push (يحتاج JWT)
JWT — رمز إدارة الحساب
تُصادق JWT حساب المستخدم. تنتهي بعد 7 أيام وتُستخدم
لعمليات مستوى الحساب التي تمتد عبر عقول متعددة أو تتضمن مستخدمين آخرين.
ما تستطيع JWT فعله
-  — إنشاء عقل جديد (يُرجع Mind Key جديد)
-  — سرد جميع العقول لهذا المستخدم
-  — حذف عقل
-  — مشاركة عقل مع مستخدم آخر
-  — الاشتراك في إشعارات web push
-  — سرد مشاركات العقل
ما لا تستطيع JWT فعله
- قراءة / كتابة الذكريات (تحتاج Mind Key)
- إرسال رسائل الدردشة (تحتاج Mind Key)
- إدارة المهام (تحتاج Mind Key)
- تسجيل الـ webhooks (تحتاج Mind Key)
حالة خاصة: Computer Token
نقاط النهاية  (الخاصة بالوكيل، لـ screen-remote-agent)
تستخدم نوع رمز ثالث: Computer Token. يُرجع هذا الرمز بواسطة
 عند استرداد رمز تثبيت، وهو خاص بـ
جهاز مسجّل واحد.
| نقطة النهاية | المصادقة |
|----------|------|
|  | Computer Token |
|  | Computer Token |
|  | Mind Key أو JWT |
|  | Mind Key أو JWT |
الأنماط الشائعة
النمط 1: وكيل LLM واحد
1. سجّل مرة واحدة → احصل على JWT
2. أنشئ عقلًا واحدًا → احصل على Mind Key
3. يستخدم LLM Mind Key لكل شيء
النمط 2: وكيل متعدد المشاريع
1. سجّل مرة واحدة → احصل على JWT
2. أنشئ عقولًا متعددة (work، personal، project-x) → احصل على Mind Keys متعددة
3. يحمل LLM Mind Key مختلفًا حسب السياق
النمط 3: مشاركة الفريق
1. المستخدم A ينشئ عقلًا → يحصل على Mind Key A
2. المستخدم A يشارك مع المستخدم B عبر JWT ()
3. المستخدم B يستطيع الآن الوصول عبر JWT الخاص به
4. لوصول LLM، يحتاج المستخدم B لإنشاء Mind Key خاص به (أو استخدام A's)
النمط 4: خادم MCP
خوادم MCP تستخدم دائمًا Mind Key (عيينها عبر متغير البيئة ). نسخة خادم MCP
واحدة = عقل واحد. لوصول عقول متعددة، شغّل نسخ MCP متعددة
أو نفّذ تبديل العقل من جانب العميل.
ورقة غش تنسيق الرموز
| الرمز | التنسيق | مثال |
|-------|--------|---------|
| Mind Key |  + 36 حرفًا |  |
| JWT |  + base64 |  |
| Computer Token |  + 36 حرفًا |  |
الخطوات التالية
- المصادقة — دليل المصادقة الكامل
- User & Minds API — نقاط نهاية محمية بـ JWT
- Memory API — نقاط نهاية محمية بـ Mind Key