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

يتصل Windsurf Cascade بخوادم MCP عبر mcp_config.json. يعمل Fine Structure كخادم remote HTTP مع رمز.

Windsurf مناسب لسير عمل يساعد فيه Cascade على بناء الكود وتحريره. يمنح ربط Fine Structure عبر MCP لـ Cascade طريقة خاضعة للرقابة لفهم تطبيقاتكم والعمل عليها عبر أدوات المنصة.

ملف الإعداد: يستخدم Windsurf عادةً ~/.codeium/windsurf/mcp_config.json.

حقل URL: لخادم MCP بعيد استخدموا serverUrl أو url وفقًا لنسخة الإعداد، حيث يُعد serverUrl الخيار الآمن في التوثيق الحالي.

الأسرار: يمكن استخدام متغيرات البيئة إذا فضّل الفريق عدم حفظ الرمز مباشرة في الملف.

أنشئوا اتصالًا خاضعًا للرقابة

ابدأوا برمز app-scoped إذا كان Cascade يعمل على تطبيق واحد فقط. هذا يقلل المخاطر ويسهّل إدارة العملاء.

خطوات

• ادخلوا إلى حساب Fine Structure الخاص بكم.
• افتحوا صفحة MCP عبر زر Create MCP token في التوثيق، أو مباشرة عبر /mcp.
• اختاروا ما إذا كان الوكيل سيحصل على وصول إلى جميع التطبيقات المملوكة لكم أو إلى تطبيق واحد فقط.
• اختاروا الصلاحيات: Read only للفحص، Build للتحرير، Full access فقط للوكيل الذي تثقون به.
• اضغطوا Create MCP setup وانسخوا الرمز أو كتلة الإعداد. يُعرض الرمز مرة واحدة فقط.
• في Windsurf افتحوا Cascade ثم MCP settings أو View raw config.
• الصقوا الإعداد أدناه داخل mcpServers.
• احفظوا وأعيدوا تحديث خوادم MCP.
• اطلبوا من Cascade تشغيل فحص اتصال بسيط عبر get_platform_guide.

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

فحص السلامة: إذا لم يعرض Windsurf الخادم، فتأكدوا من أن الـ JSON صحيح، وأن الرمز يتضمن Bearer قبل القيمة، وأنه لا توجد فاصلة ناقصة بعد خادم سابق.