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

{
  "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"
      }
    }
  }
}

الخطوة 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" إذا كان عقلك فارغًا).

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

القائمة الكاملة: ما هو 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

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

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

{
  "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
• إعداد Cursor
• استكشاف أخطاء MCP