2Slides Team
5 min read
كيفية استخدام Gemini CLI مع خادم 2Slides MCP (دليل 2026)
إجابة سريعة (≤60 كلمة): يستطيع Gemini CLI من Google إنشاء ملفات PowerPoint حقيقية عبر خادم 2Slides MCP. احصل على مفتاح من 2slides.com/api، ثم أضف مدخل
mcpServersإلى~/.gemini/settings.json—command: "npx"،args: ["2slides-mcp"]،env.API_KEYلـ stdio، أوhttpUrl: "https://2slides.com/api/mcp?apikey=KEY"لـ Streamable HTTP. أو شغّلgemini mcp add. ثم اطلب من Gemini بناء عرض تقديمي.
Gemini CLI هو وكيل الذكاء الاصطناعي عبر الطرفية مفتوح المصدر من Google، وهو يتحدث بروتوكول سياق النموذج (MCP). اربطه بخادم 2Slides MCP ليصبح بإمكان Gemini تحويل موجَّه — أو ملف في مجلّد عملك — إلى ملف .pptx جاهز وقابل للتحرير.
يمنحك هذا الدليل كتل settings.json الدقيقة لكلا الناقلين (stdio المحلي وStreamable HTTP عن بُعد)، واختصار gemini mcp add، وماذا تفعل كل أداة من أدوات 2Slides.
لماذا تربط Gemini CLI بـ 2Slides؟
Gemini مستدِلّ متعدّد الوسائط قوي، لكنه لا يخرج ملفات .pptx ثنائية بمفرده. خادم 2Slides MCP هو المولّد المخصّص:
- Gemini CLI يقرأ مصدرك، ويخطّط للشرائح، ويكتب النص.
- خادم 2Slides MCP يعرض ملف PowerPoint الحقيقي — Fast PPT القائم على السمات، أو شرائح مصمّمة بالصور مع تعليق صوتي اختياري بالذكاء الاصطناعي وحزمة قابلة للتصدير.
ما الذي تحتاجه أولًا
- تثبيت Gemini CLI (
geminiضمن متغيّر PATH لديك). - مفتاح API من 2Slides من 2slides.com/api.
- Node.js لناقل stdio (
npx -y 2slides-mcp@latest). أما ناقل HTTP فلا يحتاج إلى أي شيء محلي.
stdio مقابل Streamable HTTP: أي ناقل تختار؟
كلاهما يعرض الأدوات نفسها؛ والفرق هو مفتاح الإعداد ومكان تشغيل الموصِّل.
| Stdio (محلي) | Streamable HTTP (عن بُعد) | |
|---|---|---|
| مفتاح الإعداد | command / args / env | httpUrl |
| Node.js محلي | مطلوب | غير مطلوب |
| الأنسب لـ | التطوير المحلي | البعيد/CI، الإعدادات الخفيفة |
اسم المفتاح مهم: يستخدم Gemini CLI
httpUrlلـ Streamable HTTP و**url** لـ SSE القديم. بالنسبة لنقطة نهاية Streamable HTTP الخاصة بـ 2Slides، استخدمhttpUrl.
الطريقة 1: stdio في settings.json
يقرأ Gemini CLI الملف ~/.gemini/settings.json (عام) و.gemini/settings.json (للمشروع). أضف كتلة mcpServers:
{
"mcpServers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
}
}
}يمكن أيضًا أن تشير قيم env إلى متغيّرات الصدفة (مثل "API_KEY": "$TWOSLIDES_API_KEY") إن كنت تفضّل عدم إدراج المفتاح مباشرةً.
الطريقة 2: Streamable HTTP في settings.json
لنقطة النهاية المستضافة، استخدم httpUrl:
{
"mcpServers": {
"2slides-remote": {
"httpUrl": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
}
}
}تفضّل مصادقة الترويسة؟ أضف كائن headers: "headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }.
أو استخدم أمر gemini mcp add
# stdio (-e sets env vars)
gemini mcp add -e API_KEY=YOUR_2SLIDES_API_KEY 2slides npx -y 2slides-mcp@latest
# Streamable HTTP
gemini mcp add --transport http 2slides-remote "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"تكتب هذه المداخل نفسها في mcpServers ضمن settings.json. تشمل الأعلام -t, --transport (stdio | sse | http)، و-e, --env، و-H, --header، و--timeout.
تحقّق من الاتصال
داخل جلسة gemini تفاعلية، شغّل:
/mcpيعرض حالة كل خادم (CONNECTED / CONNECTING / DISCONNECTED) والأدوات المكتشفة. استخدم /mcp auth إن كان خادم بعيد يتطلّب OAuth.
أنشئ أول عرض تقديمي لك
فقط اطلب:
Read ./notes/market-update.md and generate a 9-slide briefing.
Find a professional theme from 2slides, build the PowerPoint,
and give me the download link.يشغّل Gemini CLI themes_search ← slides_generate (Fast PPT) ← ويعيد downloadUrl. وللحصول على شرائح مخصّصة مصمّمة بالصور يستخدم slides_create_pdf_slides ويستطلع jobs_get حتى يصبح العرض جاهزًا.
مجموعة أدوات 2Slides MCP
| الأداة | ماذا تفعل | الأرصدة |
|---|---|---|
themes_search | العثور على themeId لـ Fast PPT | مجانًا |
slides_generate | عرض PowerPoint قائم على السمات (Fast PPT)، متزامن/غير متزامن | 10 / صفحة |
slides_create_pdf_slides | شرائح مخصّصة مصمّمة بالصور من نص (Nano Banana) | 100 / صفحة (1K/2K), 200 (4K) |
slides_create_like_this | شرائح تطابق أسلوب صورة مرجعية | 100 / صفحة (1K/2K), 200 (4K) |
slides_generate_narration | إضافة تعليق صوتي بالذكاء الاصطناعي إلى مهمة Nano Banana | 210 / صفحة |
slides_download_slides_pages_voices | تصدير الصفحات + الصوت كملف ZIP | مجانًا |
jobs_get | استطلاع مهمة غير متزامنة حتى اكتمالها | مجانًا |
الأخطاء الشائعة وحلول المشكلات
- استخدام
urlلنقطة نهاية Streamable HTTP. يعامل Gemini CLI الحقلurlعلى أنه SSE. استخدمhttpUrlلـ Streamable HTTP الخاص بـ 2Slides. - يظهر الخادم بحالة DISCONNECTED في
/mcp. تحقّق من مفتاح API، وبالنسبة لـ stdio تأكّد من تثبيت Node.js. - لا تظهر أي أدوات. أعد تشغيل الجلسة بعد تحرير
settings.json، أو أعد تشغيلgemini mcp add. - لا ملف
.pptxدون الأداة. يصوغ Gemini وحده مخطّطًا تفصيليًا؛ و2Slides ينتج الملف. - الاستطلاع المحكم. دع Gemini يستطلع
jobs_getكل نحو 20 ثانية لمهام Nano Banana / التعليق الصوتي غير المتزامنة.
الأسئلة الشائعة
هل يدعم Gemini CLI خوادم MCP؟
نعم. Gemini CLI عميل MCP. هيّئ الخوادم تحت mcpServers في ~/.gemini/settings.json، أو أضفها باستخدام gemini mcp add. تُدعَم نواقل stdio وSSE وStreamable HTTP جميعها.
ما مفتاح إعداد خادم Streamable HTTP؟
httpUrl. استخدم url فقط لخوادم SSE القديمة. تُوضَع نقطة نهاية Streamable HTTP الخاصة بـ 2Slides في httpUrl.
أين يخزّن Gemini CLI إعداد MCP؟
في ~/.gemini/settings.json (عام) أو .gemini/settings.json (للمشروع). كتلة MCP هي المفتاح العلوي mcpServers.
هل ينتج عرض PowerPoint حقيقيًا؟
نعم — تعيد slides_generate ملف .pptx قابلًا للتحرير. أما أدوات Nano Banana فتعيد عروضًا مصمّمة بالصور مع تعليق صوتي اختياري بالذكاء الاصطناعي.
من أين أحصل على المفتاح والإعداد؟
من 2slides.com/api?tab=mcp: مفتاحك، وإعداد جاهز للنسخ واللصق، وعنوان نقطة نهاية Streamable HTTP.
الخلاصة
مدخل
mcpServersواحد —commandللمحلي، وhttpUrlللبعيد — يحوّل Gemini CLI إلى مولّد شرائح. تحقّق عبر/mcp، ثم فقط اطلب عرضًا تقديميًا.
للاطّلاع على الصورة الأوسع، راجع كيف يغيّر MCP سير عمل العروض التقديمية وخريطة منظومة خوادم PowerPoint MCP. تعمل في وكيل طرفية آخر؟ راجع Claude Code وOpenAI Codex وQwen Code مع الخادم نفسه.
احصل على مفتاحك وإعدادك من 2slides.com/api?tab=mcp وأنشئ أول عرض تقديمي لك من Gemini CLI في أقل من دقيقة.
المصادر:
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
