منشئ إعدادات MCP
أنشئ إعدادات خادم MCP لـ Claude Desktop أو Claude Code أو Cursor أو VS Code أو Codex CLI أو Gemini CLI أو Devin Desktop (المعروف سابقًا باسم Windsurf): أدخل أمرًا أو رابط خادم، ثم انسخ JSON أو TOML مع تحديد الملف الذي ينبغي وضع الإعدادات فيه.
الإدخال
الإخراج
| الموقع | الملف |
|---|---|
macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
Windows | %APPDATA%\Claude\claude_desktop_config.json |
Linux | ~/.config/Claude/claude_desktop_config.json |
الخوادم البعيدة | الإعدادات > الموصلات > إضافة موصل مخصص |
ملف القراءة
ما MCP؟
بروتوكول سياق النموذج (MCP) معيار مفتوح يتيح لمساعدي الذكاء الاصطناعي استخدام الأدوات والبيانات عبر الخوادم. والخادم إما برنامج محلي يشغّله المساعد على حاسوبك ويتواصل معه عبر الإدخال والإخراج القياسيين (stdio)، وإما خادم بعيد يصل إليه المساعد عبر HTTP. ويحتفظ كل مساعد بخوادمه في ملف إعدادات خاص به، ويختلف شكل كل ملف قليلًا عن غيره.
طريقة الاستخدام
- اختر العميل: المساعد أو المحرر الذي تستخدمه.
- امنح الخادم اسمًا يتكوّن من أحرف وأرقام وواصلات وشرطات سفلية.
- للخادم المحلي، أدخل الأمر الذي يشغّله (مثل
npxأوuvxأوdocker)، ومعاملاته بحيث يكون كل معامل في سطر، وأي متغيرات بيئة، مثل مفاتيح API، بالصيغةKEY=value. وإذا لصقت سطر أوامر كاملًا في حقل الأمر، فإن زر التقسيم الموجود داخله ينقل كل ما يلي الكلمة الأولى إلى المعاملات. - للخادم البعيد، اختر عنوان URL بعيد وأدخل عنوان URL للخادم وأي ترويسات، مثل
Authorization: Bearer <token>. - انسخ الإعدادات إلى الملف المذكور تحت مكان إضافته، أو نزّلها. وإذا كان الملف يحتوي بالفعل على خوادم، فأضف الإدخال الجديد بجانبها داخل
mcpServers([mcp_servers]في Codex) بدلًا من استبدال الملف بأكمله. - أعد تشغيل التطبيق أو أعد تحميل خوادم MCP الخاصة به.
بالنسبة إلى Claude Code وCodex CLI وGemini CLI وVS Code، يعرض مربع الأمر أيضًا أمر الطرفية الذي يضيف الخادم نيابةً عنك.
العملاء
| العميل | ملف الإعدادات | معلومات مفيدة |
|---|---|---|
| Claude Desktop | claude_desktop_config.json |
يحتوي على الخوادم المحلية فقط. أما الخوادم البعيدة فتُضاف في التطبيق من الإعدادات > الموصلات > إضافة موصل مخصص. |
| Claude Code | .mcp.json في جذر المشروع |
يخزّن claude mcp add الخوادم في ~/.claude.json بدلًا من ذلك، لك وحدك. |
| Cursor | .cursor/mcp.json في المشروع، أو ~/.cursor/mcp.json |
|
| VS Code مع GitHub Copilot | .mcp.json في جذر مساحة العمل، أو ~/.copilot/mcp-config.json |
صيغة servers الأقدم في .vscode/mcp.json مخصصة فقط لإطار التشغيل المحلي المهمل في VS Code. |
| Codex CLI | ~/.codex/config.toml |
ملف TOML. ولا يمكن ضبط ترويسات الخادم البعيد إلا في الملف، وليس باستخدام codex mcp add. |
| Gemini CLI | .gemini/settings.json في المشروع، أو ~/.gemini/settings.json |
تستخدم الخوادم البعيدة httpUrl. |
| Devin Desktop (Windsurf) | ~/.config/devin/mcp_config.json، أو .devin/mcp_config.json |
تغيّر اسم Windsurf إلى Devin Desktop. وتوضع المفاتيح الشخصية في .devin/mcp_config.local.json، الذي يبقى خارج نظام التحكم في الإصدارات. |
يحفظ Chrome الملف المنزَّل باسم .mcp.json على شكل mcp.json، لذا أعد إضافة النقطة في بداية الاسم عند نقل الملف إلى مكانه.
الحفاظ على أمان المفاتيح
تحفظ ملفات الإعدادات مفاتيح API كنص عادي. لا تُودِع ملف مشروع يحتوي على مفاتيح حقيقية في مستودع مشترك. ويمكن لمعظم العملاء قراءة المفتاح من متغيرات البيئة لديك بدلًا من الملف، ولكل منها صياغته الخاصة الموضحة في وثائقه.
يُجمَّع كل شيء في متصفحك، لذا لا تُرسل الأوامر وعناوين URL والمفاتيح التي تدخلها إلى أي مكان.