مولّد إعدادات MCP
اختر عميلًا والخوادم التي تريدها. ستحصل على الإعدادات بالتنسيق الدقيق الذي يتوقعه العميل، وأوامر CLI المطابقة إذا كانت متاحة، وتحذيرًا بشأن ما لا يمكنه تشغيله.
{
"mcpServers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/"
},
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp"
},
"playwright": {
"type": "stdio",
"command": "npx",
"args": [
"@playwright/mcp@latest"
]
}
}
}
أو أضِفها من سطر الأوامر
claude mcp add --transport http --scope project github https://api.githubcopilot.com/mcp/
claude mcp add --transport http --scope project context7 https://mcp.context7.com/mcp
claude mcp add --scope project playwright -- npx @playwright/mcp@latest
آلية عمل المخرجات
مستضاف أو محلي
الخادم المستضاف هو عنوان URL يتصل به العميل عبر Streamable HTTP؛ يشغّله المورّد ولا يتطلب تثبيت أي شيء. أما الخادم المحلي فيبدأ كعملية فرعية عبر npx أو uvx أو docker، ويعمل بصلاحيات الوصول المتاحة على جهازك. إذا كان الخادم يوفّر الخيارين، فسيختار المولّد المستضاف أولًا، ويمكنك التبديل إلى المحلي.
لا تُحفظ الأسرار في الملف
لا يكتب المولّد مفتاحًا حقيقيًا أبدًا. ويستخدم صيغة الإشارة الخاصة بكل عميل: ${VAR} في Claude Code، و${env:VAR} في Cursor وWindsurf، ومطالبة inputs في VS Code، و$VAR في Gemini CLI، وenv_vars في Codex، و${{ secrets.VAR }} في Continue. أما العملاء الآخرون، فيستخدمون عنصرًا نائبًا بصيغة <VAR لتملأه بنفسك.
المصادقة عبر OAuth عند الاستخدام الأول
تستخدم معظم الخوادم المستضافة هنا OAuth لتسجيل الدخول. يفتح العميل متصفحًا عند الاتصال للمرة الأولى أو عند تشغيل خطوة تسجيل الدخول: /mcp في Claude Code، أو codex mcp login، أو devin mcp login، أو openclaw mcp login. لا تقبل Slack وAsana وHubSpot إلا العملاء المسجّلين مسبقًا، لذا تحقّق من أن عميلك مدعوم.
أعِد التحميل بعد التعديل
يقرأ Claude Desktop الملف عند بدء التشغيل، لذا أغلِقه وأعِد فتحه بعد أي تغيير؛ وتجد سجلاته في ~/Library/Logs/Claude على macOS. إذا لم يظهر خادم جديد في عميل آخر، فأعِد تشغيله أو أعِد تحميل النافذة. في OpenClaw، يختبر الأمر openclaw mcp doctor <name> --probe خادمًا واحدًا.
أسئلة حول الإعدادات
أين أضع mcp.json في Cursor وClaude Code؟
يقرأ Cursor الملف .cursor/mcp.json في المشروع، أو ~/.cursor/mcp.json لاستخدامه مع كل المشاريع. يقرأ Claude Code الملف .mcp.json في جذر المستودع على مستوى المشروع، ويحفظ إعدادات النطاقين المحلي ونطاق المستخدم في ~/.claude.json. يستخدم VS Code الملف .vscode/mcp.json، بينما يستخدم Codex الملف ~/.codex/config.toml بدلًا من JSON.
لماذا لا يُحمَّل خادم بعيد من claude_desktop_config.json؟
يقبل Claude Desktop الخوادم المحلية من هذا الملف فقط. يجب إضافة الخوادم البعيدة كموصلات مخصصة من الإعدادات > الموصلات، حيث تلصق URL وتسجّل الدخول. ولهذا السبب، يعرض المولّد عناوين URL هذه بشكل منفصل.
كيف أتجنب تضمين مفاتيح API في ملف .mcp.json مُلتزَم به؟
أشِر إلى متغير بيئة بدلًا من لصق المفتاح. يوسّع Claude Code الصيغتين ${VAR} و${VAR:-default}، ويوسّع Cursor الصيغة ${env:NAME}، ويمكن لـ VS Code طلب سرّ عبر إدخال inputs. اضبط المتغير في الصدفة أو مدير الأسرار قبل تشغيل العميل.
هل يمكنني إعادة استخدام إعداد MCP نفسه مع عملاء مختلفين؟
ليس من دون تعديل: المفتاح الأعلى مستوى هو mcpServers في معظم العملاء، لكنه servers في .vscode/mcp.json، وcontext_servers في Zed، وجداول mcp_servers في Codex. تستورد بعض العملاء ملفات عملاء آخرين: يكتشف VS Code إعدادات Claude Desktop وCursor وWindsurf، ويقبل Continue إسقاط ملف mcp.json فيه، كما يتضمن JetBrains AI Assistant خيار Import from Claude.
لماذا يفشل npx في Claude Desktop على Windows؟
تعليمات README الخاصة بخوادم MCP تشغّل npx عبر cmd في Windows: استخدم command بقيمة cmd، مع /c وnpx والحزمة كوسائط. يضيف المولّد هذا الغلاف تلقائيًا عند اختيار Claude Desktop وWindows.
هل أستخدم النسخة المستضافة أم المحلية من الخادم؟
النسخة المستضافة أبسط: لا تحتاج إلى تثبيت بيئة تشغيل، ويحل OAuth محل الرموز طويلة الأمد المخزنة على القرص. تكون النسخة المحلية مناسبة عندما يحتاج الخادم إلى ملفات أو بيانات اعتماد على جهازك، أو عندما لا تتوفر نقطة نهاية مستضافة، كما في Filesystem وPlaywright أو خادم AWS API.