كيفية ربط Fine Structure بـ VS Code و GitHub Copilot عبر MCP

يحفظ VS Code إعدادات MCP في ملف mcp.json، ويمكن تعريف الرمز كـ input سري بدلًا من كتابته بشكل ظاهر.

إذا كنتم تعملون مع VS Code و GitHub Copilot Agent Mode، فيمكنكم ربط Fine Structure كخادم MCP بعيد. بهذا يحصل Copilot على وصول إلى أدوات Fine Structure دون أن تنسخوا الملفات أو المخططات أو سجل الأخطاء يدويًا.

أين تضعون الملف: يمكن استخدام .vscode/mcp.json لـ workspace معين أو إعداد User MCP لكامل الجهاز.

حفظ الرمز: يدعم VS Code الـ input variables، بحيث يمكن حفظ الرمز كسري دون أن يظهر في الملف.

التحقق من الاتصال: عبر Command Palette يمكن تشغيل MCP: List Servers أو فتح إعداد MCP.

ابدأوا في Fine Structure

أنشئوا رمز MCP ثم عودوا إلى VS Code. إذا لم تكونوا متأكدين، فاختاروا Read only لفحص الاتصال قبل التحرير.

خطوات

• ادخلوا إلى حساب Fine Structure الخاص بكم.
• افتحوا صفحة MCP عبر زر Create MCP token في التوثيق، أو مباشرة عبر /mcp.
• اختاروا ما إذا كان الوكيل سيحصل على وصول إلى جميع التطبيقات المملوكة لكم أو إلى تطبيق واحد فقط.
• اختاروا الصلاحيات: Read only للفحص، Build للتحرير، Full access فقط للوكيل الذي تثقون به.
• اضغطوا Create MCP setup وانسخوا الرمز أو كتلة الإعداد. يُعرض الرمز مرة واحدة فقط.
• في VS Code افتحوا Command Palette وابحثوا عن MCP: Open Workspace Folder MCP Configuration أو MCP: Open User Configuration.
• الصقوا الإعداد أدناه.
• عندما يطلب VS Code رمز Fine Structure MCP، الصقوا الرمز دون مشاركته مع الآخرين.
• شغّلوا MCP: List Servers وتأكدوا من أن خادم fineStructure نشط.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "fineStructureToken",
      "description": "Fine Structure MCP token",
      "password": true
    }
  ],
  "servers": {
    "fineStructure": {
      "type": "http",
      "url": "https://finestructure.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:fineStructureToken}"
      }
    }
  }
}

لماذا هذا جيد: يساعدكم الـ input السري على عدم حفظ الرموز داخل Git. هذا مهم بشكل خاص في الفرق أو في مشاريع العملاء.