كيفية ربط Fine Structure بـ Claude Code عبر MCP

دليل للأشخاص غير التقنيين الذين يرغبون في السماح لـ Claude Code ببناء تطبيقات Fine Structure واختبارها وتحسينها عبر MCP.

يمكن لـ Claude Code أن يعمل مع Fine Structure كأنه عضو في الفريق يعرف النظام: فهو قادر على قراءة بنية التطبيق، وفهم الملفات، واقتراح تعديل، وتشغيل اختبارات على مستوى النظام، وطلب النشر فقط عند توفر الصلاحية المناسبة. يتم الاتصال عبر MCP، أي عبر رمز خاضع للرقابة وليس كلمة مرور شخصية.

ما الذي يمنحكم إياه هذا: يمكنكم أن تطلبوا من Claude Code بناء شاشة جديدة، أو إصلاح خطأ، أو فحص نسخة قبل النشر، أو إعداد تعديل لعميل دون نسخ ملفات من النظام يدويًا.

لمن هذا مناسب: لأصحاب الأعمال والوكالات ومديري المنتجات الذين يريدون أن يعمل وكيل ذكاء اصطناعي على المنتج ضمن حدود واضحة.

ما مدى أمان هذا: الرمز مقيّد بحسب التطبيق والصلاحيات. يمكنكم إنشاء Read only للفحص، أو Build للعمل، أو Full access فقط عند الثقة بالوكيل.

الخطوة الأولى: إنشاء رمز MCP

افتحوا صفحة MCP، وأنشئوا رمزًا جديدًا وانسخوا القيمة التي تبدأ بـ fse2_mcp_. بدون الرمز لا يستطيع Claude Code الوصول إلى حساب Fine Structure الخاص بكم.

خطوات بسيطة

• ادخلوا إلى حساب Fine Structure الخاص بكم.
• افتحوا صفحة MCP عبر زر Create MCP token في التوثيق، أو مباشرة عبر /mcp.
• اختاروا ما إذا كان الوكيل سيحصل على وصول إلى جميع التطبيقات المملوكة لكم أو إلى تطبيق واحد فقط.
• اختاروا الصلاحيات: Read only للفحص، Build للتحرير، Full access فقط للوكيل الذي تثقون به.
• اضغطوا Create MCP setup وانسخوا الرمز أو كتلة الإعداد. يُعرض الرمز مرة واحدة فقط.
• افتحوا Terminal في مجلد المشروع الذي تعملون فيه مع Claude Code.
• الصقوا الأمر أدناه واستبدلوا fse2_mcp_<token> برمزكم.
• افتحوا Claude Code واكتبوا /mcp للتأكد من أن خادم fine-structure متصل.

claude mcp add --transport http fine-structure https://finestructure.ai/api/mcp --header "Authorization: Bearer fse2_mcp_<token>"

{
  "mcpServers": {
    "fine-structure": {
      "type": "http",
      "url": "https://finestructure.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer fse2_mcp_<token>"
      }
    }
  }
}

ماذا تقولون لـ Claude بعد الاتصال

• اطلبوا من الوكيل: "Use the Fine Structure MCP and call get_platform_guide first."
• إذا كنتم تعملون على تطبيق قائم، فأعطوا أيضًا اسم التطبيق أو app_id.
• قبل النشر أو إجراء تغيير كبير، اطلبوا من الوكيل تشغيل validate_app و inspect_preview.
• إذا فشل الاتصال، فأنشئوا رمزًا جديدًا في /mcp وألغوا القديم حتى لا يبقى وصول مفتوح.

نصيحة تسويقية داخلية: إذا كنتم وكالة، فأنشئوا رمزًا مقفلًا على تطبيق واحد لكل عميل. بهذا يحصل Claude Code على المشروع المعني بالضبط وليس على الحساب بأكمله.