MCP servers

لحد دلوقتي Claude شايف الملفات اللي في المشروع، والترمينال، والويب. بس إيه رأيك لو عايزه يشوف الـ tables في Neon، أو آخر إيرور في Sentry، أو الـ issue في GitHub، أو يفتح المتجر في متصفح ويجرّب الـ checkout؟

MCP طريقة موحدة توصّل بيها Claude بأي خدمة برا المشروع. كل خدمة بتعمل MCP server، و Claude بيستخدم الأدوات اللي الـ server بيعرضها.

الـ Stripe plugin في فصل ١٢ كان في الحقيقة MCP server ملفوف في plugin. هنا هنضيف MCP server بنفسنا.

MCP ولا skill؟

وكتير بيشتغلوا مع بعض: MCP server بيدّي الوصول، و skill بتقول الطريقة الصح لاستخدامه.

تضيف MCP server إزاي

فيه نوعين مشهورين:

# server ريموت على الإنترنت (HTTP)claude mcp add --transport http <name> <url># server بيشتغل على جهازك كـ process (stdio)# مثلًا Playwright عشان Claude يفتح متصفح ويجرّب الصفحاتclaude mcp add playwright -- npx @playwright/mcp@latest# تشوف اللي متضافclaude mcp list

وجوه Claude، /mcp بيوريك الـ servers شغالة ولا لأ، ومنه بتعمل login للـ servers اللي محتاجة OAuth.

الـ URL والأمر بتاع كل خدمة موجودين في الـ docs بتاعتها. والـ flags نفسها بتتغير، فراجع docs بتاعة Claude Code.

متضاف لمين؟ الـ scope

• local (الافتراضي): ليك إنت بس، على المشروع ده.
• project: بيتكتب في ملف .mcp.json في الـ root، وبيتعمله commit، فكل الفريق بياخده. بتضيفه بـ --scope project.
• user: ليك إنت في كل مشاريعك.

{  "mcpServers": {    "playwright": {      "command": "npx",      "args": ["@playwright/mcp@latest"]    }  }}

ومتحطش أي token أو API key جوه .mcp.json لأنه بيتعمله commit. الـ OAuth بيتعمل من /mcp، والمفاتيح بتتقرا من الـ environment variables. راجع الـ docs لطريقة كتابتها.

مثال من المتجر

مع Playwright MCP تقدر تقول: “افتح localhost:3000، ضيف الشنطة للـ cart، كمّل لحد الـ checkout، وقولي فيه حاجة شكلها غلط على موبايل 390px”. Claude بيفتح المتصفح فعلًا، ويدوس، ويعمل screenshots، ويرجعلك باللي لقاه. ده بيخلي خطوة “اتأكد من شغلك” حقيقية في الـ UI، مش بس pnpm build.

خلّي بالك

لو عايز تفهم البروتوكول نفسه من جوه، أو تبني MCP server بإيدك، فيه موضوع MCP كامل في المذكرات.

خلّصت الفصل لما

• تفرق بين الـ skill (طريقة) والـ MCP server (وصول)
• تضيف server بـ claude mcp add وتشوفه من /mcp
• تعرف الفرق بين scope الـ local والـ project والـ user
• متحطش tokens في .mcp.json
• تقفل الـ servers اللي مش مستخدمها عشان الـ context