# MCP في Claude Desktop

Claude Desktop تطبيق سطح المكتب من Anthropic لـ macOS و Windows. مع
خادم Synapse MCP مُعدًا، يحصل Claude على وصول أصلي لجميع أدوات Synapse الـ 79 — يستطيع تخزين الذكريات، استدعاؤها، إدارة المهام، الدردشة معك،
والمزيد.

## المتطلبات المسبقة

- تطبيق Claude Desktop (macOS أو Windows)
- Node.js 18+ مثبت (`node --version`)
- Mind Key الخاص بـ Synapse

## الخطوة 1: افتح ملف الإعداد

- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

إذا لم يوجد الملف، أنشئه.

## الخطوة 2: أضف خادم Synapse MCP

```json
{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_YOUR_MIND_KEY_HERE",
        "SYNAPSE_URL": "https://synapse.schaefer.zone"
      }
    }
  }
}
```

> [!TIP]
> إذا كان لديك خوادم MCP أخرى مُعدة بالفعل، فقط أضف الكتلة `"synapse"`
> داخل كائن `"mcpServers"` الموجود.

## الخطوة 3: أعد تشغيل Claude Desktop

1. أغلق Claude Desktop بالكامل (Cmd+Q على macOS، ليس مجرد إغلاق النافذة)
2. أعد فتح Claude Desktop
3. ابدأ دردشة جديدة
4. ابحث عن أيقونة القابس 🔌 في أسفل اليسار — يجب أن تقول "79 tools"

## الخطوة 4: اختبره

في دردشة جديدة، اكتب:

```
memory_recall aufrufen
```

يجب أن يستدعي Claude أداة `memory_recall` ويرد بملخص لـ
ذكرياتك المخزّنة (أو "No memories yet" إذا كان عقلك فارغًا).

## الأدوات المتاحة (مختارة)

| الأداة | الوصف |
|------|-------------|
| `memory_recall` | استدعِ جميع الذكريات |
| `memory_store` | خزّن ذاكرة جديدة |
| `memory_search` | ابحث في الذكريات |
| `task_list` | سرد المهام |
| `task_create` | أنشئ مهمة |
| `chat_poll` | تحقق من رسائل جديدة |
| `chat_reply` | ارد على رسالة |
| `browser_new` | افتح علامة متصفح |
| `computer_list` | سرد الأجهزة المسجّلة |

القائمة الكاملة: [ما هو MCP؟](/docs/mcp/what-is-mcp)

## استكشاف الأخطاء

### لا تظهر أدوات في Claude Desktop

1. تحقق من إصدار Node.js: `node --version` (يجب ≥ 18)
2. تحقق أن ملف الإعداد JSON صالح (بلا فواصل لاحقة)
3. أعد تشغيل Claude Desktop بالكامل (Cmd+Q، ليس مجرد إغلاق)
4. تحقق من سجلات Claude Desktop: `~/Library/Logs/Claude/mcp.log` (macOS)

### خطأ "Mind Key invalid"

- تحقق أن `SYNAPSE_MIND_KEY` يبدأ بـ `mk_`
- احصل على مفتاح جديد عبر `POST /minds` (يتطلب JWT من `/login`)
- لا علامات اقتباس حول المفتاح في JSON

### npx غير موجود

- ثبّت Node.js 18+: <https://nodejs.org/>
- أعد تشغيل الـ terminal بعد التثبيت
- على macOS مع Homebrew: `brew install node`

### الأدوات تظهر لكن الاستدعاءات تفشل

- تحقق أن `SYNAPSE_URL` قابل للوصول: `curl https://synapse.schaefer.zone/health`
- تحقق أن Mind Key يعمل: `curl -H "Authorization: Bearer mk_..." https://synapse.schaefer.zone/memory/recall`
- راجع [استكشاف أخطاء MCP](/docs/mcp/troubleshooting)

## ملفات الأدوات (وفّر الرموز)

إذا كنت تستخدم LLM أصغر أو تريد حفظ رموز السياق، عيّن ملف أداة:

```json
{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_...",
        "SYNAPSE_URL": "https://synapse.schaefer.zone",
        "MCP_PROFILE": "standard"
      }
    }
  }
}
```

الملفات: `minimal` (8 أدوات)، `standard` (25)، `full` (119، افتراضي).

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

- [إعداد Claude Code](/docs/mcp/claude-code)
- [إعداد Cursor](/docs/mcp/cursor)
- [استكشاف أخطاء MCP](/docs/mcp/troubleshooting)