موصلات Claude مفقودة من الإعدادات، أو عالقة عند Connect، أو تُظهر أخطاء أثناء المحادثة؟ يرتّب هذا المقال الأسباب حسب العَرَض: حدود الخطة، وموافقة المسؤول، وحلقات تسجيل الدخول، والخوادم غير القابلة للوصول، وملفات الإعداد الخاطئة، وأخطاء الأدوات، مع إصلاح عملي لكل منها.
من القليل في Claude ما يزعج مثل موصل كان يعمل بالأمس ثم اختفى اليوم. قائمة الموصلات فارغة، أو زر Connect يدور إلى ما لا نهاية، أو أداة بدت سليمة تُرجع خطأً في منتصف المحادثة. الخبر الجيد أن معظم الحالات تعود إلى عدد محدود من الأسباب، ويمكنك استبعادها في نحو عشر دقائق إذا سرت وفق الترتيب الصحيح.
يتّبع هذا المقال ذلك الترتيب. يبدأ بالفحوص البسيطة (الخطة، وإعدادات المسؤول، والحساب) لأنها تفسّر معظم تقارير "الموصل لا يظهر"، ثم ينتقل إلى إخفاقات تسجيل الدخول، وإمكانية وصول الخادم، وأخطاء الإعداد المحلي، والأخطاء التي تظهر فقط بعد أن يبدو الموصل متصلًا. القوائم والتسميات تتغيّر كثيرًا، لذا إذا لم تجد زرًا حيث تتوقعه، فابحث عن منطقة Connectors أو Customize في الإعدادات.
💡 قاعدة عامة: إذا لم يكن الموصل ظاهرًا، فاشتبه في خطتك أو في إعداد من المسؤول. إذا كان ظاهرًا لكنه لا يتصل، فاشتبه في تسجيل الدخول أو في إمكانية الوصول. إذا اتصل لكنه يفشل في المحادثة، فاشتبه في استدعاء الأداة نفسه.
ابدأ بتحديد العَرَض الذي تواجهه، لأن كل عَرَض يشير إلى إصلاح مختلف:
الموصلات، والموصلات المخصصة التي تشير إلى خادم MCP بعيد على وجه الخصوص، مرتبطة بالخطط المدفوعة. في خطة لا تشملها، لا يظهر خيار Connectors ببساطة، ولن يعيده أي تحديث للصفحة. افتح إعدادات حسابك، وتأكد من الخطة النشطة، ثم قارنها بمقال المساعدة الرسمي حول الموصلات. إذا ترقّيت مؤخرًا أو بدّلت مساحة العمل، فسجّل الخروج ثم الدخول مرة أخرى حتى تُطبَّق الخطة الجديدة.
في خطط Team وEnterprise، يجب على المالك أو المالك الرئيسي تفعيل الموصل للمؤسسة قبل أن يتمكن أي شخص من استخدامه. في منطقة الإدارة، يتم ذلك بفتح قائمة الموصلات عبر Browse connectors ثم اختيار Add to your team. تفعيل الموصل يجعله متاحًا فقط. ما زال على كل شخص أن يسجّل الدخول إليه بشكل فردي، لذا رؤية زميل لك لعبارة "connected" لا تخبرك بشيء عن حسابك أنت.
ثلاثة أسئلة تستحق أن تطرحها على المسؤول:
تستغرق هذه الفحوص دقيقتين، وتحل نسبة مفاجئة من الحالات. نفّذها قبل أن تعبث بأي إعدادات للخادم.
الجلسات القديمة تسبب مشكلات غامضة يصعب تفسيرها. نفّذ هذه الخطوات بالترتيب، واختبر بعد كل خطوة:
قد يكون الموصل متصلًا ومع ذلك مُعطّلًا للمحادثة التي أنت فيها. افتح قائمة الأدوات قرب مربع الرسالة، وتأكد من تفعيل الموصل. ثم تحقّق من صلاحيات الأدوات: يمكن ضبط كل أداة على "السؤال أولًا" أو "السماح دائمًا" أو "الحظر". الأداة المحظورة تبدو تمامًا كالأداة المفقودة.
| العَرَض | السبب الأرجح | أسرع إصلاح |
|---|---|---|
| لا يوجد خيار Connectors في الإعدادات | خطتك لا تشمله | تحقّق من الخطة، أو رقّها، أو اسأل المسؤول |
| الموصل موجود عند الآخرين، وليس عندك | لم تسجّل الدخول أبدًا، أو لم يضفه المالك | اطلب من المالك إضافته، ثم سجّل الدخول بنفسك |
| زر Connect لا يفعل شيئًا | نافذة منبثقة محجوبة أو جلسة قديمة | اسمح بالنوافذ المنبثقة، وأعد التحميل بقوة، ثم أعد المحاولة |
| متصل، لكن Claude يتجاهله | مُعطّل في هذه المحادثة | فعّله من قائمة الأدوات |
| كان يعمل بالأمس، ويفشل اليوم | توكن منتهي الصلاحية أو مُلغى | افصل الموصل، ثم اتصل به من جديد |
عندما يكون الموصل ظاهرًا لكن تسجيل الدخول يفشل، تقع المشكلة بين متصفحك وصفحة تسجيل الدخول الخاصة بالخدمة الأخرى وبين Claude.
يفتح الاتصال صفحة تسجيل دخول من الخدمة الأخرى: تقويمك، أو نظام إدارة علاقات العملاء، أو خادمك الخاص. إذا لم تظهر تلك النافذة، أو أُغلقت فورًا، أو عادت إلى البداية:
💡 أعد الاتصال بشكل نظيف. أزل الموصل، وأغلق علامة التبويب، وسجّل الدخول من جديد، ثم أضفه من البداية. قد تترك محاولة سابقة غير مكتملة حالة معطوبة لا تصلحها المحاولات المتكررة.
تظهر رسالة "Authorization with the MCP server failed" عادة بعد أن يكون تسجيل الدخول قد بدأ. وتسرد وثائق Anthropic لاستكشاف أخطاء الموصلات الأسباب التالية من جهة الخادم:
إذا كنت تستخدم موصلًا لشخص آخر فقط، فأرسل له هذه القائمة. وإذا كنت تشغّل الخادم، فالقسم التالي لك.
تبدو هذه الرسالة كأنها انقطاع في الشبكة، لكن السبب غالبًا أهدأ من ذلك. الحقيقة المهمة: تعمل الموصلات البعيدة على claude.ai على بنية Anthropic التحتية، لا على جهاز الكمبيوتر الخاص بك. يحل Claude اسم المضيف الخاص بخادمك من الإنترنت العام، وإذا لم تكن النتيجة قابلة للتوجيه عالميًا، فإنه يرفض الاتصال قبل إرسال أي طلب. سجلات الوصول لديك لن تُظهر أي شيء على الإطلاق.
يرفض Claude أسماء المضيفين التي تُحل إلى نطاقات خاصة (10.0.0.0/8، و172.16.0.0/12، و192.168.0.0/16)، أو عناوين CGNAT من فئة مزودي الخدمة (100.64.0.0/10)، أو عناوين loopback أو link-local، أو خليطًا من نتائج عامة وخاصة. كما أن الموصلات تعمل عبر IPv4 فقط، لذا يفشل المضيف الذي يحتوي على سجلات AAAA فقط.
وهذا يفسّر الشكوى الكلاسيكية: "It works in Claude Code and curl, but not on claude.ai." تتصل هذه الأدوات من جهازك، بينما يتصل claude.ai من السحابة. إذا كان اسم المضيف لديك يُحل بطريقة داخل شبكتك وبطريقة أخرى من خارجها (DNS بتقسيم الأفق)، أو كان يختبئ خلف VPN أو مزود DNS ديناميكي أو جهاز توجيه منزلي يستخدم CGNAT، فإن تطبيق الويب لا يحصل أبدًا على عنوان قابل للاستخدام.
تحقّق من ذلك من شبكة خارج شبكتك:
dig +short your-server.example.com
يجب أن يكون كل عنوان يُعاد عامًا. بالنسبة لخادم يعمل على حاسوبك المحمول، اعرضه عبر نفق عام أو وكيل عكسي بدلًا من استخدام رابط localhost.
مع صحة DNS، قد تظل شبكة توصيل المحتوى (CDN) أو WAF أو أداة تحديد المعدل ترفض الطلب قبل أن يراه تطبيقك. ابحث عن استجابات 403 أو 429 في سجلات الحافة أثناء محاولة Connect، ثم أضف إلى قائمة السماح نطاق الصادر المنشور في صفحة عناوين IP الخاصة بشركة Anthropic، أو استثنِ مسارات MCP وتسجيل الدخول من قاعدة الحظر.
ثم تحقّق من عمليات إعادة التوجيه:
curl -sI https://your-server.example.com/mcp
إذا كانت الاستجابة 301 أو 302 أو 307 أو 308 وتشير إلى مضيف مختلف، فسجّل ذلك الهدف بدلًا منه. يفشل العملاء المحليون عند إعادة التوجيه فورًا، بينما يتبعها claude.ai ويُسقط بيانات الاعتماد ثم يبلغ عن خطأ تفويض لاحقًا.
عندما يحتاج الخادم إلى تسجيل دخول، يبحث Claude أولًا عن بيانات OAuth الوصفية الخاصة به. اطلب كل مستند من شبكة عامة، وتوقّع استجابة 200 مع JSON صالح:
curl -i https://your-server.example.com/.well-known/oauth-protected-resource
curl -i https://your-server.example.com/.well-known/oauth-authorization-server
curl -i https://your-server.example.com/.well-known/openid-configuration
يكفي أن يستجيب واحد من الاثنين الأخيرين. يجب أن تتيح البيانات الوصفية أيضًا طريقة لتسجيل Claude كعميل (التسجيل الديناميكي للعميل، أو مستندات البيانات الوصفية لمعرّف العميل، أو بيانات اعتماد مسجّلة مسبقًا)، وأن تعلن دعم S256 PKCE. وأي وكيل يُسقط الترويسة WWW-Authenticate، أو يعيد 403 على مسارات /.well-known/، يُنتج رسالة "couldn't reach" نفسها مع أن الخادم خلفه سليم تمامًا.
تستحق Microsoft Entra ملاحظة خاصة. إذا فشل طلب التوكن مع AADSTS9010010، فهذا يعني أن Entra ترفض قيمة المورد التي يرسلها Claude. سجّل عنوان URL الكامل لخادم MCP بوصفه Application ID URI في تسجيل تطبيق API، مع استخدام نطاق مخصص موثّق إذا كنت على نطاق منصة مستضافة.
💡 احفظ معرّف المرجع. عندما يفشل الاتصال على claude.ai، تحتوي عنوان URL لصفحة الخطأ على قيمة تبدأ بـ
ofid_. انسخها فورًا لأنها تنتهي صلاحيتها، وأدرجها عند فتح بلاغ في متتبّع anthropics/claude-ai-mcp.
الخوادم التي تعمل على جهازك الخاص تسلك مسارًا مختلفًا. يشغّل تطبيق سطح المكتب هذه الخوادم من ملف إعداد، لذا لا تنتقل أي بيانات عبر الإنترنت، ولا تنطبق نصائح DNS السابقة.
أكثر أعطال الخوادم المحلية شيوعًا صغيرة:
npx أو node في الطرفية لكن لا يعمل من التطبيق. استخدم المسار المطلق للملف التنفيذي.شغّل الملف عبر أداة للتحقق من JSON قبل إعادة التشغيل.
يكتب تطبيق سطح المكتب سجلات MCP في %APPDATA%\Claude\logs على Windows، و~/Library/Logs/Claude على macOS، مع سجل عام لبروتوكول MCP وملف واحد لكل خادم. الخادم الذي يتعطل عند البدء يطبع السبب هناك عادة: حزمة مفقودة، أو إصدار Node خاطئ، أو متغيّر بيئة غائب. وفي Claude Code، يعرض claude mcp list حالة كل خادم مُعدّ، بينما يعرض /mcp داخل الجلسة التفاصيل ويتيح تسجيل الدخول.
رسالة "Unexpected error while invoking tool"، متبوعة باسم أداة، تعني أن الاتصال نفسه سليم. وصل طلب Claude إلى الخادم، فأجاب الخادم بخطأ. لا يوجد هنا معرّف مرجع ofid_، لأن شيئًا لم يفشل عند وقت الاتصال.
ضيّق نطاق المشكلة بهذا الترتيب:
حدود المعدل سبب شائع آخر، وتبدو عشوائية. تحدّ كثير من الخدمات من حجم العمل الذي يُنفَّذ في وقت واحد. اتصال MCP الخاص بمنصة PicassoIA مثال جيد على ذلك: نماذج الصور، وتعديل الصور، والفيديو تتشارك حدًا قدره 5 تنبؤات تعمل في الوقت نفسه لكل حساب، عبر كل بيانات الاعتماد واتصالات MCP. وفي وقت كتابة هذا المقال، تضيف هذا الاتصال من صفحة MCP في حسابك، وهذا يتطلب تسجيل الدخول. إذا أطلق Claude عشرة توليدات في طلب واحد، فسيفشل بعضها. اطلب منه العمل على دفعات أصغر.
إليك فك رموز سريع للرسائل التي ستواجهها أكثر من غيرها:
| الرسالة | ما معناها | أين تبحث |
|---|---|---|
| تعذّر الوصول إلى خادم MCP | فشلت المصافحة | DNS، جدار الحماية، عمليات إعادة التوجيه، بيانات OAuth الوصفية |
| فشلت عملية التفويض مع خادم MCP | بدأ تسجيل الدخول لكنه لم يكتمل | جهة الإصدار، الجهة المستهدفة، PKCE، سرعة التوكن، عمليات إعادة التوجيه |
| خطأ غير متوقع أثناء استدعاء الأداة | تم الاتصال، لكن فشل استدعاء الأداة | سجلات الخادم، MCP Inspector، حدود معدل الطلبات |
| لا يظهر خيار Connectors إطلاقًا | إعداد الخطة أو المؤسسة | صفحة الخطة، إعدادات المسؤول |
لا ينبغي أن يوقف الموصل المعطّل يومك. وأثناء إصلاحه، الصق نص الخطأ، أو مقتطف السجل، أو لقطة شاشة في نموذج لا يعتمد على أي موصل. Claude Sonnet 5 متاح على PicassoIA، ويتعامل مع الأكواد والمهام الكثيفة في الأدوات، ويقبل إدخال الصور، وهذا مناسب للقطات شاشة صفحات الأخطاء.
💡 أزل الأسرار أولًا. احذف التوكنات، والأسرار الخاصة بالعملاء، وكلمات المرور من أي ملف إعداد أو سجل قبل أن تلصقه في أي مكان.
قبل أن تغلق صفحة الإعدادات، نفّذ قائمة المراجعة النهائية هذه:
ofid_ محفوظ إذا احتجت إلى الدعم
عندما تعمل الموصلات بشكل طبيعي مرة أخرى، امنحها مهمة إبداعية. يحوّل Picasso IA أمرًا نصيًا قصيرًا إلى صورة واقعية كالصور الفوتوغرافية في ثوانٍ باستخدام PicassoIA Image، ويتيح لك تحسين النتيجة باستخدام PicassoIA Image Editor Pro، ويحرّك صورة ثابتة بتحويلها إلى فيديو باستخدام PicassoIA Video. افتح المنصة، واكتب أمرًا نصيًا واحدًا عن مشهد في ذهنك، وغيّر الإضاءة أو زاوية الكاميرا، ثم شغّله من جديد. عشر دقائق من التجريب ستُظهر لك ما يتقنه كل نموذج، ويمكنك تصفح كل الخيارات في صفحة جميع النماذج.
اختر لغتك
