ركّب MCP بنفسك

الهدف

تركّب خادم MCP في كلود كود (محلي وبعيد)، تتحقق من اشتغاله، وتستخدم أدواته في مهمة حقيقية، مع ضبط الصلاحيات.

الشرح

الطريقة ١: في كلود كود (الطرفية)

خادم بعيد (HTTP): مثال نوشن:

claude mcp add --transport http notion https://mcp.notion.com/mcp

خادم محلي (stdio): مثال خادم يشغَّل بـ npx:

claude mcp add --transport stdio my-tool -- npx -y اسم-الحزمة

عرض الخوادم المركّبة:

claude mcp list

داخل الجلسة: اكتب /mcp لترى حالة كل خادم وتسجّل الدخول إن لزم.

الطريقة ٢: في تطبيق كلود

الإعدادات ← الموصّلات ← «إضافة موصّل مخصّص» والصق رابط خادم MCP البعيد. بعدها يظهر في قائمة الأدوات عند زر (+) في أي محادثة.

النطاقات (Scopes) في كلود كود

• محلي: لك فقط في هذا المشروع (الافتراضي).
• مشروع: يُحفظ في ملف .mcp.json في جذر المشروع ويُشارك مع الفريق عبر Git.
• مستخدم: متاح لك في كل مشاريعك.

الاستخدام

بعد الربط، تطلب بلغتك العادية وكلود يختار الأداة المناسبة:

أنت: اقرأ آخر ٢٠ طلبًا من المتجر، وسوّ لي تقريرًا بالطلبات المتأخرة عن موعد الشحن مع مدينة كل طلب.
كلود كود: [يستدعي أداة «قائمة الطلبات» من خادم المتجر، يحلّل، ويكتب التقرير]

قبل أي أداة «تنفّذ» (إنشاء/تعديل/حذف) يستأذنك، وتقدر تسمح لمرة أو دائمًا.

المصادقة

الخوادم البعيدة تحتاج تسجيل دخول (OAuth) أول مرة، والمحلية تحتاج مفتاح API في متغير بيئة. لا تكتب المفتاح في الأمر نفسه إذا كان المشروع مشتركًا؛ استخدم ملف .env أو متغيرات النظام (الدرس ١١).

التحقق

اطلب: «اعرض لي الأدوات المتاحة من خادم [الاسم]» ثم جرّب أداة قراءة بسيطة قبل أي أداة تنفيذ.

خطوة بخطوة

1. اختر خدمة واحدة (نوشن، GitHub، قوقل درايف، أو خادم متجرك).
2. أضفها بـ claude mcp add أو من إعدادات التطبيق.
3. /mcp وسجّل الدخول.
4. اطلب قراءة بسيطة ثم مهمة حقيقية.
5. اضبط الصلاحيات: اسمح للقراءة دائمًا، وللتنفيذ بالطلب.

برومبتات جاهزة

اعرض لي الأدوات المتاحة من خادم [الاسم] مع وصف كل أداة في سطر. ثم نفّذ أداة قراءة واحدة بسيطة كتجربة وأعطني النتيجة. لا تنفّذ أي أداة كتابة أو حذف.

باستخدام خادم [الاسم]: اقرأ [البيانات]، حلّلها، واكتب تقريرًا بـ[المحتوى]. إذا احتجت أداة تنفيذ (إنشاء/تعديل)، اعرض عليّ قبل التنفيذ.

أخطاء شائعة

• إضافة ٥ خوادم مرة واحدة: واحد، وافهمه.
• المفاتيح في الأوامر أو في Git.
• السماح الدائم لأدوات الحذف.

تمرين

ركّب خادمًا واحدًا (نوشن أو GitHub أو قوقل درايف). اطلب عرض الأدوات، ثم نفّذ مهمة قراءة وتقرير حقيقية. سجّل: كم أداة يعرض؟ وأيها تحتاج إذنًا؟

الخلاصة

claude mcp add يربط أي خادم، و/mcp يتحقق، والنطاقات تحدد المشاركة. قراءة أولًا، تنفيذ بالطلب، مفاتيح في .env، ومصادر موثوقة.