كيفية استخدام OpenAI Codex مع خادم 2Slides MCP (دليل 2026)

إجابة سريعة (≤60 كلمة): يستطيع OpenAI Codex إنتاج ملفات PowerPoint حقيقية بإضافة خادم 2Slides MCP إلى ~/.codex/config.toml. احصل على مفتاح من 2slides.com/api، ثم أضف كتلة [mcp_servers.2slides] تشغّل npx -y 2slides-mcp@latest (stdio) أو كتلة url = "https://2slides.com/api/mcp?apikey=KEY" (Streamable HTTP). أو شغّل codex mcp add 2slides --env API_KEY=xxx -- npx -y 2slides-mcp@latest. ثم اطلب من Codex بناء عرض تقديمي.

OpenAI Codex هو وكيل البرمجة عبر سطر الأوامر مفتوح المصدر من OpenAI، وهو عميل لبروتوكول سياق النموذج (MCP). اربطه بخادم 2Slides MCP ليصبح بإمكان Codex تحويل موجز — أو ملف في مستودعك — إلى ملف .pptx جاهز وقابل للتحرير، كل ذلك من الطرفية.

يمنحك هذا الدليل كتل config.toml الدقيقة لكلا الناقلين (stdio المحلي وStreamable HTTP عن بُعد)، واختصار codex mcp add المؤلّف من سطر واحد، وماذا تفعل كل أداة من أدوات 2Slides، والملاحظة الخاصة بالإصدار التي يجب الانتباه إليها مع خوادم HTTP.

لماذا تقرن Codex مع 2Slides؟

يستدلّ Codex حول الشيفرة والمحتوى؛ لكنه لا يخرج ملفات شرائح ثنائية بمفرده. خادم 2Slides MCP يسدّ تلك الفجوة. تقسيم العمل:

• Codex يقرأ مصدرك (مواصفات، README، ملف بيانات)، ويخطّط للشرائح، ويقرّر السرد.
• خادم 2Slides MCP يعرض ملف PowerPoint الفعلي — Fast PPT القائم على السمات، أو شرائح مصمّمة بالصور مع تعليق صوتي اختياري بالذكاء الاصطناعي وحزمة أصول قابلة للتصدير.

تطلب بالإنجليزية البسيطة؛ ويستدعي Codex الأدوات؛ ويعود رابط التنزيل.

ما الذي تحتاجه أولًا

1. تثبيت واجهة Codex CLI (codex ضمن متغيّر PATH لديك).
2. مفتاح API من 2Slides من 2slides.com/api — تحتوي تلك الصفحة أيضًا على إعداد MCP ونقطة نهاية Streamable HTTP.
3. Node.js لناقل stdio (الذي يشغّل npx -y 2slides-mcp@latest). أما ناقل HTTP فلا يحتاج إلى أي شيء محلي.

stdio مقابل Streamable HTTP: أي ناقل تختار؟

يقدّم خادم 2Slides MCP كليهما. الأدوات نفسها في كلتا الحالتين — والفرق هو في مكان تشغيل الموصِّل.

استخدم stdio على محطة عملك؛ واستخدم Streamable HTTP عندما يعمل Codex في مكان لا تستطيع تثبيت Node فيه.

الطريقة 1: stdio في config.toml

حرّر ~/.codex/config.toml وأضف:

تشمل الحقول الاختيارية التي يدعمها Codex لخوادم stdio: cwd وstartup_timeout_sec (الافتراضي 10 ثوانٍ) وtool_timeout_sec (الافتراضي 60 ثانية). إن كنت تفضّل تمرير متغيّر بيئة موجود بدلًا من إدراج المفتاح مباشرةً، فاستخدم env_vars = ["API_KEY"].

أو استخدم اختصار codex mcp add

لا حاجة لتحرير الملف — هذا يكتب الكتلة نيابةً عنك:

كل ما يأتي بعد -- هو أمر الخادم. شغّل codex mcp --help للحصول على قائمة الأوامر الفرعية الكاملة في الإصدار المثبّت لديك.

الطريقة 2: Streamable HTTP في config.toml

وجّه Codex إلى نقطة النهاية المستضافة:

إن كنت تفضّل مصادقة الترويسة على مفتاح في سلسلة الاستعلام، فإن Codex يدعم متغيّر بيئة لرمز bearer وترويسات ثابتة:

ملاحظة خاصة بالإصدار (مهمة): يوجّه Codex خوادم MCP عبر HTTP من خلال عميل MCP المكتوب بلغة Rust. تُعِدّ الإصدارات الحديثة هذا تلقائيًا، لكن بعض الإصدارات الأقدم تُظهر خطأ missing field command in mcp_servers إلى أن تفعّل العميل التجريبي. إن حدث ذلك معك، أضف:

تحقّق من codex --version أولًا — فالإصدارات الأحدث تدمج هذا، ويجري إعادة تسمية العلم إلى [features].rmcp_client. أظهر هذه الكتلة فقط كحل بديل إن اشتكى إصدارك.

تحقّق من الاتصال

أو، داخل واجهة Codex النصية (TUI)، شغّل /mcp لرؤية الخوادم النشطة وأدواتها. (لا تزال الأوامر الفرعية لإدارة codex mcp قيد التطوير؛ وcodex mcp --help هو المرجع المعتمد لإصدارك.)

أنشئ أول عرض تقديمي لك

لا تستدعي الأدوات يدويًا — بل تطلب:

يشغّل Codex أداة themes_search للعثور على themeId، ثم slides_generate (Fast PPT)، ويعيد downloadUrl — عرض PowerPoint حقيقي في نحو 30–60 ثانية. اطلب شرائح مصمّمة بالصور وسينتقل إلى slides_create_pdf_slides، مستطلِعًا jobs_get حتى يصبح الملف جاهزًا.

مجموعة أدوات 2Slides MCP

الأخطاء الشائعة وحلول المشكلات

• missing field command in mcp_servers على خادم HTTP. يحتاج إصدار Codex لديك إلى experimental_use_rmcp_client = true ضمن [features]. حدّث Codex، أو أضف العلم.
• ترويسات جداول TOML مقابل الجداول المضمّنة. [mcp_servers.2slides.env] جدول فرعي؛ إن أردت تضمينه، اكتب env = { API_KEY = "..." } على سطر الخادم — لا تخلط بين الأسلوبين.
• يجب أن يكون اسم الخادم فريدًا. يُفهرَس كل خادم بمقطع [mcp_servers.NAME]؛ وإعادة استخدام اسم تستبدل الكتلة السابقة.
• لا ملف .pptx دون الأداة. يستطيع Codex وحده صياغة مخطّط تفصيلي لكنه لا يستطيع إخراج عرض PowerPoint. أضف 2Slides أولًا.
• انتهاء مهلة الأدوات في العروض الكبيرة. قد تتجاوز المهام الكبيرة أو المعلّقة صوتيًا القيمة الافتراضية لـ tool_timeout_sec البالغة 60 ثانية؛ ارفعها، أو دع Codex يستطلع jobs_get للمهام غير المتزامنة.

الأسئلة الشائعة

هل يدعم OpenAI Codex خوادم MCP؟

نعم. Codex عميل MCP. تهيّئ الخوادم في ~/.codex/config.toml ضمن [mcp_servers.NAME]، أو تضيفها باستخدام codex mcp add. تُدعَم خوادم stdio وHTTP عن بُعد على حد سواء.

أين يخزّن Codex إعداد MCP؟

في ~/.codex/config.toml (عام). يمكن للمشاريع الموثوقة أيضًا استخدام ملف .codex/config.toml محلي للمشروع. كل خادم MCP هو جدول [mcp_servers.NAME].

stdio أم Streamable HTTP؟

يشغّل stdio الأمر npx -y 2slides-mcp@latest على جهازك وهو الخيار الافتراضي للعمل المحلي. أما Streamable HTTP فيوجّه إلى نقطة النهاية المستضافة https://2slides.com/api/mcp ولا يحتاج إلى أي تثبيت — وهو مثالي لـ CI والبيئات البعيدة. الأدوات نفسها، والمخرجات ذاتها.

هل ينتج عرض PowerPoint حقيقيًا؟

نعم — تعيد slides_generate ملف .pptx قابلًا للتحرير. أما أدوات Nano Banana فتعيد عروضًا مصمّمة بالصور ويمكنها إضافة تعليق صوتي بالذكاء الاصطناعي إضافة إلى حزمة أصول قابلة للتصدير.

من أين أحصل على المفتاح والإعداد؟

من 2slides.com/api?tab=mcp: مفتاح API الخاص بك، وإعداد جاهز للنسخ واللصق، وعنوان نقطة نهاية Streamable HTTP.

الخلاصة

أضف كتلة [mcp_servers.2slides] واحدة إلى config.toml (أو شغّل codex mcp add)، ويكتسب Codex أداة تحوّل أي موجز إلى عرض PowerPoint جاهز — دون مغادرة طرفيتك.

Codex وكيل استدلال قوي؛ و2Slides هو مولّد الملفات الذي كان ينقصه. للاطّلاع على الصورة الأكبر، راجع كيف يغيّر MCP سير عمل العروض التقديمية وخريطة منظومة خوادم PowerPoint MCP. تفضّل وكيل Anthropic؟ راجع كيفية استخدام Claude Code مع خادم 2Slides MCP.

احصل على مفتاحك والإعداد الدقيق من 2slides.com/api?tab=mcp وأطلق أول عرض تقديمي ينشئه Codex اليوم.

المصادر:

• OpenAI Codex — Model Context Protocol (official docs)
• OpenAI Codex — Configuration Reference
• 2Slides API & MCP server