# البداية السريعة (للإنسان)

يأخذك هذا الدليل خلال الحصول على حساب Synapse، أول Mind Key لك،
وتخزين أول ذاكرة. الوقت الإجمالي: ~5 دقائق.

## الخطوة 1: سجّل حسابًا

افتح Synapse API وأنشئ حسابًا:

```bash
curl -X POST https://synapse.schaefer.zone/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "your-secure-password"
  }'
```

الاستجابة:

```json
{
  "jwt": "eyJhbGci...",
  "user": { "id": "u_abc123", "email": "you@example.com" }
}
```

> [!TIP]
> احفظ JWT في مكان آمن — ستحتاجه لإنشاء العقول. تنتهي JWT
> بعد 7 أيام؛ أعد تسجيل الدخول بنفس نقطة النهاية للتحديث.

## الخطوة 2: أنشئ أول عقل لك

"العقل" نطاق ذاكرة معزول. يبدأ معظم المستخدمين بعقل واحد، لكن يمكنك
امتلاك عقول متعددة (مثلًا "work"، "personal"، "project-x"). لكل عقل
Mind Key فريد خاص به.

```bash
curl -X POST https://synapse.schaefer.zone/minds \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Mind",
    "description": "Personal assistant memory"
  }'
```

الاستجابة:

```json
{
  "id": "m_xyz789",
  "name": "My First Mind",
  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",
  "created_at": "2026-06-27T..."
}
```

> [!CRITICAL]
> **احفظ `mind_key` فورًا.** يُعرض مرة واحدة فقط ولا يمكن
> استرداده لاحقًا. إذا فقدته، ستحتاج لإنشاء عقل جديد.

## الخطوة 3: خزّن أول ذاكرة

الآن استخدم Mind Key لتخزين ذاكرة:

```bash
curl -X POST https://synapse.schaefer.zone/memory \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "identity",
    "key": "user_name",
    "content": "My name is Michael",
    "tags": ["personal", "identity"],
    "priority": "critical"
  }'
```

الاستجابة:

```json
{
  "id": "mem_001",
  "status": "stored",
  "mind_id": "m_xyz789"
}
```

## الخطوة 4: استدعِ جميع الذكريات

لاسترجاع كل ما خزّنته:

```bash
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/memory/recall
```

الاستجابة (نص عادي، مُحسّن لاستهلاك LLM):

```
Mind: My First Mind
Memories: 1 total (1 verified)

[001] identity (CRITICAL)
  user_name
  My name is Michael
  Tags: personal, identity
  Stored: 2026-06-27
```

## الخطوة 5: ابحث في الذكريات

أوجد ذكريات محددة بالكلمة المفتاحية:

```bash
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     "https://synapse.schaefer.zone/memory/search?q=michael"
```

## الخطوة 6: اربط LLM الخاص بك

أسهل طريقة لمنح LLM الخاص بك الوصول إلى Synapse هي عبر MCP:

- [إعداد Claude Desktop](/docs/mcp/claude-desktop) — إعداد بدقيقتين
- [إعداد Claude Code](/docs/mcp/claude-code) — تكامل الـ terminal
- [إعداد Cursor](/docs/mcp/cursor) — تكامل IDE

بعد الإعداد، سيستدعي LLM الخاص بك `memory_recall` تلقائيًا في بداية
كل جلسة ويحفظ الحقائق الجديدة عبر `memory_store`.

## فئات الذاكرة

يدعم Synapse 8 فئات — اختر الأكثر تحديدًا:

| الفئة | حالة الاستخدام |
|----------|----------|
| `identity` | اسم المستخدم، الدور، معلومات الاتصال |
| `preference` | الإعجابات، عدم الإعجابات، أسلوب العمل |
| `fact` | حقائق قابلة للتحقق (تفاصيل المشروع، التواريخ) |
| `project` | حالة المشروع، المعالم، المهام |
| `skill` | ما يبرع فيه المستخدم |
| `mistake` | أخطاء سابقة — تجنب تكرارها |
| `context` | سياق ذو صلة بالجلسة |
| `note` | ملاحظات متفرقة |

## مستويات الأولوية

- `low` — جيد معرفته
- `normal` — افتراضي
- `high` — مهم
- `critical` — يجب ألا يُنسى أبدًا (هوية المستخدم، معلومات قانونية)

## الخطوات التالية

- [تعمق في المصادقة](/docs/getting-started/authentication)
- [Mind Key مقابل JWT](/docs/getting-started/mind-key-vs-jwt)
- [مرجع Memory API](/docs/api/memory)
- [تكامل MCP](/docs/mcp/what-is-mcp)