الإجابة المختصرة
تحفظ معظم تطبيقات الذكاء الاصطناعي خوادم MCP تحت المفتاح mcpServers في ملف JSON واحد. ويستخدم VS Code المفتاح servers، وZed المفتاح context_servers، وCodex جدول TOML. ابحث عن تطبيقك أدناه، وعدّل ملفه، ثم أغلقه تمامًا وأعد فتحه. وحدود الأدوات نادرة: 128 أداة لكل طلب في VS Code، و100 في Windsurf.
في هذا الدليل
أين يوجد ملف إعداد MCP في كل تطبيق؟
لمعظم التطبيقات ملف لكل مشاريعك وملف لمشروع واحد. يذكر الجدول الملفين، وطريقة فتحهما، والمفتاح الذي توضع تحته خوادمك.
| التطبيق | ملف الإعداد | المفتاح |
|---|---|---|
Claude Codeclaude mcp add، أو /mcp داخل جلسة |
~/.claude.json. أما ملف .mcp.json الخاص بالمشروع فمُعدّ لمشاركته مع فريقك. | mcpServers |
| Claude DesktopSettings ثم Developer ثم Edit Config |
| mcpServers |
| Cursor |
| mcpServers |
VS Codeالأمر: MCP: Open User Configuration |
| serversصيغة VS Code الخاصة. أما ملف .mcp.json المحمول في جذر المشروع فيستخدم mcpServers. |
| Windsurfأصبح توثيق Windsurf الآن ضمن Devin Desktop |
| mcpServers |
| Gemini CLI |
| mcpServers |
Codexcodex mcp add <name> -- <command> |
| [mcp_servers.<name>]جدول TOML لكل خادم. |
| LM Studioتبويب Program ثم Install ثم Edit mcp.json |
| mcpServers |
| Clineأيقونة MCP Servers ثم تبويب Configure ثم Configure MCP Servers |
CLINE_MCP_SETTINGS_PATH لنقل الملف. وداخل VS Code يوجد في مجلد إعدادات المستخدم. | mcpServers |
| Roo Codeإعدادات MCP، ثم Edit Global MCP أو Edit Project MCP |
| mcpServers |
| Amazon Qلوحة الدردشة، ثم أيقونة الأدوات |
default.json. ولا يزال الملفان الأقدم ~/.aws/amazonq/mcp.json و.amazonq/mcp.json يُقرآن افتراضيًا. | mcpServersفي الملف الأقدم mcp.json. |
Zedالأمر: zed: open settings file |
| context_servers |
~ هو مجلد المنزل لديك: C:\Users\you على Windows.
كيف تُعدّ خادم MCP بعيدًا في كل تطبيق؟
يحتاج الخادم البعيد (HTTP) إلى عنوان URL، لكن كل تطبيق يسمّي الحقول بطريقته. فالإدخال نفسه لا يصلح للنسخ من تطبيق إلى آخر.
| التطبيق | الحقول | معلومة مفيدة |
|---|---|---|
| Claude Code |
| |
| Claude Desktop | — | لا يُكتب في هذا الملف. أضفه كموصّل مخصص من Connectors في إعدادات التطبيق. |
| Cursor |
| |
| VS Code |
| |
| Windsurf |
| أي من الاسمين يصلح للعنوان. |
| Gemini CLI |
| httpUrl للنقل streamable HTTP، وurl للنقل SSE. |
| Codex |
| يُكتب في جدول TOML الخاص بالخادم. |
| LM Studio |
| |
| Cline |
| استخدم sse لوسيلة النقل الأقدم. |
| Roo Code |
| استخدم sse لوسيلة النقل الأقدم. |
| Amazon Q | — | يُضبط من لوحة MCP: اختر http وسيلةً للنقل، ثم عنوان URL والترويسات الاختيارية. |
| Zed |
|
ما حد أدوات MCP في كل تطبيق؟
حدود الأدوات نادرة. تطبيقان فقط يذكران حدًا. أما البقية فتتعامل مع قوائم الأدوات الطويلة بطريقتها.
| التطبيق | الحد | ما يفعله مع قوائم الأدوات الطويلة |
|---|---|---|
| VS Code | 128 أداة لكل طلب | بعده يعرض VS Code الرسالة Cannot have more than 128 tools per request. ألغِ تحديد أدوات أو خوادم كاملة في منتقي الأدوات، أو اضبط github.copilot.chat.virtualTools.threshold ليجمع VS Code الأدوات المتشابهة. |
| Windsurf | 100 أداة في آن واحد | عطّل الأدوات واحدة واحدة عبر disabledTools في إدخال الخادم. |
| Cursor | لا حد مذكور | يُذكر عادةً أن الحد 40 أداة. ولا يذكر توثيق Cursor أي حد، ويصف منشور Cursor في يناير 2026 تحميل أوصاف أدوات MCP عند الحاجة. |
| Claude Code | لا حد مذكور | Tool Search مفعّل افتراضيًا: لا يدخل سياقك إلا أسماء الأدوات إلى أن تُستخدم أداة. |
| Codex | لا حد مذكور | يقبل كل خادم قائمتي enabled_tools وdisabled_tools. |
| Amazon Q | لا حد مذكور | تُضبط كل أداة على Ask أو Always allow أو Deny. |
لا يذكر Claude Desktop وGemini CLI وLM Studio وCline وRoo Code وZed أي حد للأدوات.
الحد يخص عدد الأدوات التي يتسع لها التطبيق. أما تكلفة هذه الأدوات بالتوكنات فمسألة أخرى، يجيب عنها الدليل التالي. لماذا يستهلك MCP توكناتك بكثرة
لماذا لا يظهر خادم MCP لديك؟
اتبع هذه القائمة بالترتيب. وهي مأخوذة من دليل حل المشكلات في مشروع MCP، المكتوب من أجل Claude Desktop. وتنطبق الخطوات الأربع الأولى على أي تطبيق.
- إغلاق التطبيق تمامًا ثم إعادة فتحه
يقول دليل Claude Desktop إن عليك إغلاقه تمامًا ثم تشغيله من جديد بعد تعديل ملفه. وقد تعيد تطبيقات أخرى التحميل وحدها: أعد فتح تطبيقك إذا لم يظهر الخادم.
- التحقق من JSON ومن المفتاح
خطأ في الصياغة، كعلامة اقتباس ناقصة أو فاصلة زائدة، قد يمنع التطبيق من قراءة الملف. ثم تحقّق من المفتاح:
mcpServersفي معظم التطبيقات، وserversفي VS Code، وcontext_serversفي Zed. - استخدام مسارات مطلقة
يجب أن تكون المسارات في
argsمطلقة، لا نسبية. - تشغيل الأمر بنفسك
الصق أمر الخادم ووسائطه في الطرفية. إذا فشل هناك، فلن يتمكن التطبيق من تشغيله أيضًا.
- قراءة السجلات
يكتب Claude Desktop الملف
mcp.logوملفًاmcp-server-NAME.logلكل خادم، في~/Library/Logs/Claudeعلى macOS و%APPDATA%\Claude\logsعلى Windows. - على Windows، تحقّق من APPDATA
إذا أظهر أحد السجلات
${APPDATA}داخل مسار، فأضفAPPDATAإلىenvالخاص بالخادم بقيمته الكاملة، مثلC:\Users\you\AppData\Roaming\.
هل عليك تعديل هذه الملفات يدويًا؟
ليس لرؤيتها كلها في مكان واحد. يقرأ Delta MCP إعدادات MCP في اثني عشر تطبيقًا للذكاء الاصطناعي، هي المذكورة في الجداول أعلاه، دون أن يغيّر شيئًا، ويعرض كل خادم يجده.
ولاستخدام هذه الخوادم عبر Delta MCP، يحوّل التطبيق بإضافة إدخال واحد باسم mcpdelta. ويعطّل الإدخال المباشر لكل خادم ينقله ويحتفظ بالأصل، ليعيده كما كان. عشرة تطبيقات تُحوَّل نيابة عنك؛ أما Codex وZed فيُعدّان يدويًا حاليًا. وقبل كل تغيير يحفظ نسخة مؤرَّخة من الملف.
أسئلة
أين يوجد ملف claude_desktop_config.json؟
على macOS هو ~/Library/Application Support/Claude/claude_desktop_config.json، وعلى Windows %APPDATA%\Claude\claude_desktop_config.json. وأسرع طريقة هي Settings ثم Developer ثم Edit Config، التي تنشئ الملف إن لم يكن موجودًا. ويتوفر Claude Desktop على macOS وWindows.
أين يوجد ملف mcp.json في Cursor؟
الملف ~/.cursor/mcp.json يحفظ خوادم كل مشاريعك، و.cursor/mcp.json داخل المشروع يحفظ خوادم ذلك المشروع. وكلاهما يستخدم المفتاح mcpServers.
أين يوجد ملف mcp.json في VS Code؟
ملف المشروع هو .vscode/mcp.json. وملفك الخاص في مجلد ملف تعريف المستخدم: شغّل MCP: Open User Configuration لفتحه. ويكتب VS Code الخوادم تحت servers، لا mcpServers.
ما حد أدوات MCP في VS Code؟
يمكن تفعيل 128 أداة كحد أقصى في طلب الدردشة الواحد، ويعرض VS Code الرسالة Cannot have more than 128 tools per request عند تجاوزه. ألغِ تحديد أدوات أو خوادم في منتقي الأدوات، أو اضبط github.copilot.chat.virtualTools.threshold ليجمع VS Code الأدوات المتشابهة.
هل يفرض Cursor حدًا لأدوات MCP؟
لا يذكر توثيقه أي حد؛ والرقم المتداول هو 40 أداة. وفي يناير 2026 وصف Cursor تحميل أوصاف أدوات MCP عند الحاجة.
لماذا لا يعمل إعداد MCP الخاص بي في تطبيق آخر؟
لأن المفتاح وحقول الخادم البعيد تختلف. تستخدم معظم التطبيقات mcpServers؛ ويستخدم VS Code المفتاح servers، وZed المفتاح context_servers، وCodex جدول TOML. والخادم البعيد يُكتب url في Cursor، وserverUrl أو url في Windsurf، وhttpUrl أو url في Gemini CLI، وtype مع url في Claude Code وVS Code.
هل يستطيع Claude Desktop استخدام خوادم MCP بعيدة من ملف إعداده؟
لا. تُضاف الخوادم البعيدة كموصّلات مخصصة في إعدادات التطبيق. أما الخوادم الموجودة في claude_desktop_config.json فآلية منفصلة، وهي غير متوفرة في Cowork ولا في claude.ai.
أين يحفظ Claude Code خوادم MCP؟
خوادمك الخاصة وخوادم كل مشروع في ~/.claude.json. أما ملف .mcp.json في جذر المشروع فمُعدّ لمشاركته مع فريقك. أضف خادمًا بالأمر claude mcp add، أو بالأمر /mcp داخل جلسة. وكلا الملفين يستخدم المفتاح mcpServers.
أين يوجد ملف mcp_config.json في Windsurf؟
أصبح توثيق Windsurf الآن ضمن Devin Desktop، وهو يذكر ~/.config/devin/mcp_config.json على macOS وLinux، و%APPDATA%\devin\mcp_config.json على Windows. وتستخدم الإصدارات الأقدم من Windsurf المسار ~/.codeium/windsurf/mcp_config.json. وتوضع الخوادم تحت mcpServers، ويتيح Windsurf 100 أداة في آن واحد.
المصادر
- Claude Code, Connect Claude Code to tools via MCP (documentation) الملفان ~/.claude.json و.mcp.json، والمفتاح mcpServers، والنوع http، وتفعيل Tool Search افتراضيًا.
- Model Context Protocol, Connect to local MCP servers مسارات ملفات Claude Desktop، وEdit Config، وإعادة التشغيل، وخطوات حل المشكلات، ومجلدات السجلات.
- Claude Help Center, Get started with custom connectors using remote MCP الخوادم البعيدة موصّلات مخصصة، وملف claude_desktop_config.json منفصل عنها.
- Cursor, Model Context Protocol (documentation) ملفا mcp.json العام والخاص بالمشروع، وmcpServers، وurl وheaders؛ ولا حد مذكور للأدوات.
- Cursor, Dynamic context discovery (6 يناير 2026) تحميل أوصاف أدوات MCP عند الحاجة.
- Cursor forum, About limitation of the number of MCP tools بلاغ من أحد المستخدمين عن حد 40 أداة.
- VS Code, Add and manage MCP servers in VS Code (documentation) ملفا mcp.json الخاصان بمساحة العمل وبالمستخدم، والمفتاح servers، وملف .mcp.json المحمول، والنوع http.
- VS Code, Use tools with agents (documentation) حد 128 أداة ورسالة الخطأ الخاصة به، ومنتقي الأدوات، والأدوات الافتراضية.
- Windsurf, Cascade MCP Configuration (documentation, now on Devin Desktop’s site) مسار الإعداد، وmcpServers، وserverUrl أو url، وحد 100 أداة، وdisabledTools.
- Gemini CLI, MCP servers with Gemini CLI (documentation) ملفات settings.json، وmcpServers، وhttpUrl وurl.
- OpenAI Codex, Model Context Protocol (documentation) الملف config.toml، وجدول mcp_servers، وurl، وenabled_tools وdisabled_tools، والأمر codex mcp add.
- LM Studio, Use MCP Servers (documentation) الخيار Edit mcp.json، وmcpServers، وurl وheaders.
- Cline, MCP (documentation) الملف cline_mcp_settings.json ومجلده، وتبويب Configure، وstreamableHttp.
- Roo Code, Using MCP in Roo Code (documentation) الملف العام mcp_settings.json وملف المشروع .roo/mcp.json، وstreamable-http.
- AWS, MCP configuration for Q Developer in the IDE الملف default.json والملف الأقدم mcp.json، ووسيلة النقل http، وأذونات الأدوات.
- Zed, Model Context Protocol (documentation) مسارات settings.json، وcontext_servers، وurl وheaders.
- Delta MCP, Supported AI apps (documentation) التطبيقات الاثنا عشر التي يتعرف عليها Delta MCP، والملفات التي يقرؤها، وطريقة تحويله لكل منها.
تابع القراءة
- كيف تقلل استهلاك توكنات MCP، ولماذا يستهلك الكثير منهاكيف تقلل استهلاك توكنات MCP: قسه بالأمر /context، وافهم التكلفتين (قائمة الأدوات ورحلات الذهاب والإياب)، وقارن بين كل الحلول، ومنها Tool Search.
- MCP مقابل CLI لوكلاء الذكاء الاصطناعي: مصدر فاتورة التوكناتMCP أم CLI لوكيل الذكاء الاصطناعي لديك؟ تكلفة كل منهما بالتوكنات، وما تظهره القياسات، ومتى تتفوق CLI، ومتى يتفوق MCP، وأين يتفوق الكود على الاثنين.
