إعداد MCP في VS Code: استخدم servers بدل mcpServers

الفرق جنبًا إلى جنب

الخادم نفسه والأمر نفسه والوسائط نفسها. الشيء الوحيد الذي يتغير هو مفتاح الغلاف.

ما يريده VS Code

في الملف .vscode/mcp.json، في جذر مساحة العمل. بالاستعانة بموصّل MyLinedChart كمثال:

{ "servers": { "mylinedchart": { "command": "npx", "args": ["-y", "@mylinedchart/mcp-chart-context"] } } }

استبدل أمر خادمك الخاص ووسائطه. شكل الكائن الداخلي لا يتغير بين العملاء.

ما يريده كل شيء آخر

الخادم نفسه، لـ Claude أو Cursor:

{ "mcpServers": { "mylinedchart": { "command": "npx", "args": ["-y", "@mylinedchart/mcp-chart-context"] } } }

إذا كان المحرران مفتوحين معًا فأنت تحتاج فعلًا إلى الملفين. لا يستطيع المحرران مشاركة إعداد واحد.

لماذا يفشل دون خطأ

يقرأ VS Code الملف فيجده JSON صالحًا، ويبحث عن مفتاح servers. ليس في الملف مفتاح servers، فلا يجد VS Code أي خادم ليشغّله. صفر خوادم ليس حالة خطأ. من وجهة نظر VS Code أنت لم تضبط شيئًا، وهذا أمر مشروع تمامًا.

لذلك لا يوجد خط أحمر ولا إشعار ولا مدخل في أي سجل يقول إن المفتاح خاطئ. ويبدو الفشل تمامًا كأن الخادم انهار عند بدء التشغيل، ولهذا يذهب الناس لتصحيح الخادم.

• الملف JSON صالح، فلا يظهر خطأ تحليل.
• مفتاح المستوى الأعلى غير المعروف يُتجاهل بدل أن يُرفض.
• صفر خوادم مضبوطة حالة عادية، فلا يبلغ VS Code عن أي خلل.

كيف تتأكد أي مشكلة لديك

قبل افتراض أن الخادم معطّل، أثبت أن VS Code حاول تشغيله أصلًا.

• افحص مفتاح الغلاف أولًا. يكلّف الفحص خمس ثوانٍ وهو الجواب في معظم الأحيان.
• شغّل أمر الخادم يدويًا في الطرفية. إذا بدأ الخادم، فالمشكلة في مكان آخر.
• ابحث عن الخادم في قائمة خوادم MCP في VS Code. غيابه يعني أنه لم يُضبط قط؛ ووجوده مع فشله يعني خطأ فعليًا في بدء التشغيل.
• إذا ثبّتّه عبر رابط بنقرة واحدة بدل التحرير اليدوي، فهذه الفئة من المشاكل لا تنطبق عليك.

فخّان مرتبطان

ما دمت هنا، هناك أمران آخران يفشلان بالصمت نفسه.

الأول: روابط تثبيت MCP بنقرة واحدة تحمل حمولتها كـ JSON مشفّر بصيغة URL عادية. يقبل محلل الروابط صيغة Base64 ثم لا يفعل شيئًا بصمت، وهذا أسوأ فشل ممكن: زر يبدو أنه نجح.

الثاني: يسافر اسم الخادم داخل الحمولة في VS Code بدل أن يكون معاملًا منفصلًا في الاستعلام كما يفعل Cursor. الرابط المبني على شكل Cursor لن يثبّت بشكل صحيح في VS Code رغم أنه يفتح.

أين يتكامل MyLinedChart

يأتي MyLinedChart بموصّل MCP يمنح وكيل الذكاء الاصطناعي رسمك البياني المباشر: الرموز ورسوماتك وقيم المؤشرات والشموع على الشاشة. يعمل الموصّل على جهازك ولا تمر البيانات عبر خوادمنا.

في التطبيق زر Add to VS Code بنقرة واحدة يكتب المفتاح الصحيح نيابة عنك، وهذا سبب استخدامه بدل التحرير اليدوي. للإعداد والعملاء الآخرين: /resources/articles/ibkr-chart-data-github-copilot-vs-code.

الخطوة التالية

صحّح المفتاح وأعد تشغيل VS Code فيظهر الخادم. وإذا لم يظهر الخادم بعد، فأنت الآن تعرف أن المشكلة في الخادم وليست في الإعداد، وهذه قائمة أقصر بكثير للعمل عليها.

اربط ذكاءك الاصطناعي من /mcp.

الأسئلة الشائعة

لماذا يستخدم VS Code المفتاح servers بدل mcpServers؟

المفتاح servers خيار تسمية في صيغة إعداد MCP الخاصة بـ VS Code، اتُّخذ باستقلال عن العرف الذي أرساه Claude Desktop. لا أحدهما أصح من الآخر. يصبح الفرق مشكلة فقط لأن الاثنين يبدوان قابلين للتبادل وأحدهما يفشل دون أن يقول ذلك.

هل يحذّرني VS Code إذا استخدمت المفتاح الخاطئ؟

لا، وهذه هي الصعوبة كلها. الملف JSON صالح، ومفتاح المستوى الأعلى غير المعروف يُتجاهل بدل أن يُرفض، وصفر خوادم مضبوطة حالة عادية. لا شيء في الأمر يبدو كخلل.

هل أستطيع استخدام ملف إعداد واحد لـ VS Code وCursor معًا؟

لا. يقرآن مسارين مختلفين ويتوقعان مفتاحي غلاف مختلفين، فتحتاج إلى الملفين. تعريف الخادم الداخلي متطابق، فهو نسخة مع تغيير كلمة واحدة.

هل ينطبق هذا على Copilot في Windows أيضًا؟

لا. المقصود هنا GitHub Copilot داخل VS Code الذي يدعم خوادم MCP. أما مساعد شريط مهام Windows فمنتج منفصل يشترك في الاسم ولا يستخدم ملفات الإعداد هذه.