2Slides Logo
كيفية استخدام Claude Code مع خادم 2Slides MCP (دليل 2026)
2Slides Team
8 min read

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

إجابة سريعة (≤60 كلمة): يستطيع Claude Code إنشاء ملفات PowerPoint حقيقية عبر الاتصال بخادم 2Slides MCP. احصل على مفتاح API من 2slides.com/api، ثم شغّل

claude mcp add --env API_KEY=xxx --transport stdio 2slides -- npx 2slides-mcp
لناقل stdio المحلي، أو
claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=KEY
لناقل Streamable HTTP عن بُعد. ثم اطلب من Claude Code بناء عرض تقديمي.

Claude Code هو وكيل البرمجة من Anthropic القائم على الطرفية، وهو يتحدث بروتوكول سياق النموذج (MCP) بشكل أصيل. يعني ذلك أنه بإمكانك منحه أداة تحوّل النص إلى ملف

.pptx
جاهز دون مغادرة الصدفة (shell) أبدًا. خادم 2Slides MCP هو تلك الأداة: موصِّل بسيط يعرض واجهات 2Slides البرمجية الخاصة بإنشاء الشرائح والتنسيق والتعليق الصوتي والتصدير كأدوات MCP يستطيع Claude Code استدعاءها مباشرةً.

يوضّح لك هذا الدليل طريقتَي الاتصال — stdio المحلي وStreamable HTTP عن بُعد — وأيّهما تختار، وماذا تفعل كل أداة، والأوامر الدقيقة التي تحوّل طلبًا من سطر واحد إلى عرض PowerPoint قابل للتنزيل.

لماذا تربط Claude Code بـ 2Slides أصلًا؟

يتميّز Claude Code بقدرته على الاستدلال حول مستودعك، وصياغة المحتوى، وبناء حجة منطقية. لكن ما لا يستطيع فعله بمفرده هو إخراج ملف

.pptx
حقيقي قابل للتحرير يحتوي على أشكال ورسوم بيانية وسمات وملاحظات للمتحدّث. هذه مشكلة تتعلّق بإنشاء الملفات، وهي من اختصاص أداة مخصّصة.

التقسيم واضح:

  • Claude Code يقرأ مادتك المصدرية (ملف README، مواصفات، ملف CSV، ملاحظة بحثية)، ويستدلّ حولها، ويقرّر ما الذي يظهر في كل شريحة.
  • خادم 2Slides MCP يأخذ تلك الخطة ويعرض ملف PowerPoint فعليًا — أو شرائح قائمة على الصور مع تعليق صوتي بالذكاء الاصطناعي وتصدير بصيغة MP4.

تبقى داخل الطرفية طوال الوقت. اطلب، وانتظر نحو 30–60 ثانية، واحصل على رابط التنزيل.

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

  1. تثبيت Claude Code والمصادقة عليه (
    claude
    ضمن متغيّر PATH لديك).
  2. مفتاح API من 2Slides. أنشئ واحدًا من 2slides.com/api. تحتوي الصفحة نفسها على إعداد MCP جاهز للنسخ واللصق ونقطة نهاية Streamable HTTP.
  3. Node.js (لناقل stdio الذي يشغّل
    npx 2slides-mcp
    محليًا). أما ناقل HTTP فلا يحتاج إلى أي شيء محلي على الإطلاق.

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

يدعم خادم 2Slides MCP ناقلين. كلاهما يعرض مجموعة الأدوات نفسها تمامًا؛ ولا يختلفان إلا في مكان تشغيل الموصِّل.

بروتوكول Stdioبروتوكول Streamable HTTP
مكان التشغيلمحليًا، عبر
npx 2slides-mcp
عن بُعد، مستضاف من 2Slides
يتطلّب Node.js محليًانعملا
الإعدادإضافة خادم stdio + متغيّر بيئة
API_KEY
إضافة عنوان URL واحد مع
?apikey=
الأنسب لـالتطوير المحلي، ملائم للعمل دون اتصال، تحكّم كاملالحاويات، التكامل المستمر (CI)، العملاء خفيفو الوزن، دون اعتماديات محلية
المصادقةمتغيّر البيئة
API_KEY
مفتاح API في استعلام العنوان (أو ترويسة
Authorization
)

قاعدة عامة: استخدم stdio على جهازك للعمل اليومي، وStreamable HTTP عندما يعمل Claude Code في مكان لا يمكنك تثبيت Node فيه (خادم بعيد، مهمة CI، حاوية مقيّدة).

الطريقة 1: الاتصال عبر stdio (محلي)

شغّل هذا مرة واحدة. الفاصل

--
يفصل أعلام Claude Code الخاصة عن الأمر الذي يشغّله:

claude mcp add --env API_KEY=YOUR_2SLIDES_API_KEY --transport stdio 2slides -- npx 2slides-mcp

بضعة أمور يجدر معرفتها:

  • أبقِ
    --transport stdio
    (أو علمًا آخر) بين
    --env
    واسم الخادم. وبما أن
    --env
    يقبل عدة أزواج
    KEY=value
    ، فإن وضع الاسم مباشرةً بعده قد يجعل واجهة سطر الأوامر تقرأ الاسم كمتغيّر بيئة آخر.
  • كل ما يأتي بعد
    --
    يُمرَّر إلى الخادم دون تغيير (
    npx 2slides-mcp
    ).
  • أضف
    --scope user
    لإتاحة 2Slides في كل مشروع، أو
    --scope project
    لإيداعه في ملف
    .mcp.json
    مشترك لفريقك.

يبدو ملف

.mcp.json
الناتج (على نطاق المشروع) كالتالي — ويمكنك أيضًا تحريره يدويًا:

{ "mcpServers": { "2slides": { "command": "npx", "args": ["2slides-mcp"], "env": { "API_KEY": "YOUR_2SLIDES_API_KEY" } } } }

الطريقة 2: الاتصال عبر Streamable HTTP (عن بُعد)

لا تثبيت محلي — فقط وجّه Claude Code إلى نقطة النهاية المستضافة:

claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY

تفضّل إبقاء المفتاح خارج عنوان URL؟ أرسله كترويسة بدلًا من ذلك:

claude mcp add --transport http 2slides https://2slides.com/api/mcp \ --header "Authorization: Bearer YOUR_2SLIDES_API_KEY"

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

claude mcp list # يجب أن يظهر 2slides ويتصل claude mcp get 2slides # يعرض إعداده والأدوات المكتشفة

أو، داخل جلسة تفاعلية، شغّل أمر الشرطة المائلة

/mcp
لرؤية الخوادم المتصلة، وأعداد الأدوات، و(بالنسبة للخوادم البعيدة) حالة المصادقة.

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

بمجرد الاتصال، لن تستدعي الأدوات يدويًا — بل تطلب فحسب. يربط Claude Code أدوات 2Slides تلقائيًا:

Search the 2slides themes for a clean "business" style, then generate a 7-slide deck introducing our Q3 roadmap. Pull the content from ./ROADMAP.md. Return the download link.

خلف الكواليس، يشغّل Claude Code أداة

themes_search
للعثور على
themeId
، ثم
slides_generate
(Fast PPT) ويسلّمك
downloadUrl
. الوقت الإجمالي: نحو 30–60 ثانية لعرض PowerPoint منسّق.

تريد شرائح مخصّصة مصمّمة بالصور بدلًا من قالب؟ اطلب ذلك وسيستخدم Claude Code مسار Nano Banana (

slides_create_pdf_slides
)، ويستطلع
jobs_get
حتى يصبح جاهزًا، ثم يعيد الرابط.

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

يرى Claude Code هذه الأدوات بمجرد الاتصال:

الأداةماذا تفعلالأرصدة
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 Banana210 / صفحة
slides_download_pages_voices
تصدير الصفحات + الصوت كملف ZIPمجانًا
jobs_get
استطلاع مهمة غير متزامنة حتى
success
مجانًا

ثلاث سلاسل نموذجية:

  • Fast PPT:
    themes_search
    slides_generate
    (متزامن) ← تنزيل.
  • Nano Banana:
    slides_create_pdf_slides
    (غير متزامن) ←
    jobs_get
    ← تنزيل.
  • أصول فيديو معلّقة صوتيًا: إنشاء الشرائح ←
    jobs_get
    slides_generate_narration
    jobs_get
    slides_download_pages_voices
    .

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

  • لا يظهر الخادم في
    claude mcp list
    .
    بالنسبة لـ stdio، تحقّق من صحة ترتيب
    --env
    /الاسم (أبقِ علمًا بين
    --env
    والاسم). بالنسبة لـ HTTP، أعد التحقّق من عنوان URL ومن صلاحية مفتاح API.
  • API_KEY
    مفقود.
    يحتاج خادم stdio إلى متغيّر البيئة؛ ويحتاج خادم HTTP إلى
    ?apikey=
    أو ترويسة
    Authorization
    . لا تخلط بينهما.
  • طلب ملف
    .pptx
    دون الأداة.
    بدون اتصال 2Slides، يستطيع Claude Code كتابة مخطّط تفصيلي لكنه لا يستطيع إخراج عرض PowerPoint حقيقي. اربط الخادم أولًا.
  • نسيان السمة. إن لم تشغّل
    themes_search
    أو تذكر أسلوبًا، يختار Fast PPT سمةً نيابةً عنك. حدّدها للتحكّم في المظهر.
  • الاستطلاع بسرعة مفرطة. يجب استطلاع المهام غير المتزامنة (Nano Banana، التعليق الصوتي) باستخدام
    jobs_get
    كل نحو 20 ثانية، وليس في حلقة محكمة.

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

هل يدعم Claude Code خوادم MCP بشكل أصيل؟

نعم. Claude Code عميل MCP من الدرجة الأولى. تضيف الخوادم باستخدام

claude mcp add
(نواقل stdio أو SSE أو HTTP)، وتسردها باستخدام
claude mcp list
، وتفحصها داخل الجلسة عبر
/mcp
. يعمل خادم 2Slides مع كل هذه.

stdio أم Streamable HTTP — أيّهما يجب أن أستخدم؟

استخدم stdio على جهازك المحلي (فهو يشغّل

npx 2slides-mcp
نيابةً عنك)، وStreamable HTTP في أي مكان لا تستطيع أو لا ترغب في تثبيت Node فيه — CI، الحاويات، الخوادم البعيدة. كلاهما يعرض الأدوات نفسها وينتج المخرجات ذاتها.

هل ينتج هذا ملف PowerPoint حقيقيًا؟

نعم. مسار Fast PPT (

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

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

من 2slides.com/api?tab=mcp. تعرض تلك الصفحة مفتاحك، وإعداد stdio جاهزًا للصق، وعنوان نقطة نهاية Streamable HTTP.

هل يمكنني مشاركة خادم 2Slides مع فريقي؟

نعم. أضفه باستخدام

--scope project
لكتابة ملف
.mcp.json
مشترك تودِعه في المستودع. يُطلب من زملائك الموافقة عليه عند أول استخدام. استخدم
--scope user
لإعداد خاص يشمل كل المشاريع.

الخلاصة

Claude Code يقوم بالتفكير؛ وخادم 2Slides MCP يصنع الملف. اربط مرة واحدة — stdio للمحلي، وStreamable HTTP للبعيد — وتصبح عبارة "اصنع لي عرضًا تقديميًا" جملةً واحدة في طرفيتك.

إن كنت تعيش داخل Claude Code، فهذا هو أسرع مسار من فكرة (أو ملف في مستودعك) إلى عرض PowerPoint جاهز وقابل للتحرير. للاطّلاع على نظرة أوسع حول ربط الشرائح بالوكلاء، راجع كيف يغيّر MCP سير عمل العروض التقديمية وخريطة منظومة خوادم PowerPoint MCP الكاملة. تستخدم تطبيق سطح المكتب بدلًا من واجهة سطر الأوامر؟ راجع كيفية استخدام Claude MCP لإنشاء العروض التقديمية.

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

المصادر:

About 2Slides

Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.

Try For Free