كيف تستخدم MCP: إعداد للمبتدئين مع Claude وCursor وChatGPT

يمكن لمساعدك الذكي أن يصيغ رسالة بريد إلكتروني في ثوانٍ، لكنه يعجز عن ذلك عندما تطلب منه قراءة جدول البيانات الموجود على سطح مكتبك. يزيل MCP هذه العقبة. بروتوكول سياق النموذج (Model Context Protocol) معيار مفتوح يتيح لتطبيق الذكاء الاصطناعي الوصول إلى ملفاتك وقواعد بياناتك وتقويمك وأدواتك الأخرى عبر صيغة اتصال مشتركة واحدة. تُعدّ الأداة مرة واحدة، ويمكن لكل تطبيق متوافق استخدامها.

يُظهر لك هذا المقال كيفية استخدام MCP من الصفر. ستتعرف على المكونات الثلاثة الأساسية، وتبني أول إعداد يعمل في Claude وCursor وChatGPT، وتتعلم عادات الأمان التي تستحق أن تكتسبها من اليوم الأول، وتصلح الأخطاء التي يواجهها كل مبتدئ تقريبًا. خصّص نحو ساعة للتطبيقات الثلاثة، أو عشر دقائق لتطبيق واحد فقط.

ماذا يفعل MCP

MCP اختصار لعبارة Model Context Protocol. قدّمته Anthropic في نوفمبر 2024، ويُدار المشروع اليوم ضمن Agentic AI Foundation، وهو صندوق موجَّه تابع لمؤسسة Linux، شاركت Anthropic وBlock وOpenAI في تأسيسه. تصف الوثائق الرسمية البروتوكول بأنه منفذ USB-C لتطبيقات الذكاء الاصطناعي: شكل موحّد للقابس يعمل مع أجهزة كثيرة.

قبل MCP، كان كل ربط عملًا مخصصًا. موصّل مبني لتطبيق واحد لا يفيد تطبيقًا آخر. أما اليوم، فالخادم المكتوب مرة واحدة يعمل في أي عميل يفهم البروتوكول، وتفعل Claude وChatGPT وCursor وVisual Studio Code ذلك.

الأجزاء الثلاثة

تتكون كل إعدادات MCP من المكونات نفسها:

• المضيف (Host): تطبيق الذكاء الاصطناعي الذي تتحدث معه، مثل Claude Desktop أو Claude Code أو Cursor.
• العميل (Client): موصّل يُنشئه المضيف لكل خادم. يعيش داخل المضيف، لذلك لا تضبطه أنت بنفسك أبدًا.
• الخادم (Server): برنامج يقدّم السياق والإجراءات، مثل خادم نظام الملفات أو خادم GitHub أو مولّد الصور.

عندما تعدّل ملف الإعداد أدناه، فأنت تخبر المضيف بالخوادم التي يجب تشغيلها أو استدعاؤها.

💡 اختصار للمبتدئين: تسمّي معظم الشروحات التطبيق نفسه (Claude أو Cursor أو ChatGPT) "العميل". يصبح هذا الفرق مهمًا فقط عندما تبني خادمك الخاص.

الأدوات والموارد والأوامر النصية

يمكن للخادم أن يقدّم ثلاثة أنواع من الأشياء:

الأدوات هي ما ستستخدمه أولًا. عندما تطلب من Claude إعادة تسمية مجلد من الملفات، يختار أداة من قائمة الخادم وينتظر موافقتك قبل أن تُنفَّذ.

الخوادم المحلية والبعيدة

تأتي الخوادم بنوعين، والفرق بينهما يحدد التطبيقات القادرة على استخدامها:

يستطيع Claude Desktop وClaude Code تشغيل الخوادم المحلية. يتعامل Cursor مع النوعين. أما ChatGPT فيتصل بالخوادم البعيدة فقط. تذكّر هذا الجدول، لأنه يفسّر معظم الالتباس في الأقسام التالية.

💡 البروتوكول في تطور مستمر (أحدث مراجعة مؤرخة في 2026-07-28)، لكن الإعداد للمبتدئين لا يحتاج إلى تفاصيل المواصفات. حافظ على تحديث تطبيقاتك وتابع.

جهّز جهازك

تحقّق من Node.js

تبدأ معظم الخوادم المجتمعية بـ npx، وهي أداة تأتي مع Node.js. افتح الطرفية وشغّل:

node --version

نسخ الأمر النصي

إذا ظهر رقم إصدار، فأنت جاهز. إذا لم يُعثر على الأمر، فثبّت الإصدار LTS من nodejs.org، ثم أعد فتح الطرفية. تعني LTS الدعم طويل الأمد (Long Term Support)، وهي الخيار المستقر.

اختر أول خادم آمن

ابدأ بخادم نظام الملفات الرسمي، المنشور باسم @modelcontextprotocol/server-filesystem. يتيح للمساعد قراءة الملفات وإنشاؤها ونقلها والبحث فيها داخل المجلدات التي تسمّيها.

أنشئ مجلدًا مؤقتًا باسم mcp-sandbox وضع فيه ملفين أو ثلاثة نصية. استخدم هذا المجلد في كل اختبار في هذا المقال.

⚠️ يعمل الخادم المحلي بصلاحيات حساب المستخدم لديك. لا تدرج إلا المجلدات التي ترتاح لأن يقرأها المساعد ويغيّرها. مجلد المنزل كاملًا خيار أول سيئ.

اضبط MCP في Claude

تقدّم تطبيقات Anthropic طريقتين. يستخدم Claude Desktop ملف إعداد بصيغة JSON. أما Claude Code، وهو تطبيق الطرفية، فيستخدم أمرًا. اختر الطريقة التي تستخدمها يوميًا، أو استخدم الاثنتين.

عدّل إعداد سطح المكتب

1. افتح قائمة Claude في شريط القوائم بنظامك (لا الإعدادات داخل نافذة الدردشة)، واختر Settings.
2. افتح تبويب Developer وانقر Edit Config.
3. ينشئ Claude الملف إذا لم يكن موجودًا. يقع في هذا المسار:

استبدل المحتوى بالمقتطف المناسب لنظامك، مع تغيير اسم المستخدم إلى اسمك. على macOS:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/mcp-sandbox"]
    }
  }
}

نسخ الأمر النصي

على Windows، استخدم الشرطتين المائلتين للخلف:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "C:\\Users\\username\\mcp-sandbox"]
    }
  }
}

نسخ الأمر النصي

لكل جزء وظيفة:

• "filesystem" هو الاسم الودود الذي يظهر في التطبيق.
• "command": "npx" يشغّل الخادم عبر Node.js.
• -y يؤكد تنزيل الحزمة حتى لا يتوقف التشغيل عند موجّه.
• الوسيط الأخير هو المجلد الوحيد الذي يُسمح للخادم بالوصول إليه. استخدم مسارًا مطلقًا، لا مسارًا نسبيًا أبدًا.

أعد التشغيل واختبر

احفظ الملف، ثم أغلق Claude Desktop بالكامل وأعد فتحه. إغلاق النافذة لا يكفي، لأن التطبيق يقرأ الإعداد عند التشغيل.

انقر زر Add files, connectors, and more في الزاوية السفلية اليسرى من مربع الرسالة، ومرّر المؤشر فوق Connectors واختر Manage connectors. حدّد filesystem لتشاهد أدواته. ثم جرّب طلبًا بسيطًا:

اعرض الملفات الموجودة في مجلد mcp-sandbox الخاص بي، وأخبرني أيّها تغيّر مؤخرًا.

يطلب Claude موافقتك قبل كل عملية على الملفات. اقرأ الطلب، ثم وافق عليه أو ارفضه.

💡 الخوادم البعيدة لا تحتاج إلى JSON. في claude.ai، انتقل إلى Settings، ثم Connectors، وانقر Add custom connector، وأعطه اسمًا والصق عنوان URL للخادم. عادةً ستسجّل الدخول عبر OAuth. الحسابات المجانية محدودة بموصّل مخصص واحد.

أضف الخوادم في Claude Code

يضيف Claude Code الخوادم من الطرفية. تعتمد صيغة الأمر على نوع الخادم:

# Remote server over HTTP
claude mcp add --transport http example https://example.com/mcp

# Local server over stdio (note the double dash)
claude mcp add --transport stdio files -- npx -y @modelcontextprotocol/server-filesystem /Users/username/mcp-sandbox

# See what is configured
claude mcp list
claude mcp get files
claude mcp remove files

نسخ الأمر النصي

يفصل -- بين خيارات Claude الخاصة والأمر الذي يشغّل الخادم. إن نسيته، فستُفهم الوسائط بشكل خاطئ. داخل جلسة Claude Code، اكتب /mcp للتحقق من حالة كل خادم أو لإكمال تسجيل الدخول عبر OAuth.

يعتمد مكان حفظ الخادم على نطاقه:

أضف --scope project لكتابة ملف .mcp.json يمكنك إيداعه في المستودع، فيحصل زملاؤك على الخوادم نفسها. واستخدم --scope user للأدوات التي تريدها في كل مكان.

اضبط MCP في Cursor

اختر المشروع أو العام

يقرأ Cursor ملف JSON على أحد مستويين:

• المشروع: .cursor/mcp.json في جذر المشروع، للأدوات المرتبطة بقاعدة كود واحدة.
• العام: ~/.cursor/mcp.json في مجلد المنزل لديك، للأدوات التي تريدها في كل مشروع.

الصيغة مطابقة لصيغة Claude Desktop:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/mcp-sandbox"]
    }
  }
}

نسخ الأمر النصي

يدعم Cursor ثلاث طرق نقل، لذا يمكنك خلط الخوادم المحلية والبعيدة في الملف نفسه:

يطلب Cursor موافقتك افتراضيًا قبل تشغيل أي أداة MCP. تستطيع أوضاع التشغيل أن توافق تلقائيًا على الأدوات التي أدرجتها في القائمة المسموح بها، لذا ابدأ بصرامة ثم خفّف لاحقًا.

أضف خادمًا بعيدًا

بالنسبة إلى خادم مستضاف، استبدل command وargs بعنوان URL:

{
  "mcpServers": {
    "example": {
      "url": "https://example.com/mcp"
    }
  }
}

نسخ الأمر النصي

يقدّم Cursor Marketplace وcursor.directory أيضًا زر Add to Cursor يثبّت الخادم ويتولى تسجيل الدخول عبر OAuth في خطوة واحدة. إذا احتاج الخادم إلى رمز مميز، فاستخدم استيفاء ${env:NAME} بدلًا من لصق السر في الملف. ويقبل Cursor أيضًا ${userHome} و${workspaceFolder} في قيم الإعداد.

اضبط MCP في ChatGPT

ما الذي يتطلبه ChatGPT

يعمل ChatGPT بشكل مختلف عن التطبيقين الآخرين. يتصل بـخوادم بعيدة يمكن الوصول إليها عبر HTTPS. لن يظهر الخادم الذي تشغّله عبر npx على حاسوبك، لأن ChatGPT لا يستطيع تشغيل عملية على جهازك.

الخطوات كما تصفها OpenAI:

1. استخدم خطة مدفوعة. الحسابات المجانية مستثناة.
2. فعّل وضع المطوّر (developer mode) من إعدادات ChatGPT.
3. افتح إعدادات Plugins واضغط زر الإضافة واختر Add custom MCP server.
4. أدخل عنوان URL للخادم واختر طريقة المصادقة، وغالبًا OAuth.
5. اقبل تحذير المخاطر، ثم فعّل الموصّل في محادثة جديدة.

تنص OpenAI على أن خوادم MCP المخصصة خدمات تابعة لجهات خارجية، ولم تطوّرها OpenAI ولم تتحقق منها. تغيّرت أسماء القوائم عدة مرات، لذا إذا اختلفت التسمية فابحث عن "developer mode" في وثائق المطورين لدى OpenAI. بعض الخطط تقيّد أيضًا عمليات الكتابة، فقد يقرأ الموصّل البيانات لكنه يرفض تغييرها. تحقّق من خطتك قبل أن تبحث عن خلل هو في الواقع قيد من قيود الخطة.

يستطيع المطورون الذين يبنون باستخدام الواجهة البرمجية (API) إرفاق الخادم نفسه عبر Responses API بإدخال أداة من نوع type: "mcp"، إضافة إلى server_label وserver_url وقائمة allowed_tools وإعداد require_approval.

💡 خادم واحد، ثلاثة تطبيقات. استضف خادمًا بعيدًا واحدًا، والصق عنوانه في موصّلات Claude المخصصة، وفي mcp.json لدى Cursor، وفي ChatGPT. هذه هي فائدة البروتوكول المشترك.

ابقَ آمنًا مع الأدوات

المساعد الذي يملك أدوات يستطيع أن يتصرف، والتصرف له عواقب. عادتان تزيلان معظم المخاطر.

امنح أقل قدر من الصلاحيات

• شارك مجلدًا واحدًا، لا مجلد المنزل كاملًا.
• ابدأ بأدوات القراءة فقط، وأضف صلاحية الكتابة عندما تحتاج إليها.
• اقرأ كل طلب موافقة قبل أن تنقر. يوضح ما على وشك الحدوث.
• تعامل مع أي خادم لم تكتبه أو تتحقق منه على أنه كود طرف ثالث. تحذّر كل من Anthropic وOpenAI من أن الموصّلات المخصصة لا تتحقق منها.
• تذكّر أن النص الموجود داخل الملفات وصفحات الويب قد يحتوي على تعليمات موجهة إلى المساعد. إذا أعادت أداة شيئًا غريبًا، فتوقف واقرأه بنفسك.

أبقِ الرموز المميزة خارج الملفات

لا تلصق سرًا أبدًا في ملف إعداد قد تضيفه إلى المستودع أو تشاركه. مرّره عبر متغير بيئي بدلًا من ذلك. في Cursor، استخدم ${env:NAME}. وفي Claude Code، أضف --env NAME=value عند تسجيل خادم محلي. وقبل أن تُودِع .mcp.json أو .cursor/mcp.json في المستودع، افتح الملف وتأكد من عدم وجود أي رمز مميز فيه.

أصلح الأخطاء الشائعة

ابدأ بالسجلات. يكتب Claude Desktop سجلات MCP في ~/Library/Logs/Claude على macOS، وفي %APPDATA%\Claude\logs على Windows. يسجّل الملف mcp.log محاولات الاتصال وإخفاقاتها، ويحصل كل خادم على mcp-server-NAME.log خاص به يحتوي على ما طبعه في stderr.

على Windows، إذا ذكر سجل ${APPDATA} داخل مسار، فأضف القيمة الموسّعة إلى كتلة env الخاصة بالخادم، مثل "APPDATA": "C:\\Users\\username\\AppData\\Roaming\\"، ثم أعد تشغيل التطبيق.

عندما لا تنجح أي طريقة أخرى، شغّل أمر الخادم يدويًا. إذا فشل في الطرفية، فسيفشل داخل التطبيق أيضًا، والطرفية تعرض لك الخطأ كاملًا.

جرّبه على PicassoIA

بعد نجاح اختبار نظام الملفات، أضف خادمًا ينتج شيئًا تستطيع رؤيته. توليد الصور خطوة ثانية جيدة، لأنك تستطيع الحكم على النتيجة بنظرة واحدة.

يقدّم PicassoIA موصّل MCP يمنح مساعدك أربعة نماذج: PicassoIA Image لتحويل النص إلى صورة، وPicassoIA Image Editor Pro للتعديلات، وPicassoIA Video لتوليد فيديو من نص أو صورة، وSeedance 2.5 Lite لفيديو مع صوت. تدير اتصالاتك من حساب PicassoIA بعد تسجيل الدخول.

توليد المحتوى غير متزامن. يبدأ المساعد مهمة، ويتلقى معرّف تنبؤ مع وقت تقديري، ثم يتحقق من الحالة بعد مدة الانتظار المقترحة حتى تُبلغ المهمة عن النجاح أو الفشل. الفشل نهائي، لذا يبدأ المساعد ببساطة توليدًا جديدًا. يستطيع كل حساب تشغيل خمسة تنبؤات كحد أقصى في وقت واحد، مشتركة بين جميع اتصالاته.

استخدم أمرًا نصيًا أوليًا كهذا لاختبار الربط:

ولّد صورة واقعية كالصور الفوتوغرافية لمكتب خشبي عليه حاسوب محمول وكوب قهوة، في ضوء صباحي ناعم، ثم اعرض لي الرابط.

هل تودّ معرفة كيف تتعامل النماذج المختلفة مع سؤال الإعداد نفسه؟ الصق إعدادًا به خطأ في Claude Sonnet 5 وGPT 5.6 Sol وانظر أيهما يشرح خطأ JSON بوضوح أكبر.

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