{"title":"أسئلة MCP الشائعة","slug":"mcp-faq","category":"faq","summary":"أسئلة شائعة عن تكامل MCP — الأدوات، النقل، استكشاف الأخطاء.","audience":["human","llm"],"tags":["faq","mcp","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":433,"read_minutes":2,"lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# أسئلة MCP الشائعة\n\nأسئلة شائعة عن خادم Synapse MCP.\n\n## ما هو MCP؟\n\nMCP (Model Context Protocol) معيار مفتوح من Anthropic لتكامل\nLLM مع الأدوات. بدلًا من لصق وثائق الـ API في الـ prompts، تسجّل الأدوات\nمع خادم MCP، ويستدعيها الـ LLM كدوال أصلية.\n\nراجع [ما هو MCP؟](/docs/mcp/what-is-mcp).\n\n## كم أداة يعرض Synapse MCP؟\n\n**79 أداة** عبر 12 فئة: الذاكرة، الدردشة، المجدول، المهام، السكربتات،\nالأجهزة، الإشعارات، المستخدم، الأدوات، التصور، المشاركة، الـ webhooks، المتصفح.\n\nراجع [ما هو MCP؟](/docs/mcp/what-is-mcp) للقائمة الكاملة.\n\n## أي عملاء MCP مدعومون؟\n\n- Claude Desktop (macOS، Windows)\n- Claude Code (terminal)\n- Cursor (IDE)\n- Continue.dev (VS Code، JetBrains)\n- Cline (VS Code)\n- أي عميل متوافق مع MCP\n\nراجع [إعداد Claude Desktop](/docs/mcp/claude-desktop) لأمثلة الإعداد.\n\n## أي وسائل نقل مدعومة؟\n\n1. **stdio** (محلي، موصى به لسطح المكتب)\n2. **HTTP/SSE** (بعيد، متعدد المستأجرين)\n3. **WebSocket** (موبايل، حجم عالي)\n\n## كيف أُعدّ Claude Desktop؟\n\nحرّر `claude_desktop_config.json`:\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_KEY\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\nراجع [إعداد Claude Desktop](/docs/mcp/claude-desktop).\n\n## لماذا لا تظهر الأدوات في Claude Desktop؟\n\n1. **أعد تشغيل Claude Desktop بالكامل** (Cmd+Q على macOS)\n2. **تحقق أن ملف الإعداد JSON صالح**\n3. **تحقق أن Node.js 18+** مثبت\n4. **تحقق من سجلات MCP**: `~/Library/Logs/Claude/mcp.log`\n\nراجع [استكشاف أخطاء MCP](/docs/mcp/troubleshooting).\n\n## كيف أستخدم عقلًا مختلفًا؟\n\nغيّر `SYNAPSE_MIND_KEY` في إعداد MCP وأعد تشغيل العميل.\n\nللعقول المتعددة، شغّل عدة نسخ من خادم MCP بمفاتيح\nMind Keys مختلفة.\n\n## هل أستطيع تحديد الأدوات المعروضة؟\n\nنعم، استخدم **ملفات الأدوات**:\n\n- `minimal`: 8 أدوات مركبة (~500 رمز)\n- `standard`: 25 أداة (~2,500 رمز)\n- `full`: 119 أداة (~8,250 رمز، افتراضي)\n\nعيينها عبر متغير البيئة `MCP_PROFILE` أو الترويسة `Mcp-Tool-Profile`.\n\n## كيف أُصحّح مشكلات MCP؟\n\n1. **شغّل خادم MCP يدويًا**: `npx -y synapse-mcp-api@latest`\n2. **تحقق من سجلات العميل** (تختلف حسب العميل)\n3. **تحقق أن Mind Key يعمل**: `curl -H \"Authorization: Bearer mk_...\" .../memory/recall`\n4. **تحقق من صحة Synapse**: `curl https://synapse.schaefer.zone/health`\n\nراجع [استكشاف أخطاء MCP](/docs/mcp/troubleshooting).\n\n## هل خادم MCP مجاني؟\n\nنعم. حزمة npm `synapse-mcp-api` مفتوحة المصدر. خادم MCP المُستضاف\nعلى `synapse-mcp.schaefer.zone` مجاني للاستخدام العام.\n\n## هل أستطيع استضافة خادم MCP بنفسي؟\n\nنعم:\n\n```bash\nnpm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api\n```\n\n## كيف يختلف MCP عن استدعاءات API المباشرة؟\n\n| الجانب | API مباشر | MCP |\n|--------|-----------|-----|\n| يحتاج LLM معرفة | عناوين URL، الترويسات، المصادقة | أسماء الأدوات فقط |\n| معالجة المصادقة | يدوي | تلقائي (متغير البيئة) |\n| اكتشاف الأدوات | اقرأ /endpoints | تلقائي عبر بروتوكول MCP |\n| معالجة الأخطاء | يدوي | موحّد |\n| الأفضل لـ | التكاملات المخصصة | وكلاء LLM |\n\n## هل أستطيع بناء عميل MCP خاص بي؟\n\nنعم. استخدم MCP SDK الرسمي:\n\n- TypeScript: `@modelcontextprotocol/sdk`\n- Python: `mcp`\n\nراجع [عميل MCP مخصص](/docs/mcp/custom-client).\n\n## كيف أُبلّغ عن أخطاء MCP؟\n\nافتح issue: \n\nأرفق:\n\n- إصدار خادم MCP\n- اسم العميل وإصداره\n- نظام التشغيل\n- السجلات ذات الصلة\n- خطوات إعادة الإنتاج\n\n## الخطوات التالية\n\n- [ما هو MCP؟](/docs/mcp/what-is-mcp)\n- [إعداد Claude Desktop](/docs/mcp/claude-desktop)\n- [استكشاف أخطاء MCP](/docs/mcp/troubleshooting)\n","content_html":"

أسئلة MCP الشائعة

\n

أسئلة شائعة عن خادم Synapse MCP.

\n

ما هو MCP؟

\n

MCP (Model Context Protocol) معيار مفتوح من Anthropic لتكامل\nLLM مع الأدوات. بدلًا من لصق وثائق الـ API في الـ prompts، تسجّل الأدوات\nمع خادم MCP، ويستدعيها الـ LLM كدوال أصلية.

\n

راجع ما هو MCP؟.

\n

كم أداة يعرض Synapse MCP؟

\n

79 أداة عبر 12 فئة: الذاكرة، الدردشة، المجدول، المهام، السكربتات،\nالأجهزة، الإشعارات، المستخدم، الأدوات، التصور، المشاركة، الـ webhooks، المتصفح.

\n

راجع ما هو MCP؟ للقائمة الكاملة.

\n

أي عملاء MCP مدعومون؟

\n\n

راجع إعداد Claude Desktop لأمثلة الإعداد.

\n

أي وسائل نقل مدعومة؟

\n
    \n
  1. stdio (محلي، موصى به لسطح المكتب)
    2. \n
  2. HTTP/SSE (بعيد، متعدد المستأجرين)
    3. \n
  3. WebSocket (موبايل، حجم عالي)
    4. \n
\n

كيف أُعدّ Claude Desktop؟

\n

حرّر claude_desktop_config.json:

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

راجع إعداد Claude Desktop.

\n

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

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

راجع استكشاف أخطاء MCP.

\n

كيف أستخدم عقلًا مختلفًا؟

\n

غيّر SYNAPSE_MIND_KEY في إعداد MCP وأعد تشغيل العميل.

\n

للعقول المتعددة، شغّل عدة نسخ من خادم MCP بمفاتيح\nMind Keys مختلفة.

\n

هل أستطيع تحديد الأدوات المعروضة؟

\n

نعم، استخدم ملفات الأدوات:

\n\n

عيينها عبر متغير البيئة MCP_PROFILE أو الترويسة Mcp-Tool-Profile.

\n

كيف أُصحّح مشكلات MCP؟

\n
    \n
  1. شغّل خادم MCP يدويًا: npx -y synapse-mcp-api@latest
    2. \n
  2. تحقق من سجلات العميل (تختلف حسب العميل)
    3. \n
  3. تحقق أن Mind Key يعمل: curl -H "Authorization: Bearer mk_..." .../memory/recall
    4. \n
  4. تحقق من صحة Synapse: curl https://synapse.schaefer.zone/health
    5. \n
\n

راجع استكشاف أخطاء MCP.

\n

هل خادم MCP مجاني؟

\n

نعم. حزمة npm synapse-mcp-api مفتوحة المصدر. خادم MCP المُستضاف\nعلى synapse-mcp.schaefer.zone مجاني للاستخدام العام.

\n

هل أستطيع استضافة خادم MCP بنفسي؟

\n

نعم:

\n
npm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api

كيف يختلف MCP عن استدعاءات API المباشرة؟

\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
الجانبAPI مباشرMCP
يحتاج LLM معرفةعناوين URL، الترويسات، المصادقةأسماء الأدوات فقط
معالجة المصادقةيدويتلقائي (متغير البيئة)
اكتشاف الأدواتاقرأ /endpointsتلقائي عبر بروتوكول MCP
معالجة الأخطاءيدويموحّد
الأفضل لـالتكاملات المخصصةوكلاء LLM
\n

هل أستطيع بناء عميل MCP خاص بي؟

\n

نعم. استخدم MCP SDK الرسمي:

\n\n

راجع عميل MCP مخصص.

\n

كيف أُبلّغ عن أخطاء MCP؟

\n

افتح issue: https://gitlab.com/schaefer-services/synapse-mcp/-/issues

\n

أرفق:

\n\n

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

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