كيفية ربط 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.