أضف خادم MCP إلى Claude Code من الطرفية أو من VS Code. اتبع الأوامر الدقيقة لخوادم HTTP البعيدة وخوادم stdio المحلية، والنطاقات الثلاثة، وتسجيل الدخول عبر OAuth، ومثال عملي لتوليد الصور والفيديو مع PicassoIA، وحلول لأي خادم يفشل في الاتصال.
يستطيع Claude Code قراءة ملفاتك وتشغيل أوامر الشل مباشرة، لكنه لا يرى متتبّع المشكلات أو قاعدة البيانات أو أداة توليد الصور لديك إلا بعد أن تربطها به. هذا الربط هو خادم MCP. وMCP، اختصارًا لـ Model Context Protocol، هو المعيار المفتوح الذي الذي يتيح لأداة Claude Code استدعاء خدمات خارجية كأنها جزء من التطبيق نفسه. تحتاج إضافته إلى أمر واحد فقط، وبعدها يظهر الخادم نفسه في الطرفية وفي إضافة VS Code.
يعرض هذا المقال الأوامر الدقيقة، والنطاقات الثلاثة التي تحدد من يحصل على الخادم، وتفاصيل OAuth والتوكنات التي تُربك كثيرين، ومثالًا حقيقيًا باستخدام اتصال PicassoIA للصور والفيديو. وقد جرى التحقق من الأوامر والخيارات الواردة أدناه مقابل وثائق Claude Code الحالية بتاريخ 6 أكتوبر 2026، لتطابق ما سترونه في طرفيتك.
💡 الخلاصة المختصرة: بالنسبة إلى خادم مستضاف، شغّل
claude mcp add --transport http <name> <url>. وبالنسبة إلى خادم محلي، شغّلclaude mcp add --transport stdio <name> -- <command>. ثم اكتب/mcpداخل Claude Code وتأكد من أن الخادم يعرض Connected.
تحتاج إلى Claude Code نفسه. وإذا كنت ستستخدم مسار VS Code، فستحتاج أيضًا إلى VS Code 1.94.0 أو أحدث مع إضافة Claude Code. تحقق من إصدار CLI باستخدام claude --version، لأن بعض الميزات تعتمد عليه:
/mcp reconnect all يتطلب الإصدار v2.1.284 أو أحدثأول ما يجب استبعاده عندما لا تنفذ خطوة من الخطوات التالية شيئًا هو تثبيت قديم. تحتاج أيضًا إلى تفاصيل الخادم، وهي تعتمد على مكان تشغيله. يعطيك الخادم البعيد عنوان URL مع توكن أو تسجيل دخول عبر المتصفح. أما الخادم المحلي فيمنحك أمرًا يشغّله، وغالبًا عبر npx، لذلك يجب أن يكون Node.js مثبتًا.
يخبر العلم --transport Claude Code بكيفية التواصل مع الخادم. وهناك ثلاثة خيارات.
| طريقة النقل | مكان تشغيل الخادم | متى تستخدمها | الحالة |
|---|---|---|---|
http | عنوان URL بعيد | تقدم لك خدمة مستضافة عنوان URL | الخيار الحالي للخوادم المستضافة |
sse | عنوان URL بعيد | لا يوفر المورّد إلا نقطة /sse | مهمَل |
stdio | جهازك | الخادم برنامج يشغّله Claude Code | المعيار للأدوات المحلية |
قاعدة سريعة: عنوان URL ينتهي بـ /mcp يعني HTTP، وعنوان URL ينتهي بـ /sse يعني نقل SSE الأقدم (تحقّق مما إذا كان المورّد يوفر الآن عنوان HTTP)، والأمر الذي يحتوي على npx يعني stdio.
واجهة سطر الأوامر (CLI) هي أسرع طريق، وكل ما تفعله هنا هو ما تقرؤه إضافة VS Code أيضًا. افتح طرفية في مجلد مشروعك، أو في أي مجلد إذا كنت ستستخدم نطاق المستخدم الموضح لاحقًا.
الصيغة هي claude mcp add --transport http <name> <url>. إليك خادم مستضاف حقيقي:
claude mcp add --transport http notion https://mcp.notion.com/mcp
الكلمة notion هي الاسم الذي تختاره. وتظهر في أسماء الأدوات بالشكل mcp__notion__<tool>، لذا اجعلها قصيرة وبحروف صغيرة. وعندما يطلب الخادم توكنًا، مرّره كترويسة:
claude mcp add --transport http secure-api https://api.example.com/mcp \
--header "Authorization: Bearer your-token"
💡 انتبه:
claude mcp addيحفظ الإعدادات دون التحقق من بيانات اعتمادك. التوكن الوهمي يُقبل، ولا يظهر الفشل إلا لاحقًا عندما يحاول الخادم الاتصال.
خادم stdio هو برنامج على جهازك يبدؤه Claude Code ويتواصل معه عبر المدخلات والمخرجات القياسية. الصيغة هي claude mcp add [options] <name> -- <command> [args...]:
claude mcp add --transport stdio files -- npx -y @modelcontextprotocol/server-filesystem ~/projects
الشرطتان المزدوجتان إلزامية. كل ما يأتي بعدهما يُمرَّر إلى الخادم دون تعديل، ويجب أن تأتي كل خيارات Claude Code (--env، --scope، --transport) قبل الاسم. ولتمرير متغير بيئة إلى عملية الخادم، استخدم --env:
claude mcp add --transport stdio --env MY_SERVICE_TOKEN=paste-here myservice -- npx -y your-server-package
استبدل your-server-package بالحزمة التي يوثّقها المورّد. وعلى Windows الأصلي (وليس WSL)، غالبًا ما يحتاج npx إلى غلاف يسمح للشل بتشغيله:
claude mcp add --transport stdio files -- cmd /c npx -y @modelcontextprotocol/server-filesystem C:\Users\you\projects
ثلاثة أوامر تكفي لإدارة الخوادم يوميًا:
claude mcp list
claude mcp get files
claude mcp remove files
يعرض list كل الخوادم المُعدّة، ويعرض get تفاصيل خادم واحد، ويحذف remove الخادم. وإذا كان لديك تعريف الخادم بصيغة JSON، فإن claude mcp add-json <name> '<json>' يوفّر عليك تحويله إلى أعلام. وداخل جلسة Claude Code، يعرض /mcp الحالة المباشرة ويتولى تسجيل الدخول.
تشترك إضافة Claude Code وCLI في إعداد MCP واحد، لذلك يوجد مساران ولا يقيّدك أيٌّ منهما.
/mcp في مربع المحادثة./mcp مرة أخرى، وتأكد من أن الخادم يعرض Connected.الخطوة 5 مهمة. تسري التغييرات على المحادثات التي تبدؤها بعد ذلك، لذلك لن ترى المحادثة المفتوحة بالفعل الخادم الجديد.
افتح الطرفية المدمجة باستخدام Ctrl+` (أو Cmd+` على Mac)، وشغّل أمر claude mcp add نفسه الذي تستخدمه في أي مكان آخر. يحفظ مربع الحوار وأمر الطرفية الإعدادات في الملف نفسه. إليك خادم GitHub البعيد مع رمز وصول شخصي:
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
--header "Authorization: Bearer YOUR_GITHUB_PAT"
يعرض الخادم الذي تكون بياناته غير صحيحة الحالة Failed في /mcp، بينما يعرض الخادم السليم الحالة Connected.
💡 ملفان للإعداد ومنتجان مختلفان: لدى VS Code دعم خاص به لبروتوكول MCP مع ملف في
.vscode/mcp.json. هذا الملف يخص الدردشة المدمجة في VS Code ويستخدم صيغة مختلفة. يحتفظ Claude Code بإعداداته الخاصة، لذلك لن يظهر الخادم المعرّف في.vscode/mcp.jsonفقط في قائمة/mcpالخاصة بـ Claude Code.
قد تسمع أيضًا عن خادم اسمه ide. تشغّله الإضافة تلقائيًا لفتح الفروقات وقراءة التحديد لديك، ويبقى مخفيًا عن /mcp لأنه لا يحتاج إلى أي إعداد.
يحدد النطاق من يرى الخادم وأين يُخزَّن. اختره باستخدام --scope (والشكل المختصر -s).
| النطاق | يُحمَّل في | مشترك مع الفريق | يُخزَّن في |
|---|---|---|---|
| local (الافتراضي) | المشروع الحالي فقط | لا | ~/.claude.json |
| project | المشروع الحالي فقط | نعم، عبر المستودع | .mcp.json في جذر المشروع |
| user | كل المشاريع على جهازك | لا | ~/.claude.json |
claude mcp add --transport http stripe --scope local https://mcp.stripe.com
claude mcp add --transport http shared --scope project https://example.com/mcp
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic
قاعدتي التقريبية: استخدم local للتجارب وأي شيء يحمل توكنًا شخصيًا، وproject للأدوات التي يحتاجها الفريق كله، وuser للخوادم القليلة التي تريدها في كل مستودع.
يعيش خادم نطاق المشروع في ملف .mcp.json في جذر المستودع، وأنت تضيفه إلى Git. ويدعم توسيع متغيرات البيئة، لذلك لا يحتاج الملف إلى أن يحتوي على أي سر:
{
"mcpServers": {
"api-server": {
"type": "http",
"url": "${API_BASE_URL:-https://api.example.com}/mcp",
"headers": {
"Authorization": "Bearer ${API_TOKEN}"
}
}
}
}
يتوسع ${VAR} إلى متغير البيئة، ويعود ${VAR:-default} إلى قيمة افتراضية إذا لم يكن المتغير مضبوطًا. يضبط كل عضو في الفريق API_TOKEN على جهازه الخاص.
يرى أعضاء الفريق نافذة موافقة قبل أن يستخدم Claude Code خادمًا من .mcp.json في جلسة تفاعلية. ولإعادة ضبط هذه الاختيارات، شغّل claude mcp reset-project-choices. أما التشغيلات غير التفاعلية مثل claude -p فتحمّل خوادم المشروع دون طلب موافقة، وهذا جدير بالتذكّر في مهام CI.
يمكن للخادم أن يصادق بثلاث طرق، والطريقة المناسبة تعتمد على ما يدعمه المورّد.
| الطريقة | الأنسب لـ | الكيفية |
|---|---|---|
| توكن في الترويسة | الخوادم التي تصدر توكنًا شخصيًا | --header "Authorization: Bearer ..." |
| متغير بيئة | خوادم stdio المحلية | --env NAME=value |
| OAuth | الخوادم المستضافة مع تسجيل دخول عبر المتصفح | /mcp، أو claude mcp login <name> |
من أجل OAuth، افتح /mcp، واختر الخادم، واتبع تسجيل الدخول في المتصفح. ومن سطر الأوامر، يفعل claude mcp login <name> الأمر نفسه، ويطبع claude mcp login <name> --no-browser ما تحتاجه على جهاز SSH أو جهاز بلا واجهة رسومية. ولمسح بيانات الاعتماد المحفوظة، شغّل claude mcp logout <name>. وبعض الخوادم تحتاج إلى بيانات اعتماد مسجّلة مسبقًا، وتمررها باستخدام --client-id و--client-secret و--callback-port عند إضافة الخادم.
هناك عادتان تمنعان معظم التسريبات. أولًا، لا تضع توكنًا حرفيًا في Git أبدًا. ضع ${VAR} في .mcp.json، واحتفظ بالقيمة الفعلية في بيئة الشل لديك. ثانيًا، أبقِ الخوادم التي تحمل توكنًا شخصيًا على نطاق local أو user، حيث يبقى الملف خارج المستودع.
يجعل الخادم الملموس كل هذا أقل تجريدًا. تقدم PicassoIA اتصال MCP يتيح لعميل ذكاء اصطناعي إنشاء الصور والفيديوهات من داخل محادثة. ويوفر أربعة نماذج: PicassoIA Image لتحويل النص إلى صورة، وPicassoIA Image Editor Pro للتعديلات، وPicassoIA Video للمقاطع المولّدة من نص أو صورة، وSeedance 2.5 Lite لفيديو مع صوت.
الأدوات مبنية حول المهام غير المتزامنة. يعيد استدعاء التوليد معرّف تنبؤ بمجرد أن يقبل وحدة GPU المهمة، ثم يستعلم العميل عبر get_generation حتى تصبح الحالة succeeded أو failed. وتشمل الأدوات الأخرى edit_image، وlist_generations، وcancel_generation، وlist_models، وget_account. يمكن لحساب واحد تشغيل 5 تنبؤات في وقت واحد، وهذا الحد مشترك بين كل اتصالات MCP الخاصة بالحساب. يعتمد الوصول إلى MCP على خطتك، لذلك تأكد منه في صفحة أسعار PicassoIA قبل أن تعتمد عليه.
claude mcp add --transport http picassoia YOUR_PICASSOIA_MCP_URL
/mcp، واختر picassoia. إذا طلب منك تسجيل الدخول، فاتبع المسار في المتصفح. وإذا أعطتك صفحة الاتصالات توكنًا بدلًا من ذلك، فأضف --header "Authorization: Bearer YOUR_TOKEN" إلى الأمر.لا أعرض عنوان URL هنا عن قصد. تعرض PicassoIA عنوانك بعد تسجيل الدخول، لذا استخدم العنوان الدقيق من حسابك بدلًا من نسخة من مقال.
بما أنك سمّيت الخادم picassoia، فستظهر أدواته بالشكل mcp__picassoia__<tool>. جرّب أمرًا يستخدم اثنتين منها:
استخدم PicassoIA لتوليد صورة فوتوغرافية بنسبة عرض إلى ارتفاع 16:9 لمكتب خشبي عند شروق الشمس مع حاسوب محمول وفنجان قهوة، ثم حوّلها إلى فيديو قصير.
يطلب Claude Code إذنك قبل أن يستدعي أداة جديدة، لذلك توقّع نافذة طلب الإذن في أول تشغيل. وإذا أردت أيضًا مقارنة طريقة فهم النماذج اللغوية المختلفة للتعليمة نفسها، فإن PicassoIA يدرج Claude Sonnet 5 وClaude Fable 5 ضمن نماذجه اللغوية الكبيرة.
معظم الإخفاقات تعود إلى قائمة قصيرة من الأسباب. ابدأ بـ /mcp لقراءة الحالة، ثم استخدم claude mcp get <name> لترى بدقة ما تم حفظه.
| العَرَض | السبب المحتمل | الحل |
|---|---|---|
| الخادم يعرض Failed | عنوان URL خاطئ أو توكن غير صالح | تحقق باستخدام claude mcp get <name>، ثم احذف الخادم وأعد إضافته بالقيم الصحيحة |
| الخادم غير موجود في VS Code | بدأت المحادثة قبل إضافته | ابدأ محادثة جديدة |
| خادم stdio يتوقف فورًا على Windows | npx يحتاج إلى غلاف شل | استخدم -- cmd /c npx ... |
| الخادم متصل لكن دون أدوات | لم يكتمل تسجيل الدخول عبر OAuth | /mcp ثم سجّل الدخول، أو claude mcp login <name> |
| خادم المشروع لا يُحمَّل أبدًا | رُفضت الموافقة | شغّل claude mcp reset-project-choices ووافق من جديد |
| يعمل عندك ولا يعمل عند زميل | حُفظ على نطاق local | أعد الإضافة باستخدام --scope project |
| الخادم ينقطع في منتصف الجلسة | فقد الاتصال | شغّل /mcp reconnect all (الإصدار v2.1.284 أو أحدث) |
هناك ثلاثة إعدادات للتعامل مع الخوادم البطيئة. يحدد MCP_TIMEOUT مهلة بدء تشغيل الخادم بالميلي ثانية، وهذا مفيد عندما يكون تنزيل npx الأول بطيئًا:
export MCP_TIMEOUT=10000
على PowerShell في Windows، يكون الأمر نفسه $env:MCP_TIMEOUT = "10000". يرفع MAX_MCP_OUTPUT_TOKENS الحد الأقصى لمخرجات الأدوات. والقيمة الافتراضية هي 25,000 توكن، ويحذّرك Claude Code عند 10,000. وأخيرًا، يمنح timeout الخاص بكل خادم داخل .mcp.json (وهو أيضًا بالميلي ثانية) الأدوات البطيئة مساحة أكبر، وهذا مناسب لمولدات الصور والفيديو:
{
"mcpServers": {
"slow-tool": {
"type": "http",
"url": "https://example.com/mcp",
"timeout": 600000
}
}
}
لديك الآن الدورة كاملة: اختر طريقة النقل، وأضف الخادم، واختر النطاق، وسجّل الدخول بأمان، وأصلح الخادم عندما يتصرف بشكل غير سليم. أسرع طريقة للإحساس بالفائدة هي أن تربط خادمًا ينتج شيئًا يمكنك رؤيته.
سجّل الدخول إلى PicassoIA، واربطه مع Claude Code، واطلب صورة فوتوغرافية. ولّدها باستخدام PicassoIA Image، ثم حسّنها عبر PicassoIA Image Editor Pro، ثم أحيِها باستخدام PicassoIA Video أو Seedance 2.5 Lite. تصفح كل النماذج على picassoia.com/en/all-models، وابدأ بأمر نصي من تأليفك.
اختر لغتك
