Sat Jun 27 2026 20:00:00 GMT-0400 (北美东部夏令时间)

تكامل MCP في Claude Code: ربط الأدوات بالوكيل

أضف خوادم MCP إلى Claude Code باستخدام claude mcp add. قارن بين stdio المحلي ونقلات HTTP/SSE البعيدة، وقم بتعيين النطاقات، واربط GitHub، وتجنب الخوادم عالية المخاطر.

تكامل MCP في Claude Code: ربط الأدوات بالوكيل

آخر تحديث: June 28, 2026

خارج الصندوق، يقرأ Claude Code ويعدل الملفات وينفذ أوامر Shell. لا يمكنه قراءة مشكلات GitHub الخاصة بك، أو الاستعلام من قاعدة بياناتك، أو تشغيل متصفح. يغلق بروتوكول سياق النموذج (Model Context Protocol - MCP) هذه الفجوة: فهو الموصل القياسي الذي يسمح للعميل بالتحدث إلى الأدوات والبيانات الخارجية. يُظهر هذا الدليل أوامر claude mcp add الدقيقة، ومتى يجب اختيار خادم محلي مقابل خادم بعيد، وكيف تعمل النطاقات (scopes)، وما هي الخوادم التي تستحق الاتصال بها، وعمليات التحقق الأمني التي يجب تشغيلها قبل أن تثق بأي منها.

إجابة سريعة: كيف تضيف خادم MCP إلى Claude Code؟

تقوم بتسجيل الخادم باستخدام الأمر claude mcp add، ومن ثم يمكن لـ Claude Code استدعاء أدواته أثناء الجلسة.

بالنسبة لخادم محلي يعمل كعملية (process) على جهازك:

claude mcp add playwright -- npx -y @playwright/mcp@latest

بالنسبة لخادم عن بُعد يتم الوصول إليه عبر HTTPS:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

بعد إضافة الخادم، قم بتشغيل /mcp داخل Claude Code لمعرفة حالة الاتصال الخاصة به وإكمال أي تسجيل دخول OAuth. استخدم claude mcp list للتأكد من أنه تم تسجيله. يمكن العثور على المرجع الرسمي للأوامر في Claude Code MCP docs.

ما هو MCP، ولماذا يجب ربطه بـ Claude Code؟

MCP هو بروتوكول مفتوح، نشرته Anthropic لأول مرة، يحدد كيفية تبادل قدرات العميل الذكي وخادم الأدوات. يعلن الخادم عن الأدوات (الإجراءات التي يمكن للوكيل اتخاذها)، والموارد (البيانات التي يمكنه قراءتها)، والموجهات. يمكن لأي عميل مدرك لـ MCP استخدام أي خادم MCP، لذا يعمل خادم GitHub واحد في Claude Code، أو بيئة تطوير متكاملة (IDE)، أو وكيل آخر دون الحاجة إلى مواد لاصقة مخصصة. المواصفات وسجل الخوادم موجودان في modelcontextprotocol.io.

الفائدة العملية: بدلاً من لصق محتوى المشكلة في الدردشة، يمكنك توصيل خادم GitHub مرة واحدة وطلب من الوكيل قراءة وتصنيف والرد على المشكلات مباشرة. للحصول على خلفية أعمق حول البروتوكول نفسه، راجع شرح MCP، وبالنسبة للأداة الكاملة في السياق، راجع الدليل النهائي لـ Claude Code.

يمكن أن يكون الخادم عبارة عن سكريبت stdio صغير كتبته، أو صورة Docker، أو نقطة نهاية SaaS يستضيفها بائع. يعامل Claude Code جميعها بالطريقة نفسها بمجرد أنها تتحدث بروتوكول MCP.

أي وسيلة نقل يجب أن تستخدمها: محلية أم عن بُعد؟

وسيلة النقل هي كيف يصل Claude Code إلى الخادم. تعمل الخوادم المحلية على جهازك عبر stdio؛ بينما تعمل الخوادم عن بُعد في مكان آخر وتستجيب عبر HTTP أو SSE. عادةً ما يعتمد الاختيار على مكان وجود البيانات.

وسيلة النقل كيفية تشغيله الأفضل لـ المصادقة
stdio (local) يقوم Claude Code بتشغيل عملية على جهازك نظام الملفات، قواعد البيانات المحلية، السكريبتات المخصصة متغيرات البيئة أو بيانات الاعتماد المحلية
HTTP (remote) يستدعي خادمًا مستضافًا عبر HTTPS واجهات برمجة تطبيقات SaaS مثل GitHub أو Sentry OAuth أو رمز API
SSE (remote) البث من نقطة نهاية مستضافة الخوادم المستضافة طويلة الأجل للبائعين OAuth أو رمز API

استخدم خادم stdio المحلي عندما تحتاج الأداة إلى ملفات أو خدمات على جهاز الكمبيوتر المحمول الخاص بك، مثل مجلد أصول المشروع أو مثيل Postgres على localhost. استخدم خادم HTTP أو SSE عن بُعد عندما يستضيفه بائع بالفعل، لأنك تتجاوز التثبيت وتحصل على التحديثات دون لمس إعداداتك. تقوم الخوادم عن بُعد دائمًا تقريبًا بتسجيل دخولك عبر OAuth، والذي تقوم بتشغيله من قائمة /mcp.

يد مطور يكتب الكود على كمبيوتر محمول أثناء تهيئة خادم MCP

اختيار النطاق (Scope): محلي، أو خاص بالمشروع، أو للمستخدم

يحدد النطاق (Scope) من يمكنه رؤية الخادم وأين يتم تخزين الإعدادات. يدعم Claude Code ثلاثة أنواع، واختيار النوع الصحيح يبقي الأسرار بعيدًا عن مستودعك (repo) بينما لا يزال يسمح بمشاركة خوادم آمنة مع الفريق.

Scope Stored in Visible to Use when
local Your project-specific user settings Only you, only this project Personal experiments or servers that hold secrets
project .mcp.json committed to the repo Everyone who clones the repo A server the whole team should share
user Your global user settings You, across every project A server you want available everywhere

قم بتعيين النطاق باستخدام العلامة --scope، على سبيل المثال claude mcp add --scope project .... يقوم نطاق المشروع (Project scope) بإنشاء ملف .mcp.json مُضمّن في المستودع، لذا لا تضع فيه أبدًا رمزًا خامًا (raw token)؛ بل ارجع إلى متغير بيئة بدلاً من ذلك. النطاق المحلي (Local scope) هو الافتراضي وأكثر الأماكن أمانًا لاختبار خادم جديد قبل الالتزام بمشاركته. إذا كنت تقوم أيضًا بإنشاء Claude Code skills، فحافظ على اتساق نطاق الخادم ونطاق المهارة حتى يحصل زميلك الذي يسحب المستودع (repo) على إعدادات عمل.

كيف تضيف خادمًا باستخدام claude mcp add؟

النمط هو نفسه لكل خادم: اسم، وعلم نقل (transport flag) اختياري، والأمر أو عنوان URL. يفصل الفاصل -- بداية الأمر المحلي وحججه.

لإضافة خادم نظام ملفات محلي يقتصر على مجلد واحد حتى لا يتمكن الوكيل من الوصول إلا لما تسمح به:

claude mcp add filesystem -- \
  npx -y @modelcontextprotocol/server-filesystem ~/projects/my-app

لتمرير الأسرار كمتغيرات بيئة بدلاً من تضمينها بشكل ثابت (hardcoding):

claude mcp add my-api --env API_KEY=your_key_here -- node ./my-mcp-server.js

لإضافة خادم بعيد مع وسيلة النقل وعنوان URL الخاص به:

claude mcp add --transport sse linear https://mcp.linear.app/sse

بعد ذلك، يمكنك إدارة ما لديك:

  • claude mcp list يعرض كل خادم مسجل وحالته.
  • claude mcp get <name> يطبع إعدادات خادم واحد.
  • claude mcp remove <name> إلغاء تسجيله.
  • /mcp (يتم كتابته في الجلسة) يعرض حالة الاتصال المباشرة ويشغل OAuth.

حافظ على استخدام العلامات (flags) قريبًا من الوثائق الرسمية؛ فالبائعون يغيرون أحيانًا اسم حزمة الخادم أو عنوان URL الخاص به، لذا قم بنسخ القيمة الحالية من ملف README الخاص بالخادم بدلاً من التخمين.

خوادم MCP الشائعة التي تستحق الاتصال

ابدأ بخادم واحد يزيل مهمة روتينية حقيقية، واختبره أولاً، ثم أضف المزيد. هذه هي الخوادم التي يلجأ إليها المطورون أولاً، وما يفتحه كل منها.

Server ما يفتحه النقل المصدر
Filesystem Scoped read/write to folders you name stdio Official reference servers
GitHub Read issues, open and review PRs, search code HTTP (hosted) github/github-mcp-server
Playwright Drive a real browser, screenshot pages, test flows stdio microsoft/playwright-mcp
Postgres / database Inspect schema, run read-only queries stdio Community + reference servers
Sentry Pull stack traces and error context into the session HTTP Vendor-hosted

يُعد Playwright MCP server هو الأبرز للعمل على الواجهة الأمامية: حيث يقوم الوكيل بفتح صفحتك، والنقر عبر سير عمل معين، وتقديم تقرير بما تعطل مع لقطة شاشة. أما خادم قاعدة البيانات فهو مفيد لاستفسارات المخطط (schema) للقراءة فقط، ولكن يجب تحديد نطاقه ليصبح نسخة قراءة (read replica) حتى لا يتمكن أي استعلام عشوائي من الكتابة. عندما تبدأ في ربط عدة خوادم معًا، قم بتوجيه العمل الثقيل إلى عامل مخصص باستخدام Claude Code subagents لضمان بقاء الجلسة الرئيسية سريعة الاستجابة.

Rows of tower servers in a data center, representing remote MCP servers hosted by vendors

سيناريو: ربط خادم GitHub MCP لفتح طلبات السحب (PRs)

لنفترض أنك تريد من الوكيل (agent) فرز المشكلات وفتح طلبات سحب (pull requests) في مستودع واحد. يستضيف GitHub خادم MCP عن بُعد رسمي، لذلك لا تحتاج إلى تثبيت أي شيء محليًا.

  1. تسجيل الخادم المستضاف:

    claude mcp add --transport http github https://api.githubcopilot.com/mcp/

  2. اكتب /mcp في Claude Code، واختر github، وأكمل تسجيل الدخول عبر OAuth في متصفحك. يبقى الرمز (token) مع GitHub؛ ولن تقم أبدًا بلصقه في ملف.

  3. تأكيد الأدوات المحملة باستخدام claude mcp list.

  4. الآن اسأل باللغة العادية:

    • "قم بإدراج المشكلات المفتوحة التي تحمل تصنيف bug وقم بتلخيص أفضل ثلاثة منها."
    • "افتح طلب سحب (PR) مسودة من fix/login-redirect إلى main مع وصف قصير."
    • "اقرأ PR #214 وعلم أي شيء يمس المصادقة (authentication)."

يقرأ الوكيل سلاسل المشكلات، ويصوغ محتوى الـ PR، ويربط المشكلة الصحيحة، وكل ذلك دون أن تضطر لمغادرة الطرفية (terminal). امنح تطبيق GitHub إذن الوصول إلى مستودع واحد أولاً، وراجع ما يقترحه الوكيل، ولا توسّع نطاق الوصول إلا عندما تثق في سير العمل. يمكن توثيق قائمة الأدوات الكاملة للخادم وخيار الاستضافة الذاتية في GitHub MCP server repo.

هل من الآمن توصيل خادم MCP؟

يمكن لخادم MCP تشغيل التعليمات البرمجية على جهازك أو التصرف في حساباتك، لذا تعامل مع كل خادم وكأنه تثبيت تبعية (dependency): لا تقم بتوصيل سوى الخوادم التي تثق بها. الخطر حقيقي لأن خادماً ضاراً أو به أخطاء قد يقوم بتسريب الملفات أو اتخاذ إجراءات مدمرة باستخدام بيانات اعتمادك.

اتبع قائمة التحقق هذه قبل إضافة أي خادم:

  • تأكيد المصدر. يُفضل استخدام خوادم البائعين الرسمية (GitHub, Sentry) أو الخوادم المرجعية المنشورة بدلاً من الحزم غير المعروفة.
  • قراءة الأدوات التي يعرضها. لا ينبغي لخادم "قراءة مشاكلي" أن يطلب صلاحية الكتابة على القرص بالكامل الخاص بك.
  • تحديد النطاق بإحكام. وجّه خوادم نظام الملفات إلى مجلد مشروع واحد وخوادم قواعد البيانات إلى نسخة للقراءة (read replica).
  • إبقاء الأسرار خارج ملف .mcp.json. استخدم متغيرات البيئة ولا تقم أبداً بتضمين رمز (token) حقيقي.
  • منح أقل الامتيازات في OAuth. امنح تطبيق GitHub مستودعاً واحداً، وليس مؤسستك بالكامل، حتى تثق به.
  • مراجعة الإجراءات قبل الموافقة. اقرأ طلب السحب (PR) أو الاستعلام الذي يقترحه الوكيل؛ ولا توافق تلقائياً على عمليات الكتابة من خادم جديد.

تشير Anthropic إلى مخاطر حقن المطالبات (prompt-injection) للخوادم التي تسترد محتوى ويب غير موثوق، لذا كن حذراً للغاية مع أي خادم يسحب صفحات عشوائية. يمكن العثور على إرشادات الأمان الحالية في Claude Code MCP docs.

الكود على شاشة كمبيوتر داكنة، يمثل مراجعة الأدوات المعروضة لخادم MCP قبل الاتصال

استكشاف أخطاء اتصالات MCP وإصلاحها

معظم حالات الفشل تكون متعلقة بالإعدادات (config) أو المصادقة (auth)، وليست بالبروتوكول نفسه. اتبع هذه الخطوات بالترتيب:

  • الخادم غير مدرج (Server not listed): أعد تشغيل الأمر claude mcp list. إذا كان مفقودًا، فمن المحتمل أن يكون أمر add قد فشل؛ تحقق من وجود خطأ مطبعي في الفاصل -- أو اسم الحزمة.

  • الحالة تظهر فشلًا في /mcp: لم يتمكن النظام من بدء العملية. بالنسبة لخوادم stdio، قم بتشغيل الأمر الخام (مثل سطر npx) في الطرفية الخاصة بك لرؤية الخطأ الفعلي.

  • فشل المصادقة (Authentication failed): افتح /mcp، واختر الخادم، وأعد تنفيذ تدفق OAuth. بالنسبة للخوادم المعتمدة على الرموز المميزة (token-based)، تأكد من تعيين متغير البيئة في الـ shell الذي قام بتشغيل Claude Code.

  • عدم ظهور الأدوات (Tools not appearing): أعد تشغيل جلسة Claude Code حتى يقوم بإعادة تحميل قدرات الخادم، ثم تحقق من أن النطاق (scope) هو نطاق يمكن للمشروع الحالي رؤيته.

  • النطاق غير الصحيح (Wrong scope): الخادم المضاف باستخدام --scope local لن يظهر للزملاء؛ أعد إضافته باستخدام --scope project إذا كان يجب مشاركته.

عندما يغير خادم بعيد عنوان URL الخاص به أو يتم تغيير اسم حزمة ما، تصبح الإعدادات المحفوظة لديك قديمة (stale). اسحب القيمة الحالية من ملف README الخاص بالخادم وأعد إضافتها بدلاً من التحرير بشكل عشوائي.

الخلاصة الرئيسية

يحوّل MCP برنامج Claude Code من وكيل يعتمد على الملفات والـ shell إلى وكيل يتحدث مع أدواتك الحقيقية. أضف الخوادم باستخدام claude mcp add، واختر stdio للبيانات المحلية وHTTP/SSE للخدمات المستضافة، وحدد النطاق (scope) بمن يجب أن يرى الخادم. قم بتوصيل خادم مفيد واحد أولاً، وخادم GitHub هو بداية قوية، وتحقق من مصدر وأذونات كل خادم قبل أن تثق به. احتفظ بالرموز (tokens) في متغيرات البيئة، وقيّد الوصول إلى نظام الملفات وقاعدة البيانات بشكل ضيق، وراجع إجراءات الوكيل حتى يثبت الخادم الجديد جدارته.

استخدم الأدوات المجانية أثناء متابعة الدليل.

ضغط صورةإزالة خلفية

تابع القراءة