كيفية استخدام QoderWake مع 2Slides: بروتوكول MCP للموظفين الرقميين (2026)

Q: ما هو الأمر الدقيق لإضافة 2Slides إلى Waker؟

qoderwake mcp add --waker-id agxxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR2SLIDESAPIKEY". ضع زوج الترويسة بالكامل بين علامتي اقتباس، لأن القيمة تحتوي على مسافة.

Q: أين يجب أن أخزن مفتاح واجهة برمجة تطبيقات 2Slides في QoderWake؟

في ترويسة موصل MCP (--header أو --headers) أو --env الخاص به لـ stdio. لا تضعه أبدًا في مهمة أو ذاكرة أو قاعدة معرفة أو ملف دور. وثائق QoderWake تمنع ذلك صراحة.

Q: هل يمكن لـ Waker إنشاء عرض تقديمي كل أسبوع تلقائيًا؟

نعم. قم بإنشاء أتمتة مجدولة باستخدام qoderwake automation create schedule وتعبير cron. اختبرها باستخدام automation run-now قبل تشغيلها دون إشراف.

إجابة سريعة (60 كلمة أو أقل): ابحث عن معرف Waker الخاص بك باستخدام qoderwake waker list --json، ثم قم بتشغيل qoderwake mcp add --waker-id ag_xxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR_2SLIDES_API_KEY". سيتمكن هذا الـ Waker بعد ذلك من البحث في قوالب 2Slides وإرجاع ملف .pptx قابل للتعديل، عند الطلب، عبر DingTalk أو Feishu، أو وفقًا لجدول زمني محدد.

تطلق QoderWake، التابعة لفريق Qoder في Alibaba، على منتجها اسم "الموظفون الرقميون المستقلون في العمل". يُطلق على كل موظف رقمي اسم Waker. يتم تفعيل الـ Waker بواسطة رسائل المراسلة الفورية (IM)، أو الجداول الزمنية، أو أحداث الـ hook، أو استدعاءات API، ويقوم بأداء العمل بشكل مستقل. يعمل QoderWake على أنظمة macOS 13+، وLinux، وWindows 10+. ويحتوي على لوحة تحكم ويب محلية عند 127.0.0.1:19820 وواجهة سطر أوامر (CLI) كاملة، كما يتصل بتطبيقات DingTalk وFeishu.

يتم إلحاق خوادم ومهارات MCP لكل Waker على حدة. يوضح هذا الدليل كيفية تزويد Waker واحد (على سبيل المثال، "مساعد التقارير" الخاص بك) بمحرك عرض 2Slides. يستخدم هذا الدليل مرجع CLI الرسمي لـ QoderWake ونقاط نهاية 2Slides التي اختبرناها مباشرة في بيئة الإنتاج في 30 سبتمبر 2026.

لماذا تمنح Waker ميزة 2Slides؟

تم بناء Wakers للقيام بالأعمال المتكررة، ومهمة "تحويل أرقام هذا الأسبوع إلى عرض تقديمي" هي بالضبط هذا النوع من المهام.
2Slides ينتج الملف النهائي: عرض PowerPoint قابل للتعديل يعتمد على قالب (Fast PPT، بتكلفة 10 أرصدة لكل صفحة)، أو شرائح مصممة بالصور (Nano Banana، بتكلفة 100 رصيد لكل صفحة بدقة 1K/2K) مع ميزة AI voice narration اختيارية.
نطاق العمل لكل Waker يعني أن الـ Waker الذي يحتاج إلى الشرائح فقط هو من يحصل على الأداة والمفتاح.

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

تثبيت QoderWake وتسجيل الدخول. على أنظمة macOS أو Linux، يوفر مرجع CLI مثبتًا من سطر واحد:

curl -fsSL https://qoder-ide.oss-ap-southeast-1.aliyuncs.com/qoderwake/install.sh | bash
qoderwake login
qoderwake start      # daemon on 127.0.0.1:19820

تتوفر حزم Windows وmacOS على موقع QoderWake الإلكتروني. إذا لم يتمكن نظام التشغيل من العثور على qoderwake، استخدم ~/.qoderwake/bin/qoderwake.

مفتاح 2Slides API من 2slides.com/api (sk-2slides-...). تحصل الحسابات الجديدة على 500 رصيد مجاني، وهو ما يغطي 50 صفحة من نوع Fast PPT.
Node.js على الجهاز، فقط لطريقة stdio.

الخطوة 1: العثور على معرف Waker ID

qoderwake waker list --json

تبدأ معرفات Waker بـ ag_. انسخ المعرف الخاص بالـ Waker الذي يجب أن يقوم بإنشاء العروض التقديمية. تستخدم الأمثلة أدناه ag_xxx.

الطريقة 1: استضافة MCP عبر HTTP (موصى بها)

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --description "2Slides presentation generator" \
  --transport http \
  --http-url https://2slides.com/api/mcp \
  --header "Authorization=Bearer YOUR_2SLIDES_API_KEY"

حول علامات الاقتباس. صيغة CLI هي --header KEY=VALUE (قابلة للتكرار). القيمة هنا، Bearer YOUR_2SLIDES_API_KEY، تحتوي على مسافة، لذا قم بإحاطة زوج KEY=VALUE بالكامل بعلامات اقتباس مزدوجة كما هو موضح. بدون علامات الاقتباس، سيقوم نظام التشغيل بتقسيمها إلى وسيطتين وتصل الترويسة (header) كـ Bearer فقط.

هل تريد تجنب تحليل = والمسافات تمامًا؟ استخدم صيغة JSON لنفس الخيار، --headers <json>:

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport http \
  --http-url https://2slides.com/api/mcp \
  --headers '{"Authorization":"Bearer YOUR_2SLIDES_API_KEY"}'

في Windows PowerShell، تعمل علامات الاقتباس المفردة أيضًا، ولكن قد يكون اقتباس JSON عبر أنظمة التشغيل المختلفة أمرًا صعبًا. في هذه الحالة، يعد استيراد الملفات في الطريقة 2 هو الخيار الأكثر أمانًا.

بديل في حال فشل الترويسة. إذا لم تصل الترويسة (خطأ 401 أو Authentication required عند تحديث الأدوات)، فتجاوز الترويسات تمامًا. يقبل 2Slides أيضًا المفتاح كمعلمة استعلام في عنوان URL (query parameter)، وقد اختبرنا هذا النموذج بشكل كامل:

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport http \
  --http-url "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

تعامل مع عنوان URL هذا ككلمة مرور: لا تقم بلصقه في المهام أو لقطات الشاشة، وقم بتغيير المفتاح في 2slides.com/api في حال تسريبه.

يستخدم 2Slides مفتاح API عاديًا، وليس OAuth، لذا اترك جميع أعلام --oauth-* غير مفعلة.

الطريقة 2: استيراد MCP JSON

يقبل qoderwake mcp add أيضًا --json <json> أو --json-file <path> لاستيراد MCP JSON مباشرة. احفظ هذا كـ 2slides-mcp.json:

{
  "mcpServers": {
    "2slides": {
      "type": "streamable-http",
      "url": "https://2slides.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_2SLIDES_API_KEY"
      }
    }
  }
}

qoderwake mcp add --waker-id ag_xxx --json-file 2slides-mcp.json

لا يوضح مرجع CLI أشكال JSON التي يقبلها المستورد. الكتلة البرمجية أعلاه هي تنسيق mcpServers الشائع. إذا تم رفض الاستيراد، استخدم أعلام الطريقة 1 الموثقة بالكامل. احذف الملف بعد ذلك، أو ابقه بعيدًا عن أي مستودع Git، لأنه يحتوي على مفتاحك.

الطريقة 3: خادم stdio محلي

لتشغيل حزمة 2slides-mcp مفتوحة المصدر على جهاز Waker:

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport stdio \
  --command npx \
  --args "-y,2slides-mcp@latest" \
  --env '{"API_KEY":"YOUR_2SLIDES_API_KEY"}'

يأخذ --args قائمة مفصولة بفاصلة، وهو نفس النمط المتبع في مثال نظام الملفات الرسمي في مرجع CLI. بينما يأخذ --env تنسيق JSON. يتطلب هذا وجود Node.js على الجهاز الذي يعمل عليه Waker، مع العلم أن QoderWake يكون مقيمًا على الجهاز افتراضيًا.

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

qoderwake mcp list --waker-id ag_xxx                      # 2slides should be listed
qoderwake mcp refresh-tools --waker-id ag_xxx --mcp-id <mid>
qoderwake mcp get --waker-id ag_xxx --mcp-id <mid>        # inspect the entry

خذ <mid> من mcp list. ثم أرسل للـ Waker اختبارًا للقراءة فقط. توجيهات QoderWake الخاصة هي التحقق من صحة الموصل الجديد باستخدام استدعاء للقراءة فقط أولاً:

List the tools you have from 2slides, then search for a "minimal" theme and show me the themeId.

إن themes_search مجاني، لذا لن يكلف هذا الاختبار شيئًا. إذا لم يعمل الموصل بشكل صحيح، فإن qoderwake mcp toggle --waker-id ag_xxx --mcp-id <mid> --enabled false يقوم بإيقاف تشغيله دون حذفه.

الطريقة 4: رفع مهارة 2Slides

مهارات QoderWake هي حزم إمكانيات تعتمد على إصدارات git، مما يتيح لك مقارنة الاختلافات (diff) والتراجع عن التغييرات. يمكنك رفع "ملف Markdown أو أرشيف يحتوي على ملف SKILL.md". توجد مهارة 2Slides الرسمية على github.com/2slides/slides-generation-2slides-skills. قم بضغطها في ملف Zip بحيث يكون SKILL.md في جذر الأرشيف:

git clone https://github.com/2slides/slides-generation-2slides-skills
cd slides-generation-2slides-skills
zip -r ../2slides-skill.zip SKILL.md scripts references
cd ..
qoderwake skill upload 2slides-skill.zip --waker-id ag_xxx

هذا يستبعد حزمة .skill القديمة الموجودة في المستودع. تقرأ نصوص Python البرمجية الخاصة بالمهارة (Python 3 و requests) المفتاح من متغير البيئة SLIDES_2SLIDES_API_KEY.

قاعدة الأسرار. تنص وثائق QoderWake على ما يلي: "لا تضع أبدًا الأسرار أو الرموز المميزة (tokens) أو ملفات تعريف الارتباط (cookies) في المهام، أو الذاكرة، أو قواعد المعرفة، أو ملفات الأدوار، أو لقطات الشاشة". تنتمي بيانات الاعتماد إلى الحقول المحمية أو متغيرات البيئة. لذا، لا تقم أبدًا بلصق مفتاحك في موجه المهام أو تطلب من Waker "تذكره". لا توثق QoderWake طريقة لتمرير متغيرات البيئة إلى نصوص المهارات البرمجية، لذا نوصي بهذا التقسيم:

استخدم موصل MCP (الطريقة 1) لإجراء مكالمات واجهة برمجة التطبيقات (API) الفعلية. حيث يتم حفظ المفتاح في الترويسة (header) الخاصة به.
استخدم المهارة فقط إذا كان متغير SLIDES_2SLIDES_API_KEY معينًا بالفعل في البيئة التي يعمل فيها Waker. تحقق من ذلك بمهمة اختبار تقوم بتشغيل scripts/search_themes.py --query minimal --limit 1.

إنشاء عرضك التقديمي الأول

Read sales_week39.csv in the project, summarize the key movements,
and build an 8-slide weekly sales review with 2slides. Search for a
clean business theme first, then generate the PowerPoint and send
me the download link.

يجب أن يقوم Waker باستدعاء themes_search، ثم slides_generate، وإرجاع downloadUrl. في اختبار الإنتاج الخاص بنا، استغرق إرجاع عرض Fast PPT مكون من 3 صفحات حوالي 22 ثانية. تنتهي صلاحية الرابط بعد ساعة واحدة. تنص وثائق QoderWake على أن تسليم الملفات "يعتمد على إمكانيات القناة. استخدم الرابط المرتجع أو عنصر المهمة (task artifact)". لذا اطلب من Waker نشر الرابط على الفور، أو تنزيل .pptx في مساحة العمل الخاصة به. يمكنك بعد ذلك سحبه من الجلسة باستخدام qoderwake session artifacts --session-id sess_xxx.

حالات استخدام للموظف الرقمي (AI Employee)

التفعيل عبر DingTalk أو Feishu. بمجرد ربط Waker بقناة DingTalk أو Feishu، يمكن لزميل في الفريق إرسال رسالة نصها "@Reporting Assistant make a 6-slide update on the Q4 hiring plan". سيقوم Waker بجمع السياق، والاتصال بـ 2Slides والرد بالرابط.

عرض تقديمي أسبوعي مجدول. توثق مراجع CLI الأتمتة المجدولة:

qoderwake automation create schedule --waker-id ag_xxx \
  --name "Weekly Sales Deck" \
  --schedule-type cron --cron "0 9 * * 1" \
  --timezone Asia/Shanghai \
  --prompt "Build this week's 8-slide sales review from the latest CSV with 2slides and post the download link"
qoderwake automation run-now --waker-id ag_xxx --automation-id tr_xxx   # test once

قم بتشغيله مرة واحدة باستخدام run-now وتحقق من النتيجة باستخدام qoderwake automation detail قبل تركه يعمل تلقائيًا.

أدوات 2Slides MCP

الأداة	وظيفتها	الاعتمادات
`themes_search`	العثور على `themeId` من بين أكثر من 1,500 قالب	مجانًا
`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`	استطلاع حالة مهمة غير متزامنة (كل 20 إلى 30 ثانية)	مجانًا

ما تم تأكيده مقابل ما لم يتم توثيقه بعد (حتى 30 سبتمبر 2026)

البند	الحالة
أعلام `waker list`، `mcp add` (`--transport`، `--http-url`، `--header`، `--headers`، `--json`، `--command`، `--args`، `--env`)، `skill upload`	مؤكد في مرجع QoderWake CLI
بروتوكول MCP والمهارات تكون لكل Waker؛ يجب عدم وضع الأسرار في المهام أو الذاكرة	مؤكد في وثائق QoderWake
نقطة نهاية 2Slides، مصادقة Bearer، و7 أدوات	تم اختبارها فعليًا بواسطة 2Slides
شكل JSON الدقيق المقبول بواسطة `mcp add --json`	غير موثق؛ تم عرض نموذج `mcpServers` كأفضل محاولة
كيف يقوم `--header` بتقسيم قيمة تحتوي على `=`	غير موثق؛ ضع الزوج بالكامل بين علامتي اقتباس أو استخدم JSON `--headers`
تمرير متغيرات البيئة إلى نصوص المهارات البرمجية	غير موثق

استكشاف الأخطاء وإصلاحها

"daemon unreachable". قم بتشغيل qoderwake status. إذا كان البرنامج الخفي (daemon) لا يعمل، qoderwake start. إذا كان المنفذ مشغولاً، qoderwake start --port auto.
خطأ 401 من QoderWake نفسها. قم بتشغيل qoderwake whoami، و qoderwake login مرة أخرى إذا لزم الأمر.
خطأ 401 من 2Slides. من المحتمل أن الترويسة وصلت بدون المفتاح. أعد إضافتها باستخدام --header المقتبس أو نموذج JSON --headers.
الأدوات مفقودة. قم بتشغيل qoderwake mcp refresh-tools، وتأكد من تمكين الموصل باستخدام mcp toggle ... --enabled true.
فشل stdio. تأكد من تثبيت Node.js على جهاز Waker وأن --args مفصولة بفاصلة.
أخطاء أثناء التشغيل. qoderwake log --level error --limit 100 أو qoderwake trace list --status failed.
انتهت صلاحية الرابط. يستمر downloadUrl لمدة ساعة واحدة. اطلب من Waker حفظ الملف كأداة مهمة (task artifact).

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

هل يدعم QoderWake خوادم MCP المخصصة؟

نعم. يمكن لكل Waker تثبيت عدة خوادم MCP عبر stdio أو HTTP أو SSE، باستخدام qoderwake mcp add --waker-id <id> أو شاشة "Custom MCP Connectors" في لوحة التحكم.

ما هو الأمر الدقيق لإضافة 2Slides إلى Waker؟

qoderwake mcp add --waker-id ag_xxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR_2SLIDES_API_KEY". ضع زوج الترويسة بالكامل بين علامتي اقتباس، لأن القيمة تحتوي على مسافة.

أين يجب أن أخزن مفتاح واجهة برمجة تطبيقات 2Slides في QoderWake؟

في ترويسة موصل MCP (--header أو --headers) أو --env الخاص به لـ stdio. لا تضعه أبدًا في مهمة أو ذاكرة أو قاعدة معرفة أو ملف دور. وثائق QoderWake تمنع ذلك صراحة.

هل يمكن لـ Waker إرسال ملف PowerPoint إلى DingTalk أو Feishu؟

يمكن لـ Waker دائمًا الرد برابط تنزيل 2Slides. أما إرفاق الملف نفسه فيعتمد على القناة. تنص وثائق QoderWake على استخدام الرابط المرتجع أو أداة المهمة. تنتهي صلاحية الرابط بعد ساعة واحدة.

هل يمكن لـ Waker إنشاء عرض تقديمي كل أسبوع تلقائيًا؟

نعم. قم بإنشاء أتمتة مجدولة باستخدام qoderwake automation create schedule وتعبير cron. اختبرها باستخدام automation run-now قبل تشغيلها دون إشراف.

ما هي التكلفة؟

تحصل حسابات 2Slides الجديدة على 500 من الاعتمادات المجانية. تبلغ تكلفة Fast PPT حوالي 10 اعتمادات لكل صفحة، لذا فإن العرض الأسبوعي المكون من 8 شرائح يكلف 80 نقطة رصيد. البحث عن القوالب، واستطلاع حالة المهام، وعمليات التصدير مجانية.

الخلاصة

أمر qoderwake mcp add واحد يحوّل Waker إلى موظف رقمي (AI employee) يُنتج عروضاً تقديمية حقيقية. احتفظ بالمفتاح في ترويسة MCP، وقم بتشغيله عبر DingTalk أو Feishu أو عبر جدولة cron، ثم احفظ .pptx خلال ساعة واحدة.

احصل على مفتاحك وإعدادات التكوين عبر 2slides.com/api?tab=mcp.

المصادر: