طريقتان واضحتان لربط خادم MCP مع Claude Cowork: موصل مخصص عن بُعد للخدمات السحابية، وإعداد محلي للأدوات الموجودة على جهازك. القوائم، وخيارات OAuth، والأذونات، وعادات الأمان، وحلول الأخطاء التي تمنع الاتصال الأول.
تلصق عنوان خادم في Claude Cowork، وتنقر Add، فلا يحدث شيء مفيد. أو يظهر الموصل في القائمة، لكن Claude لا يستدعي أيًا من أدواته أبدًا. تعود معظم عمليات الإعداد الفاشلة إلى خطأ واحد: اختيار نوع خادم MCP الخاطئ بالنسبة لطريقة تشغيل Cowork. يوجد الخادم عن بُعد على الإنترنت العام، وتصل إليه خوادم Anthropic. أما الخادم المحلي فيوجد على حاسوبك، ويشغّله Claude Desktop. القوائم والقواعد ورسائل الخطأ تختلف في كل حالة.
يعرض هذا المقال المسارين معًا، باستخدام أسماء القوائم من وثائق الدعم الخاصة بـ Anthropic، مع ملف إعداد يمكنك لصقه، وقائمة تحقق للأمان، وجدول لاستكشاف الأخطاء وإصلاحها. يعرض القسم الأخير مثالًا عمليًا: ربط PicassoIA حتى يتمكن Claude من توليد الصور والفيديوهات كجزء من مهمة في Cowork.
MCP، وهو اختصار Model Context Protocol، هو المعيار المفتوح الذي يتيح لـ Claude استدعاء أدوات خارجية. ينشر الخادم قائمة بالأدوات، ولكل أداة اسم ومخطط، ويقرر Claude متى تحتاج المهمة إلى إحداها. قراءة صف من قاعدة بيانات، أو نشر رسالة في Slack، أو فتح تذكرة، أو تصيير صورة: كل واحد منها استدعاء لأداة.
Cowork هو الجزء من Claude Desktop المخصص للأعمال متعددة الخطوات على جهازك. وفقًا لنظرة Anthropic المعمارية، يُنفَّذ الكود الذي تطلب من Claude تشغيله داخل جهاز افتراضي معزول، باستخدام Apple Virtualization.framework على macOS وHyper-V على Windows. هذه التفصيلة مهمة لـ MCP، لأنها تحدد أين يمكن أن يعمل الخادم ومن يستطيع الوصول إليه.
تصف وثائق Anthropic ثلاث طرق منفصلة لإرفاق الخادم، والخلط بينها هو المصدر الأول للالتباس.
| المسار | ما هو | أين يعمل | الأنسب لـ |
|---|---|---|---|
| موصل مخصص | عنوان URL لخادم MCP عن بُعد | تصل إليه خوادم Anthropic عبر الإنترنت | الخدمات السحابية مثل Slack وNotion وLinear وGitHub |
| ملحق سطح المكتب | حزمة .mcpb تحتوي على manifest.json | على حاسوبك، عبر stdio | الملفات المحلية، وقاعدة بيانات localhost، وتطبيقات سطح المكتب |
| إدخال في ملف الإعداد | أمر في claude_desktop_config.json | على حاسوبك، ويشغّله Claude Desktop | الخوادم التي تُشغَّل عبر npx أو Python أو ملف ثنائي |
تعمل الموصلات المخصصة عن بُعد على Claude وCowork وClaude Desktop، في خطط Free وPro وMax وTeam وEnterprise. تحصل حسابات Free على موصل مخصص واحد، لذا اختر الموصل الذي تستخدمه أكثر.
استعن بشكل ما حصلت عليه:
https:// يعني موصلًا مخصصًا. لا تضعه في ملف الإعداد.npx some-server يعني إدخالًا في ملف الإعداد، أو ملحقًا إذا وفّره المطور..mcpb يعني ملحقًا لسطح المكتب. ثبّته من Settings.💡 قاعدة عامة: إذا كان الخادم يحتاج إلى الوصول إلى ملفات أو تطبيقات على حاسوبك، فيجب أن يعمل محليًا. وإذا كان يتصل بخدمة سحابية سجّلت الدخول إليها بالفعل، فالموصل عن بُعد هو غالبًا الطريق الأسهل.
فحصان يوفران معظم الوقت الضائع: من يُسمح له بإضافة الموصلات في خطتك، وهل تستطيع Anthropic فعلًا الوصول إلى خادمك.
إذا كنت عضوًا في خطة فريق ولم تستطع إضافة موصل، فهذا سلوك متوقع وليس خللًا. اطلب من أحد المالكين إضافته، ثم اتصل بحسابك الخاص.
هذه هي القاعدة التي يقع فيها المطورون أكثر من غيرها. بالنسبة إلى الموصل عن بُعد، يصدر الاتصال "من خوادم Anthropic، لا من واجهة الشبكة في جهازك". ولذلك ثلاث نتائج:
http://localhost:3000/mcp أبدًا كموصل مخصص، لأن خوادم Anthropic لا ترى localhost لديك.
إذا كان خادمك موجودًا على حاسوبك المحمول فقط، فانتقل إلى المسار المحلي. إنه مصمم لهذه الحالة تحديدًا.
يضيف المالكون الموصل مرة واحدة لالمؤسسة بأكملها:
اختر No sign in فقط عندما لا يتطلب الخادم تسجيل الدخول فعلًا. بالنسبة إلى OAuth، تُعد الهوية المنشورة الموصى بها الخيار الافتراضي المعقول، ما لم يطلب منك مزوّدك تسجيل عميل خاص بك.
يفتح كل عضو بعد ذلك Customize، ثم Connectors، ويعثر على الإدخال المعلَّم Custom، وينقر على Connect للمصادقة باستخدام حسابه الخاص.
إضافة موصل لا تعني أن كل محادثة تستخدمه. تصف مستندات Anthropic الزر + في أسفل يسار مربع الدردشة، ثم Connectors، ثم مفتاح تبديل لكل محادثة. يعتمد Cowork على قائمة الموصلات نفسها، لذا افتح تلك القائمة داخل مهمتك، وتأكد من أن المفتاح مفعّل قبل أن تكتب طلبك.
ثم اطلب شيئًا لا يمكن الإجابة عنه إلا من خلال الأداة، مثلًا: "Use the Linear connector to list my open issues assigned to me, grouped by project." إذا أجاب Claude من الذاكرة بدلًا من استدعاء الأداة، فالمفتاح مغلق أو أن تسجيل الدخول انتهت صلاحيته.
يستحق التحقق الثاني ثلاثين ثانية. اسأل Claude عن الأدوات التي يوفرها الموصل، واقرأ القائمة. لا ينبغي لخادم البحث فقط أن يعرض أداة حذف، ولا لخادم تدوين الملاحظات أن يعرض إجراءات الفوترة. إذا بدت القائمة أكبر من المهمة، فأزل الموصل وابحث عن موصل أضيق نطاقًا.
تعالج الخوادم المحلية الحالات التي لا يستطيع الموصل عن بُعد الوصول إليها أبدًا: الملفات داخل مجلد، وقاعدة بيانات على localhost، وتطبيق سطح مكتب. تعمل على جهازك وتتواصل مع Claude Desktop عبر stdio بدلًا من الإنترنت.
ملف .mcpb هو أرشيف zip يحتوي على خادم محلي وmanifest.json. يعمل مثل ملحق المتصفح: بضع نقرات ويكون مثبتًا.
.mcpb الخاص بك.يأتي Claude Desktop ببيئة Node.js خاصة به، لذا لا تحتاج الملحقات المبنية على Node إلى تثبيت منفصل. ومع ذلك هناك تحذير: تدرج مقارنة Anthropic بين موصلات سطح المكتب والويب الملحقات لكل من Claude Desktop وClaude Code، لذا أجرِ اختبارًا سريعًا داخل مهمة Cowork قبل أن تبني سير عمل عليه.
بالنسبة إلى خادم stdio يُشغَّل بأمر، يكون ملف الإعداد هو المكان الصحيح. ويعتمد موقعه على نظام التشغيل:
| نظام التشغيل | المسار |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
إليك إدخالًا بسيطًا باستخدام خادم نظام الملفات المرجعي:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"C:\\Users\\you\\Documents\\notes"
]
}
}
}
ثلاث تفاصيل تسبب معظم أعطال الخوادم المحلية:
\\ داخل JSON.npx، لأن npx يعمل من PATH في نظامك.تفيد مقالات المجتمع بأن Claude Desktop ينقل الخوادم من هذا الملف إلى الجهاز الافتراضي لـ Cowork، حيث تظهر بالنوع sdk. وتؤكد صفحة المعمارية لدى Anthropic الجانب الآخر من القصة: تعمل خوادم MCP المحلية على جهازك في الجلسات المحلية، ولا تعمل مطلقًا في الجلسات السحابية. ويستطيع المسؤولون إيقافها بالإعدادين isLocalDevMcpEnabled وisDesktopExtensionEnabled، لذا قد يحظر حاسوب العمل المقفل الاثنين معًا.
يتيح لك الموصل أن يتصرف Claude داخل خدمة أخرى، لا أن يقرأ منها فقط. قائمة التحذيرات الخاصة بـ Anthropic قصيرة وتستحق الالتزام بها: اتصل فقط بخوادم موثوقة، وراجع الأذونات التي يطلبها الموصل، وانتبه إلى حقن الأوامر النصية، وراقب التغييرات في سلوك الأدوات. قد تشير الموصلات المخصصة إلى خدمات لم تتحقق منها Anthropic، لذا فقرار الثقة يعود إليك.
| الخطر | عادة مفيدة |
|---|---|
| مؤلف خادم مجهول | اقرأ وثائق المزوّد أو شيفرته المصدرية قبل أن تلصق عنوان URL |
| أدوات تكتب أو تحذف | أبقِ الأدوات القادرة على الكتابة بعيدًا عن مهام البحث؛ توصي Anthropic بتعطيلها لميزة Research |
| تغييرات صامتة في الأدوات | أعد فحص قائمة الأدوات بعد كل تحديث للخادم |
| حقن أوامر نصية من محتوى مُسترجَع | تعامل مع النص الذي تعيده الأداة كبيانات غير موثوقة، لا كتعليمات صادرة عنك |
| موافقات أوسع من اللازم | يستطيع المسؤولون تعطيل "السماح الدائم" لإلزام الموافقة الجديدة على كل استدعاء يخضع لإذن |
حقن الأوامر النصية بعبارات بسيطة: صفحة ويب أو مستند أو تذكرة يقرؤها Claude قد تحتوي على جمل مكتوبة لتبدو كأوامر. الموصل الذي يملك صلاحية الكتابة يحوّل هذه الحيلة من مزعجة إلى مكلفة. اقصر أدوات الكتابة على المهام التي تقرأ فيها الخطة قبل أن يتصرف Claude.
هناك تفصيلة معمارية مطمئنة. تقول Anthropic إن رموز تفويض الموصل لا تدخل البيئة المعزولة أبدًا، وإن استدعاءات الموصل تُنفَّذ من جهة الخادم. ولا يستطيع الكود الذي يعمل داخل الجهاز الافتراضي لـ Cowork قراءة رموزك.
نفّذ هذه الفحوصات بالترتيب:
https:// تنتمي إلى موصل مخصص.| العرض | السبب المرجّح | الحل |
|---|---|---|
| انتهاء مهلة الاتصال | الخادم على localhost أو على شبكة خاصة | استضفه بشكل عام أو اسمح بنطاقات IP الخاصة بـ Anthropic |
| الموصل مضاف لكنه لا يُستدعى أبدًا | المفتاح مغلق لهذه المحادثة | استخدم +، ثم Connectors، وفعّله |
| يعود تسجيل الدخول إلى البداية | عدم تطابق عميل OAuth | اختر Use your own OAuth client وأدخل معرّف المزوّد وسره |
| الخادم المحلي غير موجود في مهمة | جلسة سحابية، أو عطّل المسؤول الخوادم المحلية | شغّل جلسة محلية؛ واسأل مسؤولك عن isLocalDevMcpEnabled |
الأمر npx غير موجود | Node.js غير موجود في PATH | ثبّت Node.js، ثم أعد تشغيل Claude Desktop |
💡 اختبار سريع: اطلب من Claude سرد الأدوات التي يوفرها الموصل. القائمة الفارغة تعني أن الخادم اتصل لكنه لم يعرض شيئًا، والخطأ يعني أن الاتصال نفسه فشل. هاتان النتيجتان تشيران إلى حلين مختلفين.
أفضل موصل أول هو الذي ينتج شيئًا يمكنك رؤيته. تتيح PicassoIA نماذجها عبر MCP، ويدرج مرجع API من PicassoIA نفسه Claude ضمن العملاء المدعومين. الحدود التي تستحق المعرفة: حدّ كل حساب هو 5 تنبؤات في قائمة الانتظار أو قيد التشغيل في وقت واحد، وهذه المجموعة مشتركة بين كل بيانات اعتماد API وكل اتصال MCP. تختلف قواعد الخطط بين أنواع الوصول، لذا راجع صفحة الأسعار لمعرفة ما تتضمنه خطتك قبل أن تضع دفعة كبيرة في قائمة الانتظار.
أدوات الموصل مباشرة: generate_image، وedit_image، وgenerate_video_picassoia، وgenerate_video_seedance، وget_generation، وlist_generations، وlist_models، وget_account، وcancel_generation. المهام غير متزامنة. يعيد استدعاء التوليد معرّف تنبؤ، ثم يستعلم Claude عن get_generation حتى تظهر الحالة succeeded أو failed.
get_account للتأكد من الربط.
اختر النموذج حسب المهمة، ثم أعطِ Claude موجزًا محددًا.
| المهمة | النموذج | مثال على الأمر النصي |
|---|---|---|
| من نص إلى صورة | PicassoIA Image | "ولّد ثلاث صور بنسبة 16:9 لكوب من السيراميك على مكتب من البلوط في ضوء الصباح." |
| تعديل صورة موجودة | PicassoIA Image Editor Pro | "عدّل صورة المنتج هذه لتصبح الخلفية جدارًا رماديًا عاديًا." |
| مقطع فيديو قصير | PicassoIA Video | "حرّك هذه الصورة بتقريب بطيء مع ضوء نافذة ناعم." |
| فيديو مع صوت | Seedance 2.5 Lite | "أنشئ مقطعًا مدته 10 ثوانٍ لمطر على نافذة مقهى مع أجواء هادئة." |
ثلاث عادات تبقي الدفعات سلسة:
تعامل مع النتيجة الأولى كمسودة. اطلب من Claude الإبقاء على الشخص نفسه وتغيير شيء واحد في كل مرة، مثل زاوية الكاميرا أو وقت اليوم أو الخلفية. تعطيك المتابعات القصيرة مثل "المشهد نفسه، بزاوية أدنى" نتائج قابلة للمقارنة، وتوضح أي تغيير كان مفيدًا.
الآن لديك المسارين: موصل عن بُعد للخدمات السحابية، وإدخال محلي للأدوات الموجودة على جهازك. أسرع طريقة لترى الفائدة هي ربط شيء مرئي ومشاهدة Cowork وهو يستخدمه. افتح PicassoIA، وولّد صورة تجريبية باستخدام PicassoIA Image، ثم اربط الموصل واطلب من Claude ثلاث نسخ بديلة داخل مهمة.
جرّب موضوعًا واحدًا، وإعداد إضاءة واحدًا، وبعض تغييرات الصياغة. التعديلات الصغيرة على الأمر النصي تنتج نتائج مختلفة بشكل مدهش، وأسرع طريقة لاكتشاف أسلوبك هي التوليد والمقارنة والتعديل. أول صورة متصلة لك لا تبعد عنك إلا بمهمة واحدة.
اختر لغتك
