איך לחבר את Fine Structure ל-Codex עם MCP

כך מחברים את Codex ל-Fine Structure כדי ש-Codex יוכל לקרוא, לערוך ולאמת אפליקציות דרך טוקן MCP מוגבל.

Codex מתאים במיוחד כשאתם רוצים סוכן שמבין קוד, יודע לעבוד בתוך פרויקט, ומסוגל להשתמש בכלים חיצוניים בצורה מבוקרת. אחרי חיבור MCP, Codex יכול להשתמש בכלי Fine Structure במקום לנחש איך האפליקציה בנויה.

החיבור משותף: ב-Codex, ה-CLI וה-IDE extension משתמשים באותה הגדרת MCP דרך config.toml.

הגדרה אחת: מוסיפים שרת בשם fine_structure, מצביעים אותו לכתובת https://finestructure.ai/api/mcp ומוסיפים Authorization.

שליטה בהרשאות: ההרשאות עדיין נקבעות בתוך Fine Structure בעמוד /mcp, לא בתוך Codex.

צרו טוקן לפני עריכת Codex

פתחו את עמוד MCP ב-Fine Structure, בחרו הרשאות, ואז העתיקו את הטוקן לתוך config.toml או למשתנה סביבה.

הדרך הכי פשוטה

• היכנסו לחשבון Fine Structure שלכם.
• פתחו את עמוד MCP דרך הכפתור Create MCP token בדוקס, או ישירות דרך /mcp.
• בחרו אם הסוכן יקבל גישה לכל האפליקציות שבבעלותכם או רק לאפליקציה אחת.
• בחרו הרשאות: Read only לבדיקה, Build לעריכה, Full access רק לסוכן שאתם סומכים עליו.
• לחצו Create MCP setup והעתיקו את הטוקן או את בלוק ההגדרה. הטוקן מוצג פעם אחת בלבד.
• פתחו את קובץ ההגדרות של Codex: בדרך כלל ~/.codex/config.toml.
• ב-Codex IDE extension אפשר לפתוח MCP settings ואז Open config.toml.
• הדביקו את הבלוק למטה והחליפו את הטוקן.
• פתחו מחדש את Codex או התחילו session חדש ובדקו את /mcp.

[mcp_servers.fine_structure]
url = "https://finestructure.ai/api/mcp"
http_headers = { "Authorization" = "Bearer fse2_mcp_<token>" }

[mcp_servers.fine_structure]
url = "https://finestructure.ai/api/mcp"
bearer_token_env_var = "FINE_STRUCTURE_MCP_TOKEN"

אחרי שהשרת מחובר

• בקשו מהסוכן: "Use the Fine Structure MCP and call get_platform_guide first."
• אם עובדים על אפליקציה קיימת, תנו גם את שם האפליקציה או app_id.
• לפני פרסום או שינוי גדול, בקשו מהסוכן להריץ validate_app ו-inspect_preview.
• אם החיבור נכשל, צרו טוקן חדש ב-/mcp ובטלו את הישן כדי לא להשאיר גישה פתוחה.

חשוב: אם אתם משתמשים במשתנה סביבה, הערך צריך להיות הטוקן עצמו בלבד, בלי המילה Bearer. Codex מוסיף את Authorization לפי הגדרת bearer_token_env_var.