איך לחבר את 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 לפני הערך, ושאין פסיק חסר אחרי שרת קודם.