{"title":"MCP في Claude Desktop","slug":"claude-desktop","category":"mcp","summary":"اربط Synapse بـ Claude Desktop في دقيقتين. يحصل Claude على 79 أداة Synapse أصليًا.","audience":["human","llm"],"tags":["mcp","claude","desktop","integration"],"difficulty":"beginner","updated":"2026-06-27","word_count":385,"read_minutes":2,"llm_context":"Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)\n %APPDATA%\\Claude\\claude_desktop_config.json (Windows)\nMCP server command: npx -y synapse-mcp-api@latest\nEnv vars: SYNAPSE_MIND_KEY (required), SYNAPSE_URL (optional, default https://synapse.schaefer.zone)\nAfter config: restart Claude Desktop, check for 🔌 icon with \"79 tools\"\nTest: type \"memory_recall aufrufen\" in a new chat\nTroubleshooting: Node.js ≥ 18, check Mind Key, see /docs/mcp/troubleshooting\n","lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# MCP في Claude Desktop\n\nClaude Desktop تطبيق سطح المكتب من Anthropic لـ macOS و Windows. مع\nخادم Synapse MCP مُعدًا، يحصل Claude على وصول أصلي لجميع أدوات Synapse الـ 79 — يستطيع تخزين الذكريات، استدعاؤها، إدارة المهام، الدردشة معك،\nوالمزيد.\n\n## المتطلبات المسبقة\n\n- تطبيق Claude Desktop (macOS أو Windows)\n- Node.js 18+ مثبت (`node --version`)\n- Mind Key الخاص بـ Synapse\n\n## الخطوة 1: افتح ملف الإعداد\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nإذا لم يوجد الملف، أنشئه.\n\n## الخطوة 2: أضف خادم Synapse MCP\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_YOUR_MIND_KEY_HERE\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n> [!TIP]\n> إذا كان لديك خوادم MCP أخرى مُعدة بالفعل، فقط أضف الكتلة `\"synapse\"`\n> داخل كائن `\"mcpServers\"` الموجود.\n\n## الخطوة 3: أعد تشغيل Claude Desktop\n\n1. أغلق Claude Desktop بالكامل (Cmd+Q على macOS، ليس مجرد إغلاق النافذة)\n2. أعد فتح Claude Desktop\n3. ابدأ دردشة جديدة\n4. ابحث عن أيقونة القابس 🔌 في أسفل اليسار — يجب أن تقول \"79 tools\"\n\n## الخطوة 4: اختبره\n\nفي دردشة جديدة، اكتب:\n\n```\nmemory_recall aufrufen\n```\n\nيجب أن يستدعي Claude أداة `memory_recall` ويرد بملخص لـ\nذكرياتك المخزّنة (أو \"No memories yet\" إذا كان عقلك فارغًا).\n\n## الأدوات المتاحة (مختارة)\n\n| الأداة | الوصف |\n|------|-------------|\n| `memory_recall` | استدعِ جميع الذكريات |\n| `memory_store` | خزّن ذاكرة جديدة |\n| `memory_search` | ابحث في الذكريات |\n| `task_list` | سرد المهام |\n| `task_create` | أنشئ مهمة |\n| `chat_poll` | تحقق من رسائل جديدة |\n| `chat_reply` | ارد على رسالة |\n| `browser_new` | افتح علامة متصفح |\n| `computer_list` | سرد الأجهزة المسجّلة |\n\nالقائمة الكاملة: [ما هو MCP؟](/docs/mcp/what-is-mcp)\n\n## استكشاف الأخطاء\n\n### لا تظهر أدوات في Claude Desktop\n\n1. تحقق من إصدار Node.js: `node --version` (يجب ≥ 18)\n2. تحقق أن ملف الإعداد JSON صالح (بلا فواصل لاحقة)\n3. أعد تشغيل Claude Desktop بالكامل (Cmd+Q، ليس مجرد إغلاق)\n4. تحقق من سجلات Claude Desktop: `~/Library/Logs/Claude/mcp.log` (macOS)\n\n### خطأ \"Mind Key invalid\"\n\n- تحقق أن `SYNAPSE_MIND_KEY` يبدأ بـ `mk_`\n- احصل على مفتاح جديد عبر `POST /minds` (يتطلب JWT من `/login`)\n- لا علامات اقتباس حول المفتاح في JSON\n\n### npx غير موجود\n\n- ثبّت Node.js 18+: \n- أعد تشغيل الـ terminal بعد التثبيت\n- على macOS مع Homebrew: `brew install node`\n\n### الأدوات تظهر لكن الاستدعاءات تفشل\n\n- تحقق أن `SYNAPSE_URL` قابل للوصول: `curl https://synapse.schaefer.zone/health`\n- تحقق أن Mind Key يعمل: `curl -H \"Authorization: Bearer mk_...\" https://synapse.schaefer.zone/memory/recall`\n- راجع [استكشاف أخطاء MCP](/docs/mcp/troubleshooting)\n\n## ملفات الأدوات (وفّر الرموز)\n\nإذا كنت تستخدم LLM أصغر أو تريد حفظ رموز السياق، عيّن ملف أداة:\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_...\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\",\n \"MCP_PROFILE\": \"standard\"\n }\n }\n }\n}\n```\n\nالملفات: `minimal` (8 أدوات)، `standard` (25)، `full` (119، افتراضي).\n\n## الخطوات التالية\n\n- [إعداد Claude Code](/docs/mcp/claude-code)\n- [إعداد Cursor](/docs/mcp/cursor)\n- [استكشاف أخطاء MCP](/docs/mcp/troubleshooting)\n","content_html":"

MCP في Claude Desktop

\n

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

\n

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

\n\n

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

\n\n

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

\n

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

\n
{\n  "mcpServers": {\n    "synapse": {\n      "command": "npx",\n      "args": ["-y", "synapse-mcp-api@latest"],\n      "env": {\n        "SYNAPSE_MIND_KEY": "mk_YOUR_MIND_KEY_HERE",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone"\n      }\n    }\n  }\n}
إذا كان لديك خوادم MCP أخرى مُعدة بالفعل، فقط أضف الكتلة `\"synapse\"`\nداخل كائن `\"mcpServers\"` الموجود.

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

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

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

\n

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

\n
memory_recall aufrufen

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

\n

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

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

القائمة الكاملة: ما هو MCP؟

\n

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

\n

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

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

خطأ "Mind Key invalid"

\n\n

npx غير موجود

\n\n

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

\n\n

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

\n

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

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

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

\n

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

\n\n","urls":{"html":"/docs/mcp/claude-desktop","text":"/docs/mcp/claude-desktop?format=text","json":"/docs/mcp/claude-desktop?format=json","llm":"/docs/mcp/claude-desktop?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}