Claude Custom Connectors: خطة Free، وOAuth، ورمز الحامل، ومفتاح API

يمكنك إضافة موصل مخصص إلى Claude دون دفع أي اشتراك. تسمح Anthropic بموصل واحد في الخطة المجانية، والحوار الذي ينشئه لا يطلب أكثر من اسم وعنوان URL للخادم. أما الجزء الذي يوقع الناس في الارتباك فيأتي بعد ذلك مباشرة: كيف يثبت Claude هويته لخادمك؟ والجواب يعتمد على ما إذا كان الخادم يدعم OAuth، أم يتوقع رمز حامل في ترويسة Authorization، أم يريد سر API ثابتًا في ترويسة مخصصة. فيما يلي ستجد أسماء القوائم بدقة، وتسميات الحقول، وجدول قرار لكل طريقة تسجيل دخول، وأنماط الفشل التي يصادفها الناس عمليًا. وكل تفصيل خاص بالمنتج يتبع وثائق موصلات Claude الرسمية كما كانت في أكتوبر 2026.

💡 الإجابة المختصرة: يمكن لمستخدمي الخطة المجانية إضافة موصل مخصص واحد. اختر OAuth عندما يسجّل كل شخص دخوله باسمه. اختر No sign-in مع Request headers عندما يتطلب الخادم رمز حامل أو سر API ثابتًا، وتذكّر أن Request headers ما تزال ميزة تجريبية (beta).

ما هو الموصل المخصص

MCP البعيد بلغة بسيطة

الموصل جسر بين Claude وخدمة أخرى. يتحدث Claude بروتوكول Model Context Protocol (MCP)، وهو معيار مفتوح يتيح للخادم نشر أدوات، وهي إجراءات يستطيع Claude استدعاءها، وموارد، وهي بيانات يستطيع Claude قراءتها. وعندما يعمل الخادم على الإنترنت ويجيب عبر HTTPS، فهو خادم MCP بعيد. عنوان URL الذي تمنحه إلى Claude هو العنوان الذي يقبل فيه الخادم طلبات MCP، مثل https://mcp.example.com/mcp.

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

الموصلات المخصصة مقابل موصلات الدليل

يسرد Connectors Directory الخدمات التي تقدم موصلًا جاهزًا. بعضها موثّق من Anthropic وبعضها الآخر من إعداد المجتمع. أما الموصل المخصص فهو أي موصل تضيفه بنفسك عبر عنوان URL، ويتعامل معه Claude كاتصال بخدمة غير موثّقة.

• موصل من الدليل: نقرة واحدة، ويتولى المزوّد صيانته، وقد يكون موثّقًا أو من إعداد المجتمع.
• موصل مخصص: أي خادم MCP بعيد لديك عنوان URL له، مع إعدادات المصادقة التي تختارها أنت.

إذا كانت الخدمة التي تريدها موجودة في الدليل، فاتصل بها من هناك. واختر المسار المخصص عندما تكون أنت من بنى الخادم، أو عندما تشغّل شركتك خادمًا داخليًا، أو عندما ينشر مزوّد عنوان MCP دون أن يظهر في الدليل.

هل تعمل الخطة المجانية؟

موصل واحد في الخطة المجانية

نعم. تعمل الموصلات المخصصة عبر عنوان URL في Free وPro وMax وTeam وEnterprise. تأتي الخطة المجانية بموصل مخصص واحد، وهذا الحد ينطبق على الحساب الذي سجلت الدخول به. ويكفي هذا الموصل الواحد لتجربة حقيقية: اربط خادمك، وشغّل بعض الطلبات للقراءة فقط، وقرّر ما إذا كان الإعداد يستحق خطة مدفوعة أو خادمًا ثانيًا.

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

إعداد Team وEnterprise

في Team وEnterprise، يفتح Owner القائمة Organization settings > Connectors، ثم يختار Add، ثم Custom. إذا طلب Claude نوع الموصل، فاختر Web. يدخل Owner عنوان URL، ويضيف اختياريًا معرّف عميل OAuth وسرّه، ثم ينقر Add. بعد ذلك يفتح الأعضاء القائمة Customize > Connectors، ويجدون المدخل الذي يحمل التسمية Custom، وينقرون Connect لتسجيل الدخول بحساباتهم الخاصة. العضو الذي لا يملك دورًا مؤهلًا لا يستطيع إضافة موصل مخصص، لذا أرسل عنوان URL إلى Owner بدلًا من ذلك.

أضف واحدًا في خمس خطوات

الخطوات في Free وPro وMax

1. افتح Customize > Connectors.
2. انقر Add custom connector.
3. أدخل عنوان URL لخادم MCP البعيد.
4. أدخل بيانات اعتماد OAuth اختياريًا.
5. انقر Add.

يختلف شكل الحوار بحسب المؤسسة. يرى بعض المستخدمين الاسم وعنوان URL ومنطقة إعدادات قابلة للتوسيع على شاشة واحدة، مع معرّف عميل OAuth وسره مخفيين داخلها. ويحصل آخرون على تدفق من خطوتين يطلب منهم اختيار إعدادات المصادقة صراحةً. ينتهي المساران في المكان نفسه: موصل في قائمتك يحمل تسمية Custom.

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

معنى كل حقل

يشير عنوان URL الذي ينتهي بـ /sse إلى نقل SSE الأقدم. كل ما عداه يستخدم الإعداد الافتراضي. وتغيير إعداد النقل دون سبب من وثائق الخادم طريقة مضمونة لكسر إعداد كان يعمل.

بعد إنشاء الموصل، يمكنك تشغيله أو إيقافه لكل محادثة: انقر زر + في المحادثة، واختر Connectors، ثم بدّل حالته.

OAuth أم رمز الحامل أم سر API

ثلاث حالات، وثلاثة إعدادات. ابدأ بالجدول، ثم اقرأ القسم الذي يطابق خادمك.

OAuth: يسجّل كل شخص دخوله

OAuth هو الخيار الصحيح عندما ينبغي أن يتصرف كل شخص باسمه. لإعداد Authentication وضعان للمصادقة عبر OAuth. يرسل Sign in now كل مستخدم عبر تدفق OAuth الخاص بالخادم قبل استخدام الموصل. أما Sign in when needed فيتيح لـ Claude الاتصال دون بيانات اعتماد، ولا يطلب تسجيل الدخول إلا عندما يطلبه الخادم.

يحدد إعداد OAuth client الطريقة التي يعرّف بها Claude نفسه أمام خادم التفويض التابع للخادم:

• استخدم هوية Claude المنشورة: الخيار الموصى به. يقرأ الخادم تفاصيل عميل Claude من Client ID Metadata Document تستضيفه Anthropic. لا تضبط أي شيء بنفسك، لكن يجب أن يدعم الخادم هذه الطريقة.
• التسجيل التلقائي: يسجّل Claude عميل OAuth لدى الخادم عند اتصال المستخدمين، باستخدام Dynamic Client Registration. يعمل مع معظم الخوادم، ويضيف تسجيلات العملاء مع الوقت.
• استخدم عميل OAuth الخاص بك: أدخل معرّف عميل سجّلته لدى الخادم. اترك السر فارغًا ما لم يكن خادم التفويض يشترطه.

اقرأ نطاقات الأذونات في شاشة الموافقة قبل أن توافق. أي موصّل يطلب صلاحية الكتابة على كل شيء يستحق منك نظرة ثانية.

رمز الحامل في ترويسات الطلب

رمز الحامل بيانات اعتماد يدخل بها من يحملها. ويتوقع الخوادم وجوده في مكان واحد: Authorization: Bearer <token>. ولوقت طويل لم يكن في حوار الموصل المخصص حقل لذلك، وقد طلب المطورون إضافته في تقارير عامة، مثل المشكلة رقم #112 في مستودع claude-ai-mcp التابع لشركة Anthropic، التي فُتحت في مارس 2026. والجواب اليوم هو قسم Request headers في الحوار، وهو في مرحلة تجريبية (beta) ومتاح لعدد محدود من المؤسسات. إذا لم تره، فهذا يعني أن مؤسستك لا تملك وصولًا إليه بعد.

التفصيل الذي يسبب معظم الأعطال: يرسل Claude قيمة الترويسة كما تكتبها تمامًا. لا يضيف أبدًا مخططًا أو بادئة.

معظم الخوادم ترفض الصيغة الثانية. إذا أظهرت وثائق الخادم Authorization: Bearer YOUR_TOKEN، فاكتب Bearer ثم مسافة ثم الرمز. والمصادقة الأساسية (Basic) تعمل بالطريقة نفسها: اكتب Basic متبوعة ببيانات الاعتماد المرمّزة بصيغة base64.

💡 OAuth يمنع ترويسة Authorization. في اتصال يستخدم OAuth لا يمكنك ضبط Authorization كترويسة طلب، لأن OAuth يستخدمها أصلًا. رمز الحامل يحتاج No sign-in.

سيتعرف المطورون الذين يعملون مع واجهة PicassoIA البرمجية على هذا النمط. تقع على https://api.picassoia.com/v1، وكل استدعاء يحمل بيانات اعتماد من نوع الحامل تبدأ بـ pia_sk_. الترويسة نفسها، والبادئة Bearer نفسها، والقاعدة نفسها: من يملك السلسلة يدخل، لذلك لا يجوز أن تظهر في لقطة شاشة أبدًا.

سر API ثابت كترويسة

بعض الخوادم تتجاوز رموز الحامل، وتريد سرًا عاديًا في ترويسة خاصة بها. المسار الموثّق بسيط: اختر No sign-in، ثم أضف السر ضمن Request headers. يخزّن Claude السر بوصفه بيانات اعتماد للموصل.

إليك طريقة عمل قسم Request headers:

• اسم الترويسة: اختر من القائمة، وهي تقدم أسماء المصادقة والتوجيه القياسية مثل authorization وx-auth-token، أو اختر Custom header لكتابة اسم آخر.
• الموافقة: تراجع Anthropic كل اسم ترويسة مخصص وتوافق عليه قبل أن يرسله Claude إلى خادم طرف ثالث. الاسم غير المعتمد يُرفض برسالة خطأ عند الحفظ. لطلب الموافقة، تواصل مع دعم Claude.
• مطلوبة أو اختيارية: الترويسة المطلوبة التي لا تحمل قيمة مخزنة تؤدي إلى فشل الاتصال. أما الترويسة الاختيارية بلا قيمة فتُحذف من الطلب.
• الحد: حتى أربع ترويسات لكل موصل.
• التخزين: يحتفظ Claude بكل قيمة بشكل آمن، ولا يعرضها مرة أخرى بعد الحفظ.

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

فحوصات الشبكة والأمان

الإنترنت العام ونطاقات IP

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

قائمة تحقق سريعة قبل التشغيل لمالكي الخوادم:

• يبدأ عنوان URL بـ https:// ويشير إلى المسار الدقيق الذي يقبل طلبات MCP.
• يجيب الخادم من الإنترنت العام، لا من شبكة مكتبك أو VPN فقط.
• نطاقات IP الخاصة بشركة Anthropic مسموح بها عبر أي جدار حماية أو بوابة.
• بيانات الاعتماد التي تنوي كتابتها تعمل عند اختبارها من عميل HTTP بسيط أولًا.

راجع الأدوات قبل الموافقة

يمنح خادم MCP البعيد Claude أدوات قادرة على قراءة البيانات أو إنشائها أو تعديلها أو حذفها. تعامل مع الاتصال الأول كما تتعامل مع استئجار مقاول:

• اتصل فقط بخوادم من مؤسسات موثوقة.
• راجع نطاقات الأذونات المطلوبة أثناء تسجيل الدخول.
• انتبه لحقن الأوامر (prompt injection). يملك Claude حمايات مدمجة، لكنها ليست ترخيصًا للتراخي.
• اقرأ طلبات الموافقة على الأدوات بعناية، وانقر Always allow فقط للخوادم التي تثق بها.
• أوقف الموصلات التي لا تستخدمها، من قائمة + في المحادثة.
• امنع الأدوات التي لا تحتاجها أبدًا: اذهب إلى Customize > Connectors، واختر الموصل، واضبط إذن الأداة على Blocked.

إذا تصرف خادم كخادم خبيث، فأبلغ عنه عبر Bug Bounty Program الخاص بـ Anthropic.

إصلاح أخطاء الاتصال

الأخطاء الشائعة وحلولها

إعدادات لا يمكنك تعديلها لاحقًا

من Customize > Connectors (يستخدم Owners القائمة Organization settings > Connectors)، يمكنك تعديل اسم الموصل أو عنوان URL الخاص به، أو حذفه. لا يمكنك تغيير إعدادات المصادقة بعد إضافته، ويشمل ذلك بيانات اعتماد OAuth وترويسات الطلب على حد سواء. ولتغييرها، احذف الموصل وأضفه من جديد بالتفاصيل الجديدة. وفي Team وEnterprise، يحتاج الأعضاء بعد ذلك إلى إعادة الاتصال.

هذه القاعدة تحدد أيضًا طريقة تدوير الرمز. عندما ينتهي رمز الحامل أو يتسرب، دوّره من مصدره، ثم احذف الموصل وأضفه من جديد بالقيمة الجديدة.

كيف تستخدم Sonnet 5 على PicassoIA

لماذا يفيد Claude ثانٍ

أثناء إعداد الموصلات، تفيد محادثة منفصلة في الكتابة المحيطة بالعمل: فك تشفير خطأ من الخادم، أو صياغة README يسرد أدواتك، أو تحويل وثائق المصادقة لخادمك إلى قيمة الترويسة الدقيقة التي ستكتبها. تستضيف Picasso IA عدة نماذج Claude في فئة Large Language Models، لذا يمكنك إبقاء تلك المحادثة مفتوحة بجوار إعدادات Claude.

الخطوات في Picasso IA

1. افتح Claude Sonnet 5 في مجموعة Large Language Models.
2. اكتب الأمر النصي. الصق نص الخطأ، أو مقتطف وثائق الخادم، أو جدول الترويسات، مع استبدال كل بيانات اعتماد حقيقية بـ <TOKEN>.
3. أضف System Prompt اختياريًا حتى تستمر التعليمات طوال المحادثة، مثل: "أنت تراجع إعدادات خوادم MCP. لا تطلب مني أبدًا لصق سر حي."
4. أرفق صورة إذا كانت لقطة الشاشة توضح الأمر أسرع من النص. اطمس أي سر أو اقتطعه أولًا.
5. اختر effort level، من منخفض إلى أقصى. يتجاوز المستوى المنخفض التفكير الموسّع لأسرع رد. ارفع المستوى عندما تطارد فشل OAuth معقدًا.
6. حدّد الحد الأقصى لطول الرد، أو اترك القيمة الافتراضية، ثم ولّد.
7. أجب في المحادثة نفسها لتحسين الإجابة أو لتسليم Claude الخطوة التالية.

💡 لا تلصق بيانات اعتماد حية في أي محادثة أبدًا. استبدلها بعنصر نائب أولًا. تعرض صفحة النموذج 3 نقاط لكل توليد، وتقول إنه يمكنك تجربة Claude Sonnet 5 دون خطة مدفوعة.

أنشئ صورك الخاصة على Picasso IA

الوثائق ومنشورات الإطلاق والدروس عن خادم MCP الخاص بك تحتاج كلها إلى صور، وصور المخزون نادرًا ما تطابق ما بنيته. تحوّل Picasso IA جملة إلى صورة واقعية كالصور الفوتوغرافية خلال ثوانٍ. ابدأ مع PicassoIA Image للمشاهد السريعة، وجرّب Flux 2 Pro عندما تهمك التكوينات، أو قارن مع Seedream 5 Lite. تتعامل المنصة أيضًا مع تعديل الصور ورفع الدقة وتوليد الفيديو، فيغطي حساب واحد مسار الأصول كاملًا.

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