مرجع إعدادات عملاء MCP
يقرأ كل عميل MCP تعريفات الخوادم من موقعه الخاص، ضمن مفتاحه الخاص، وأحيانًا بتنسيقه الخاص. يوضّح هذا الجدول موضع البحث لدى كل عميل، والبنية المطلوبة، وما إذا كان يدعم OAuth للخوادم البعيدة.
| العميل | ملف الإعدادات | المفتاح الأعلى | التنسيق | OAuth عن بُعد | إضافة عبر CLI |
|---|---|---|---|---|---|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json | mcpServers | json | نعم | لا |
| Claude Code | .mcp.json | mcpServers | json | نعم | نعم |
| Cursor | .cursor/mcp.json | mcpServers | json | نعم | لا |
| VS Code (GitHub Copilot) | .vscode/mcp.json (key 'servers') or portable .mcp.json (key 'mcpServers') | servers | json | نعم | نعم |
| Windsurf / Devin Desktop | .devin/mcp_config.json (Devin CLI / Devin Local project scope) | mcpServers | json | نعم | نعم |
| Zed | ~/.config/zed/settings.json | context_servers | json | نعم | لا |
| OpenAI Codex CLI | .codex/config.toml (trusted projects only) | mcp_servers | toml | نعم | نعم |
| Gemini CLI | .gemini/settings.json | mcpServers | json | نعم | نعم |
| ChatGPT | من شاشة الإعدادات فقط | — | — | نعم | لا |
| OpenClaw | ~/.openclaw/openclaw.json | mcp.servers | json5 | نعم | نعم |
| Cline | ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json | mcpServers | json | غير موثّق | نعم |
| Continue | .continue/mcpServers/<name>.yaml (or drop a Claude/Cursor/Cline-style mcp.json into .continue/mcpServers/) | mcpServers | yaml | غير موثّق | لا |
| JetBrains AI Assistant | من شاشة الإعدادات فقط | mcpServers | json (pasted in UI) | غير موثّق | لا |
اختلافات قد تعطل الإعداد
يستخدم VS Code المفتاح servers
يضمّن .vscode/mcp.json الإدخالات ضمن servers، لا mcpServers، لذا لن يتم تحميل إعدادات Cursor أو Claude إذا لصقتها كما هي. يستخدم الملف المحمول الأحدث .mcp.json والملف ~/.copilot/mcp-config.json المفتاح mcpServers.
Gemini CLI يستخدم httpUrl لا url
يحدد Gemini CLI نوع النقل بناءً على اسم الحقل. يشير httpUrl إلى Streamable HTTP، وurl إلى نقل SSE القديم، وcommand إلى stdio. يتطلب الخادم البعيد الحديث httpUrl.
يعتمد OpenClaw وCline على SSE افتراضيًا
إذا لم تحدد نوع النقل لإدخال بعيد، فسيعود كلاهما إلى SSE القديم. عيّن transport إلى streamable-http في OpenClaw، وtype إلى streamableHttp في Cline.
يتطلب Claude Code تحديد type
في .mcp.json، يُعدّ الإدخال البعيد الذي يحتوي على url ولا يحتوي على type خطأً. أضف type http بجوار url؛ أما إدخالات stdio فتتطلب type stdio.
يستخدم Codex صيغة TOML وجدولًا لكل خادم
لا يستخدم Codex ملف JSON. يُعرَّف كل خادم في جدول مستقل باسم [mcp_servers.<name>] في config.toml، وتكون args مصفوفة TOML، بينما تمرّر env_vars الأسرار من shell باستخدام أسمائها.
يتطلب Continue قائمة YAML
في Continue، يكون mcpServers قائمةً من الإدخالات التي يحمل كل منها اسمًا، وليس خريطةً مفهرسة بالأسماء. ويجب أن يحتوي كل ملف كتلة أيضًا على name وversion وschema: v1 في أعلاه.