مولّد config
لـ MCP
كل عميل MCP يريد ملفًا مختلفًا في مكان مختلف بشكل JSON مختلف. اختر عميلك، واملأ خوادمك، وانسخ config صحيحًا من المرة الأولى.
عميلك، config الدقيق الخاص بك
Yetty مستوى تحكّم كامل عبر MCP لموقعك: الـ AI لديك ينشر ويحرّر ويفحص الـ SEO ويقرأ العملاء المحتملين، عبر هذا النوع تحديدًا من الـ config.
بروتوكول واحد،
سبع لهجات config
المفتاح الأعلى يختلف
معظم العملاء يقرؤون mcpServers، لكن VS Code يقرأ servers؛ ويتجاهل بصمت ملفًا بمفتاح خاطئ. تلك الكلمة الواحدة تكلّف الناس ساعات.
حقل الـ URL يختلف
Cursor يقول url، وWindsurf يقول serverUrl، وVS Code يريد url مع "type": "http"، وCline يريد "type": "streamableHttp". الخادم نفسه، أربع كتابات.
أدوات CLI تتخطى الملف
Claude Code يأخذ أمر claude mcp add بدلًا من ملف يُحرَّر يدويًا؛ مع الرايتين --transport http و --header للخوادم البعيدة. نحن نولّد سطر الأوامر الكامل.
المصادقة تركب على ترويسة
خوادم MCP المستضافة تصادق عادةً بـ Authorization: Bearer YOUR_KEY. وأين تذهب؛ كائن headers، أو راية --header، أو وسيط mcp-remote؛ يعتمد على العميل.
الـ JSON لا يسامح
فاصلة زائدة واحدة ويُسقِط العميل الملف كله، عادةً دون كلمة. هذه الأداة تبني الكائنات في الشيفرة وتسلسلها؛ الـ JSON غير الصالح مستحيل.
إعادة التشغيل تعني إعادة التشغيل
معظم العملاء يقرؤون config الـ MCP عند بدء التشغيل فقط. أغلق بالكامل وأعد الفتح بعد التحرير؛ إغلاق النافذة لا يكفي، و"لم ينجح" غالبًا هو هذا بالضبط.
أسئلة يطرحها الجميع
أين يقع ملف 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 بالكامل وأعد فتحه؛ إغلاق النافذة لا يكفي، فالـ config لا يُقرأ إلا عند بدء التشغيل.
ما الفرق بين خوادم MCP من نوع stdio و HTTP؟
خادم stdio برنامج يشغّله عميلك محليًا ويتحدث معه عبر stdin/stdout؛ تضبط أمرًا ووسائطه. خادم HTTP (Streamable HTTP) يعمل عن بُعد على عنوان URL ويصادق عادةً بترويسة Authorization: Bearer أو OAuth؛ تضبط الـ URL. الأدوات المحلية تأتي كـ stdio؛ الخدمات المستضافة مثل MCP الخاص بـ Yetty هي HTTP، فلا شيء لتثبيته.
لماذا لا يظهر خادم MCP لديّ في العميل؟
المشتبهون المعتادون، بالترتيب: الـ config في الملف الخطأ أو الموقع الخطأ لذلك العميل؛ شكل الـ JSON خاطئ لذلك العميل (Windsurf يريد serverUrl، وVS Code يريد مفتاح servers مع حقل type؛ فهم بالفعل جميعًا مختلفون)؛ الـ JSON به خطأ نحوي كفاصلة زائدة؛ أو أن العميل لم يُعَد تشغيله بالكامل بعد التحرير. ولّد الـ config هنا لعميلك بالضبط، وتُعالَج الأربعة كلها.