{"title":"ما هو MCP؟","slug":"what-is-mcp","category":"mcp","summary":"Model Context Protocol يتيح لـ LLMs استدعاء أدوات خارجية. يعرض Synapse 79 أداة عبر خادم MCP رسمي.","audience":["human","llm"],"tags":["mcp","intro","overview"],"difficulty":"beginner","updated":"2026-06-27","word_count":553,"read_minutes":3,"llm_context":"MCP = Model Context Protocol (Anthropic, 2024). Open standard for LLM-tool integration.\nSynapse has official MCP server: synapse-mcp-api (npm package, npx -y synapse-mcp-api@latest)\n79 tools exposed: 22 memory, 7 chat, 8 scheduler, 4 tasks, 5 scripts, 9 computers, 4 push, 5 user, 3 utility\n3 transports: stdio (local), HTTP/SSE (remote), WebSocket (mobile)\nSupported clients: Claude Desktop, Claude Code, Cursor, Continue, Cline, any MCP-compatible client\nTool Profiles (v1.4.0): minimal (8 tools), standard (25), full (119) — controlled via MCP_PROFILE env or Mcp-Tool-Profile header\n","lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# ما هو MCP؟\n\n**Model Context Protocol (MCP)** معيار مفتوح من Anthropic (2024)\nيتيح لـ LLMs استدعاء أدوات خارجية بطريقة منظمة. بدلًا من لصق وثائق API\nفي الـ prompt، تسجّل الأدوات مع خادم MCP، ويستدعيها الـ LLM\nعند الحاجة — مثل استدعاء الدوال، لكن موحّد ومستقل عن العميل.\n\n## خادم Synapse MCP\n\nيأتي Synapse بخادم MCP رسمي (`synapse-mcp-api` على npm) يعرض\n**79 أداة** تغطي جميع ميزات Synapse:\n\n| الفئة | الأدوات | العدد |\n|----------|-------|-------|\n| الذاكرة | recall, list, store, search, semantic-search, update, delete, bulk-delete, stats, unverified, contradictions, audit, related, by-tag, diff, expiring, health, sync, embed-batch, verify, unverify, mind-export | 22 |\n| الدردشة | poll, reply, status, history, unread, send, upload | 7 |\n| المجدول | cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete | 8 |\n| المهام | task_list, task_get, task_create, task_update | 4 |\n| السكربتات | script_list, script_get, script_info, script_store, script_delete | 5 |\n| الأجهزة | computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete | 9 |\n| الإشعارات | vapid_public_key, subscribe, unsubscribe, test | 4 |\n| المستخدم/العقل | register, login, minds_list, mind_create, mind_delete | 5 |\n| الأدوات | time, calc, random | 3 |\n| التصور | graph, tags, compact | 3 |\n| المشاركة | share, list, revoke | 3 |\n| الـ Webhooks | register, list, get, update, delete | 5 |\n| المتصفح | new, navigate, click, type, screenshot, close | 6 |\n| **الإجمالي** | | **79+** |\n\n## كيف يعمل\n\n```\n┌──────────────────┐ MCP protocol ┌──────────────────┐ HTTP ┌──────────┐\n│ LLM Client │ ◀─────────────────▶│ Synapse MCP │ ─────────▶ │ Synapse │\n│ (Claude/Cursor) │ (stdio/SSE/WS) │ Server │ │ API │\n└──────────────────┘ └──────────────────┘ └──────────┘\n```\n\n1. تُعدّ عميل LLM (Claude Desktop، Cursor، إلخ) لاستخدام خادم Synapse MCP\n2. يبدأ العميل خادم MCP (عبر `npx -y synapse-mcp-api@latest`)\n3. يتصل خادم MCP بـ Synapse API باستخدام Mind Key الخاص بك\n4. يرى الـ LLM جميع الأدوات الـ 79 كدوال أصلية يستطيع استدعاءها\n5. عندما يحتاج الـ LLM لتذكر شيء، يستدعي `memory_store` — يترجم خادم MCP هذا إلى `POST /memory` على Synapse\n\n## وسائل النقل\n\nيدعم خادم Synapse MCP ثلاث وسائل نقل:\n\n### stdio (محلي، موصى به لسطح المكتب)\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 }\n }\n }\n}\n```\n\n### HTTP/SSE (بعيد، متعدد المستأجرين)\n\nاربط عميل MCP الخاص بك بـ:\n\n```\nURL: https://synapse-mcp.schaefer.zone/sse\nHeaders: Authorization: Bearer YOUR_MIND_KEY\n```\n\n### WebSocket (موبايل، حجم عالي)\n\n```\nURL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY\n```\n\n## ملفات الأدوات (v1.4.0)\n\nلتقليل عبء الرموز لـ LLMs أصغر، خادم MCP يدعم ثلاثة\nملفات أدوات:\n\n| الملف | الأدوات | الرموز | الأفضل لـ |\n|---------|-------|--------|----------|\n| `minimal` | 8 (إرسال مركب) | ~500 | LLMs مستضافة ذاتيًا بسياق ≤8k |\n| `standard` | 25 (مُسمّاة) | ~2,500 | LLMs متوسطة (Claude Haiku، GPT-3.5) |\n| `full` | 119 (الكل) | ~8,250 | LLMs كبيرة (Claude Sonnet/Opus، GPT-4) — افتراضي |\n\nالتحكم عبر:\n\n- متغير البيئة: `MCP_PROFILE=minimal|standard|full`\n- الترويسة: `Mcp-Tool-Profile: minimal|standard|full`\n\n## العملاء المدعومون\n\n- [Claude Desktop](/docs/mcp/claude-desktop) — تطبيق سطح المكتب من Anthropic\n- [Claude Code](/docs/mcp/claude-code) — وكيل برمجة طرفي\n- [Cursor](/docs/mcp/cursor) — IDE ذكي مدعوم بـ AI\n- [Continue.dev](/docs/mcp/continue) — مساعد برمجة ذكي مفتوح المصدر\n- [Cline](/docs/mcp/claude-code) — امتداد VS Code\n- أي عميل متوافق مع MCP\n\n## لماذا تستخدم MCP بدلًا من API مباشر؟\n\n| النهج | المزايا | العيوب |\n|----------|------|------|\n| API مباشر | بسيط، بلا طبقة إضافية | يحتاج LLM معرفة عناوين URL، الترويسات، المصادقة |\n| MCP | يرى الـ LLM أدوات أصلية، بلا حفظ URL | عملية خادم MCP إضافية |\n\nلمعظم حالات استخدام وكلاء LLM، MCP الخيار الأفضل — الـ LLM لا يحتاج\nلتذكر مسارات API أو أنماط المصادقة.\n\n## الخطوات التالية\n\n- [إعداد Claude Desktop](/docs/mcp/claude-desktop) — إعداد بدقيقتين\n- [إعداد Claude Code](/docs/mcp/claude-code) — تكامل الـ terminal\n- [عميل MCP مخصص](/docs/mcp/custom-client) — ابنِ خاصتك\n","content_html":"

ما هو MCP؟

\n

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

\n

خادم Synapse MCP

\n

يأتي Synapse بخادم MCP رسمي (synapse-mcp-api على npm) يعرض\n79 أداة تغطي جميع ميزات Synapse:

\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\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
الفئةالأدواتالعدد
الذاكرةrecall, list, store, search, semantic-search, update, delete, bulk-delete, stats, unverified, contradictions, audit, related, by-tag, diff, expiring, health, sync, embed-batch, verify, unverify, mind-export22
الدردشةpoll, reply, status, history, unread, send, upload7
المجدولcron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete8
المهامtask_list, task_get, task_create, task_update4
السكربتاتscript_list, script_get, script_info, script_store, script_delete5
الأجهزةcomputer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete9
الإشعاراتvapid_public_key, subscribe, unsubscribe, test4
المستخدم/العقلregister, login, minds_list, mind_create, mind_delete5
الأدواتtime, calc, random3
التصورgraph, tags, compact3
المشاركةshare, list, revoke3
الـ Webhooksregister, list, get, update, delete5
المتصفحnew, navigate, click, type, screenshot, close6
الإجمالي79+
\n

كيف يعمل

\n
┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐\n│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │\n│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │\n└──────────────────┘                    └──────────────────┘            └──────────┘
    \n
  1. تُعدّ عميل LLM (Claude Desktop، Cursor، إلخ) لاستخدام خادم Synapse MCP
    2. \n
  2. يبدأ العميل خادم MCP (عبر npx -y synapse-mcp-api@latest)
    3. \n
  3. يتصل خادم MCP بـ Synapse API باستخدام Mind Key الخاص بك
    4. \n
  4. يرى الـ LLM جميع الأدوات الـ 79 كدوال أصلية يستطيع استدعاءها
    5. \n
  5. عندما يحتاج الـ LLM لتذكر شيء، يستدعي memory_store — يترجم خادم MCP هذا إلى POST /memory على Synapse
    6. \n
\n

وسائل النقل

\n

يدعم خادم Synapse MCP ثلاث وسائل نقل:

\n

stdio (محلي، موصى به لسطح المكتب)

\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      }\n    }\n  }\n}

HTTP/SSE (بعيد، متعدد المستأجرين)

\n

اربط عميل MCP الخاص بك بـ:

\n
URL: https://synapse-mcp.schaefer.zone/sse\nHeaders: Authorization: Bearer YOUR_MIND_KEY

WebSocket (موبايل، حجم عالي)

\n
URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY

ملفات الأدوات (v1.4.0)

\n

لتقليل عبء الرموز لـ LLMs أصغر، خادم MCP يدعم ثلاثة\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
الملفالأدواتالرموزالأفضل لـ
minimal8 (إرسال مركب)~500LLMs مستضافة ذاتيًا بسياق ≤8k
standard25 (مُسمّاة)~2,500LLMs متوسطة (Claude Haiku، GPT-3.5)
full119 (الكل)~8,250LLMs كبيرة (Claude Sonnet/Opus، GPT-4) — افتراضي
\n

التحكم عبر:

\n\n

العملاء المدعومون

\n\n

لماذا تستخدم MCP بدلًا من API مباشر؟

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
النهجالمزاياالعيوب
API مباشربسيط، بلا طبقة إضافيةيحتاج LLM معرفة عناوين URL، الترويسات، المصادقة
MCPيرى الـ LLM أدوات أصلية، بلا حفظ URLعملية خادم MCP إضافية
\n

لمعظم حالات استخدام وكلاء LLM، MCP الخيار الأفضل — الـ LLM لا يحتاج\nلتذكر مسارات API أو أنماط المصادقة.

\n

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

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