رابط خادم MCP هو عنوان الويب الذي يستدعيه عميل الذكاء الاصطناعي للوصول إلى خادم Model Context Protocol عن بُعد. يوضح هذا المقال كيف يُبنى العنوان، ويقدّم أمثلة حقيقية من Notion وGitHub وSentry، ويعرض الأماكن التي تجد فيها الرابط الدقيق الذي تحتاجه.
تلصق رابطًا في عميل ذكاء اصطناعي وتضغط على الاتصال، فلا يحدث شيء. أو تطلب شاشة الإعداد "عنوان خادم MCP" ولا تعرف من أين يأتي هذا العنوان. الإجابة المختصرة: عنوان خادم MCP هو عنوان الويب لخادم Model Context Protocol عن بُعد. إنه نقطة النهاية الدقيقة التي يستدعيها عميل الذكاء الاصطناعي لعرض الأدوات وقراءة البيانات وتنفيذ الإجراءات نيابةً عنك.
يشرح هذا المقال معنى العنوان، وكيفية بنائه، وأي الأمثلة الحقيقية يمكنك مقارنتها به، والأماكن التي تجد فيها الرابط الذي تحتاجه. ستتعرّف أيضًا على الأخطاء التي تقف وراء معظم حالات فشل الاتصال، وطريقة سريعة للتحقق من الإعداد قبل أن تلوم الخادم.
بروتوكول سياق النموذج (MCP) معيار مفتوح يتيح لتطبيق الذكاء الاصطناعي التواصل مع أدوات خارجية بلغة واحدة يمكن التنبؤ بها. تشارك في هذه البنية ثلاثة أدوار: المضيف (تطبيق الذكاء الاصطناعي الذي تستخدمه)، والعميل الذي يعمل داخل ذلك التطبيق، والخادم الذي يكشف الأدوات والموارد والأوامر النصية. تنتقل الرسائل بين العميل والخادم بصيغة JSON-RPC.
عندما يعمل الخادم على الإنترنت بدلًا من جهازك، يحتاج العميل إلى معرفة المكان الذي يرسل إليه هذه الرسائل. هذا الموقع هو عنوان خادم MCP. فكّر فيه كرقم هاتف مزوّد أداة محدد: اتصل به، فيردّ الخادم بقائمة بما يستطيع فعله.
تسمّي المواصفات الرسمية هذا العنوان نقطة نهاية MCP. وهو مسار HTTP واحد، وتشترط المواصفات أن يدعم طلبات POST وGET معًا. كل رسالة يرسلها العميل هي طلب POST جديد إلى ذلك المسار. ويمكن للعميل اختياريًا فتح طلب GET على المسار نفسه للاستماع إلى الرسائل التي يريد الخادم دفعها. عنوان واحد، دون قائمة مسارات متشعبة عليك حفظها.
💡 نصيحة: إذا ذكرت صفحة الإعداد عبارات مثل "عنوان الخادم" أو "عنوان نقطة النهاية" أو "عنوان الموصل" أو "عنوان MCP عن بُعد"، فالمقصود غالبًا هذا العنوان الواحد نفسه.
لا يصف العنوان الأدوات، ولا يحمل تسجيل دخولك. إنه مجرد باب. ما يقدمه الخادم يظهر بعد أن يتصل العميل ويطلب ذلك. لهذا قد يتصرف خادمان بعنوانين متشابهين بطريقتين مختلفتين تمامًا، ولهذا لا يكفي أن يعمل العنوان لتعرف أن الإعداد صحيح.
رابط خادم MCP هو رابط ويب قياسي. ولا تحمل بنيته أي مفاجآت. تستخدم المواصفات نفسها هذا المثال:
https://example.com/mcp
قسّم هذا المثال إلى أجزاء، وستجد لكل جزء وظيفة محددة.
| الجزء | المثال | وظيفته |
|---|---|---|
| البروتوكول | https:// | يخبر العميل باستخدام HTTP المشفّر. ينبغي للخوادم البعيدة أن تستخدمه دائمًا. |
| المضيف | mcp.example.com | اسم النطاق الخاص بالخادم. غالبًا ما يبدأ بـ mcp. أو api.. |
| المنفذ (اختياري) | :8443 | يظهر فقط عندما يتجاوز الخادم منفذ HTTPS الافتراضي. |
| المسار | /mcp | نقطة النهاية الوحيدة التي تتعامل مع حركة MCP. |
| الاستعلام (اختياري) | ?workspace=123 | نادر، لكن بعض المزودين يضيفون إعدادات مثل مساحة العمل. |
تستخدم خوادم التطوير المحلية غالبًا http://localhost:3000/mcp العادي. وهذا مقبول على جهازك. لا تعرّض أبدًا عنوانًا غير مشفّر للإنترنت المفتوح.
تقول المواصفات فقط إن نقطة النهاية "يمكن أن تكون عنوانًا مثل" المثال أعلاه. والمسار مجرد عُرف وليس قاعدة. ومع ذلك، تهيمن لاحقتان في الممارسة:
/mcp يشير عادةً إلى خادم Streamable HTTP، وهو وسيلة النقل القياسية الحالية./sse يشير عادةً إلى وسيلة HTTP+SSE القديمة التي ظهرت مع إصدار البروتوكول 2024-11-05.تعامل مع اللاحقة كدليل وليس كضمان. يمكن للمزوّد أن ينشر نقطة النهاية على /v1/mcp أو على الجذر الخاص بنطاق فرعي. انسخ العنوان تمامًا كما هو مكتوب، بما في ذلك أي شرطة مائلة في النهاية. فالخادم البعيد الخاص بمنصة GitHub، على سبيل المثال، ينتهي بـ /mcp/.
حلّت Streamable HTTP محل وسيلة HTTP+SSE القديمة. وفق التصميم الأحدث، يرسل العميل دائمًا طلب POST مع ترويسة Accept تسرد كلًّا من application/json وtext/event-stream. ويردّ الخادم إما بكائن JSON واحد أو بتدفّق من الأحداث. وقد يعيد الخادم أيضًا ترويسة Mcp-Session-Id، فيكررها العميل في كل طلب لاحق. ويرسل العملاء ترويسة MCP-Protocol-Version حتى يتفق الطرفان على إصدار المواصفات.
تصف وثائق Claude Code الآن SSE بأنها مهجورة، وتوصي بخوادم HTTP حيثما توفرت. ويُبقي كثير من المزودين على عنوان /sse فعّالًا للعملاء الأقدم، ولهذا ما تزال تصادف النمطين معًا.
💡 نصيحة: يقبل العميل الذي يريد التوافق مع الخوادم الأقدم عنوان URL واحدًا من المستخدم، ويجرّب طلب POST أولًا. فإذا ردّ الخادم بخطأ من فئة 4xx، ينتقل إلى طلب GET ويتوقع تدفّق SSE. وهذا الاحتياط هو السبب في أن العنوان نفسه الملصوق قد ينجح في تطبيق ويفشل في آخر.
ليس لكل خادم MCP عنوان URL. وهذا يفاجئ كثيرين، ويفسّر سبب طلب بعض الإعدادات أمرًا بدلًا من عنوان.
مع وسيلة stdio، يشغّل العميل الخادم كعملية فرعية على حاسوبك. تنتقل الرسائل عبر الإدخال القياسي والإخراج القياسي. لا توجد قفزة شبكية ولا عنوان. تزوّد العميل بأمر ووسائطه، مثل npx مع اسم الحزمة، وهذا كل ما يحتاجه العميل. وتطلب المواصفات من العملاء دعم stdio كلما أمكن، لذلك تبقى الوسيلة الافتراضية للأدوات المحلية.
مع Streamable HTTP، يعمل الخادم كعملية مستقلة ويمكنه التعامل مع عملاء كثيرين في وقت واحد. وهنا يصبح العنوان ضروريًا، لأن العميل يجب أن يجد الخادم عبر الشبكة.
| وسيلة النقل | هل لها عنوان؟ | الإعداد المعتاد | الحالة |
|---|---|---|---|
| stdio | لا | command وargs في ملف إعداد | معيارية، ويجب أن يدعمها العملاء |
| Streamable HTTP | نعم، نقطة نهاية واحدة | الصق https://…/mcp | وسيلة النقل البعيدة القياسية |
| HTTP+SSE | نعم، غالبًا /sse | الصق https://…/sse | مهجورة، وتُبقى للعملاء الأقدم |
استخدم العمود الثاني كقاعدة للقرار. إذا قدّم لك المزود سطر أوامر، فأنت على stdio. وإذا قدّم لك رابطًا، فأنت على وسيلة نقل بعيدة.
عندما يعمل خادم على جهازك عبر HTTP، تقول المواصفات إنه ينبغي أن يربط نفسه بـ 127.0.0.1 بدلًا من 0.0.0.0، ويجب أن يتحقق من ترويسة Origin لمنع هجمات إعادة ربط DNS. وبعبارة بسيطة: لا ينبغي أن يكون خادم MCP محلي على localhost متاحًا لأجهزة أخرى على شبكتك، إلا إذا أردت ذلك عمدًا.
تأتي العناوين أدناه من صفحات التوثيق الرسمية والقوائم العامة. يغيّر المزودون نقاط النهاية باستمرار، لذلك اعتبر هذا الجدول مرجعًا للنمط، وتحقق من كل عنوان في الوثائق الحالية للمزود قبل الاعتماد عليه.
| المزوّد | مثال على العنوان | النمط |
|---|---|---|
| عينة المواصفات | https://example.com/mcp | Streamable HTTP |
| Notion | https://mcp.notion.com/mcp | Streamable HTTP |
| GitHub | https://api.githubcopilot.com/mcp/ | Streamable HTTP |
| Sentry | https://mcp.sentry.dev/mcp | Streamable HTTP |
| Supabase | https://mcp.supabase.com/mcp | Streamable HTTP |
| PostHog | https://mcp.posthog.com/mcp | Streamable HTTP |
| Asana | https://mcp.asana.com/sse | SSE القديمة |
| خادم اختبار محلي | http://localhost:3000/mcp | Streamable HTTP على جهازك |
mcp.: mcp.notion.com، وmcp.sentry.dev، وmcp.supabase.com.api.githubcopilot.com.Authorization.تعرض وثائق Claude Code هذه الصيغ الدقيقة لكل من Notion و Asana:
claude mcp add --transport http notion https://mcp.notion.com/mcp
claude mcp add --transport sse asana https://mcp.asana.com/sse
الفرق الوحيد هو قيمة --transport والمسار. أما كل شيء آخر، بما في ذلك الاسم الذي تختاره، فيبقى قرارك.
بما أن الرابط ملك لمالك الخادم، فإن المصدر الأكثر موثوقية هو المالك دائمًا. هذا الترتيب يوفّر أكبر قدر من الوقت.
ابحث في وثائق المزود عن "MCP" أو "MCP عن بُعد" أو "الموصلات". عادةً ما تحتوي بوابات المطورين على صفحة مخصصة، وغالبًا مع زر نسخ بجوار العنوان. تذكر تلك الصفحة لاحقة /mcp أو /sse صراحةً، فلا تحتاج إلى التخمين.
تعرض بعض المنتجات العنوان في حسابك. وقد تسرد صفحة الإعدادات الخاصة بالتكاملات أو الاتصالات أو أدوات المطورين العنوان مع خطوات الإعداد لكل عميل. وإذا طلبت الصفحة تسجيل الدخول فهذا طبيعي، إذ يربط كثير من المزودين الاتصال بحسابك.
تصف خوادم المصدر المفتوح نفسها في ملف README. ابحث عن قسم بعنوان "Usage" أو "Installation" أو "Configuration". وإذا أظهر الملف command وargs فقط، فالخادم يعمل عبر stdio فقط، ولا يملك عنوانًا عامًا حتى ينشره أحد.
تحتفظ الأدلة العامة مثل MCPservers.org بقوائم بخوادم MCP البعيدة ونقاط نهايتها. استخدمها لإيجاد المرشحين، ثم تحقق من العنوان في وثائق المزود نفسه. وقد تصبح مدخلات الأدلة قديمة.
إذا وصل زميل لك بالخادم بالفعل، فاطلب منه تشغيل claude mcp list أو claude mcp get <name> في Claude Code. يعرض الأمران كيف يُهيَّأ الخادم، وهنا يمكنك رصد العنوان. وداخل جلسة تعمل، يعرض الأمر /mcp حالة كل خادم.
بمجرد أن تملك العنوان الصحيح، يستغرق الإعداد أقل من دقيقة. وتناسب ثلاثة مسارات تقريبًا كل عميل.
يحتاج Claude Code إلى وسيلة النقل والاسم والرابط:
claude mcp add --transport http <name> <url>
لإرسال رمز مع كل طلب، أضف ترويسة:
claude mcp add --transport http secure-api https://api.example.com/mcp \
--header "Authorization: Bearer your-token"
تقرأ معظم العملاء أيضًا ملف JSON. تختلف أسماء الحقول بين التطبيقات، فراجع وثائق عميلك، لكن الشكل قريب من هذا:
{
"mcpServers": {
"notion": {
"type": "http",
"url": "https://mcp.notion.com/mcp"
},
"local-files": {
"command": "npx",
"args": ["-y", "example-mcp-package"]
}
}
}
المدخل الأول بعيد ويستخدم url. والثاني من نوع stdio ويستخدم command. التزم بنمط واحد لكل مدخل.
تطلب تطبيقات الدردشة التي تملك شاشة موصل مخصصة عادةً شيئين: اسمًا ورابطًا. الصق العنوان، واحفظ، وأكمل نافذة تسجيل الدخول إن ظهرت. لا يلزم شيء آخر، لأن التطبيق يجد الأدوات بنفسه بعد فتح الاتصال.
ترجع معظم حالات فشل الاتصال إلى قائمة قصيرة من الأسباب. تحقق منها بهذا الترتيب قبل أن تلمس أي شيء آخر.
لا يكفي اسم المضيف وحده، مثل https://mcp.example.com، في الغالب. يحتاج العميل إلى مسار نقطة النهاية الدقيق. وإذا ظهر لك الخطأ 404، فانسخ العنوان من الوثائق الحالية للمزوّد مرة أخرى، وقارنه حرفًا بحرف، بما في ذلك الشرطة المائلة في النهاية.
عنوان قاعدة REST API العادي ليس عنوان MCP. فقاعدة مثل https://api.example.com/v1 تخدم الطلبات العادية، ولا تتحدث JSON-RPC عبر وسيلة نقل MCP. وإذا قدّم المزوّد الاثنين، فإن الوثائق تسردهما في صفحات منفصلة. لا تلصق أبدًا عنوان API في حقل مكتوب عليه "عنوان خادم MCP" وتتوقع ظهور الأدوات.
قد يفشل الرابط الصحيح أيضًا دون إذن استخدامه. يردّ الخوادم بالخطأ 401 عندما يكون رمزك مفقودًا أو منتهي الصلاحية، وبالخطأ 403 عندما لا يملك حسابك الوصول إلى تلك مساحة العمل. سجّل الدخول مرة أخرى عبر العميل، أو حدّث رمز Bearer الذي تمرره في ترويسة Authorization.
💡 نصيحة: أبقِ الرموز خارج عنوان URL. وإذا طلب منك مزوّد لصق سر في سلسلة الاستعلام، فعامل هذا الرابط كأنه كلمة مرور، ولا تشاركه أبدًا في لقطات الشاشة أو تذاكر الدعم.
| العرض | السبب المرجّح | الحل |
|---|---|---|
| 404 Not Found | مسار خاطئ، أو نقل المزود نقطة النهاية | انسخ العنوان مرة أخرى من الوثائق الحالية |
| 405 Method Not Allowed | إرسال POST إلى عنوان SSE فقط، أو إرسال GET إلى عنوان POST فقط | جرّب عنوان /mcp أو بدّل وسيلة النقل إلى sse |
| 401 Unauthorized | رمز مفقود أو منتهٍ، أو لم يكتمل OAuth | سجّل الدخول مرة أخرى أو حدّث رمز Bearer |
| 403 Forbidden | الحساب لا يملك الوصول إلى ذلك الخادم أو مساحة العمل | تحقق من الخطة ومساحة العمل والصلاحيات |
| Connection refused | الخادم المحلي غير قيد التشغيل، أو المنفذ خاطئ | شغّل الخادم وتحقق من المنفذ |
| Certificate error | شهادة HTTPS موقّعة ذاتيًا أو غير متطابقة | استخدم شهادة صالحة |
| Works in one app only | اختلاف دعم وسيلة النقل | طابق وسيلة النقل (http أو sse) مع العميل |
هناك فرق دقيق يوفّر كثيرًا من الالتباس: تسمح المواصفات للخادم بأن يردّ على طلب GET بالخطأ 405 ليقول إنه لا يقدّم تدفق SSE عند تلك نقطة النهاية. لذلك فإن الخطأ 405 على طلب GET وحده ليس عطلًا دائمًا.
تنشر PicassoIA واجهة برمجية للمطورين على https://api.picassoia.com/v1. وتستخدم نقاط نهاية على غرار Replicate مثل POST /v1/models/{owner}/{name}/predictions وGET /v1/predictions/{id}، وتصادق برمز Bearer يبدأ بالبادئة pia_sk_. هذا العنوان يخص REST API. وهو ليس عنوان خادم MCP، لذلك لا تلصقه في حقل MCP.
تُدار اتصالات MCP من حسابك على picassoia.com/en/mcp/accounts، ويتطلب ذلك تسجيل الدخول. ولا يُنشر عنوان خادم MCP في الصفحات العامة، لذا ابدأ من هناك بدلًا من التخمين. تنطبق قواعد الخطط، فراجع صفحة الأسعار لتعرف ما تتضمنه خطتك.
النماذج الأربعة التالية متاحة عبر API وMCP معًا:
تعمل المهام بشكل غير متزامن: تنشئ تنبؤًا، ثم تستعلم عن حالته، ثم تجلب النتيجة. الحد هو 5 تنبؤات متزامنة لكل حساب، مشتركة بين الرموز واتصالات MCP، مع أوامر نصية تصل إلى 4,000 حرف.
يتعامل النموذج Claude Sonnet 5 مع مهام البرمجة واستخدام الأدوات، ما يجعله عينًا ثانية مفيدة لملف إعدادات. إليك روتين قصير على PicassoIA:
💡 نصيحة: تعامل مع الإجابة كدليل مبدئي وليس كحكم نهائي. وتكون وثائق المزود هي المرجع عندما تختلف الاثنتان.
GPT 5.6 Sol يعمل بالطريقة نفسها إذا فضّلت رأيًا ثانيًا.
لا يكون الخادم المتصل مفيدًا إلا إذا كان لديك ما تبنيه به. افتح PicassoIA، واختر PicassoIA Image أو Seedance 2.5 Lite، واكتب أمرًا نصيًا يصف المشهد الذي تتخيله، وأنشئ أول نتيجة لك خلال دقائق. جرّب صورة لمقالك التالي، أو لقطة لمنتج، أو مقطعًا قصيرًا، ثم حسّن الصياغة وشغّلها مرة أخرى. تكافئ المنصة التجريب، فابدأ أمرك الأول اليوم وشاهد ما تستطيع كلماتك إنتاجه.
اختر لغتك
