أسئلة MCP الشائعة
أسئلة شائعة عن تكامل MCP — الأدوات، النقل، استكشاف الأخطاء.
أسئلة MCP الشائعة
أسئلة شائعة عن خادم Synapse MCP.
ما هو MCP؟
MCP (Model Context Protocol) معيار مفتوح من Anthropic لتكامل LLM مع الأدوات. بدلًا من لصق وثائق الـ API في الـ prompts، تسجّل الأدوات مع خادم MCP، ويستدعيها الـ LLM كدوال أصلية.
راجع ما هو MCP؟.
كم أداة يعرض Synapse MCP؟
79 أداة عبر 12 فئة: الذاكرة، الدردشة، المجدول، المهام، السكربتات، الأجهزة، الإشعارات، المستخدم، الأدوات، التصور، المشاركة، الـ webhooks، المتصفح.
راجع ما هو MCP؟ للقائمة الكاملة.
أي عملاء MCP مدعومون؟
- Claude Desktop (macOS، Windows)
- Claude Code (terminal)
- Cursor (IDE)
- Continue.dev (VS Code، JetBrains)
- Cline (VS Code)
- أي عميل متوافق مع MCP
راجع إعداد Claude Desktop لأمثلة الإعداد.
أي وسائل نقل مدعومة؟
- stdio (محلي، موصى به لسطح المكتب)
- HTTP/SSE (بعيد، متعدد المستأجرين)
- WebSocket (موبايل، حجم عالي)
كيف أُعدّ Claude Desktop؟
حرّر claude_desktop_config.json:
{
"mcpServers": {
"synapse": {
"command": "npx",
"args": ["-y", "synapse-mcp-api@latest"],
"env": {
"SYNAPSE_MIND_KEY": "mk_YOUR_KEY",
"SYNAPSE_URL": "https://synapse.schaefer.zone"
}
}
}
}راجع إعداد Claude Desktop.
لماذا لا تظهر الأدوات في Claude Desktop؟
- أعد تشغيل Claude Desktop بالكامل (Cmd+Q على macOS)
- تحقق أن ملف الإعداد JSON صالح
- تحقق أن Node.js 18+ مثبت
- تحقق من سجلات MCP:
~/Library/Logs/Claude/mcp.log
راجع استكشاف أخطاء MCP.
كيف أستخدم عقلًا مختلفًا؟
غيّر SYNAPSE_MIND_KEY في إعداد MCP وأعد تشغيل العميل.
للعقول المتعددة، شغّل عدة نسخ من خادم MCP بمفاتيح Mind Keys مختلفة.
هل أستطيع تحديد الأدوات المعروضة؟
نعم، استخدم ملفات الأدوات:
minimal: 8 أدوات مركبة (~500 رمز)standard: 25 أداة (~2,500 رمز)full: 119 أداة (~8,250 رمز، افتراضي)
عيينها عبر متغير البيئة MCP_PROFILE أو الترويسة Mcp-Tool-Profile.
كيف أُصحّح مشكلات MCP؟
- شغّل خادم MCP يدويًا:
npx -y synapse-mcp-api@latest - تحقق من سجلات العميل (تختلف حسب العميل)
- تحقق أن Mind Key يعمل:
curl -H "Authorization: Bearer mk_..." .../memory/recall - تحقق من صحة Synapse:
curl https://synapse.schaefer.zone/health
راجع استكشاف أخطاء MCP.
هل خادم MCP مجاني؟
نعم. حزمة npm synapse-mcp-api مفتوحة المصدر. خادم MCP المُستضاف
على synapse-mcp.schaefer.zone مجاني للاستخدام العام.
هل أستطيع استضافة خادم MCP بنفسي؟
نعم:
npm install -g synapse-mcp-api
SYNAPSE_URL=https://your-synapse-instance.com \
SYNAPSE_MIND_KEY=mk_... \
synapse-mcp-apiكيف يختلف MCP عن استدعاءات API المباشرة؟
| الجانب | API مباشر | MCP |
|---|---|---|
| يحتاج LLM معرفة | عناوين URL، الترويسات، المصادقة | أسماء الأدوات فقط |
| معالجة المصادقة | يدوي | تلقائي (متغير البيئة) |
| اكتشاف الأدوات | اقرأ /endpoints | تلقائي عبر بروتوكول MCP |
| معالجة الأخطاء | يدوي | موحّد |
| الأفضل لـ | التكاملات المخصصة | وكلاء LLM |
هل أستطيع بناء عميل MCP خاص بي؟
نعم. استخدم MCP SDK الرسمي:
- TypeScript:
@modelcontextprotocol/sdk - Python:
mcp
راجع عميل MCP مخصص.
كيف أُبلّغ عن أخطاء MCP؟
افتح issue: https://gitlab.com/schaefer-services/synapse-mcp/-/issues
أرفق:
- إصدار خادم MCP
- اسم العميل وإصداره
- نظام التشغيل
- السجلات ذات الصلة
- خطوات إعادة الإنتاج