الانتقال إلى المحتوى الرئيسي
لدى Youka خادم MCP. ‏MCP (Model Context Protocol) هي الطريقة القياسية التي يتصل بها مساعدو الذكاء الاصطناعي بالأدوات الخارجية. بمجرد توصيله، يمكنك أن تطلب من مساعدك أشياء مثل “أنشئ فيديو كاريوكي للملف ~/Music/song.mp3”، فينشئ المشروع في حساب Youka الخاص بك، وينتظر حتى يكتمل، ثم يعطيك رابط المحرر أو رابط التنزيل. يعمل الخادم مع أي عميل MCP يدعم الخوادم البعيدة (Streamable HTTP) مع ترويسة مخصّصة، مثل Claude Code وCursor وCodex.
تطبيقات Youka الرسمية لـ ChatGPT وClaude قادمة قريبًا. وحتى ذلك الحين، استخدم عميلًا من هذه الصفحة مع مفتاح Youka API.

ما الذي تحتاجه

تفاصيل الخادم:
يمنح مفتاح API وصولًا كاملًا إلى حساب Youka الخاص بك وأرصدته. احرص على إبقائه خارج الملفات والمستودعات المشتركة. إذا تسرّب مفتاح، احذفه من صفحة حسابك وأنشئ واحدًا جديدًا.

ربط مساعدك

شغّل هذا في الطرفية لديك، مع استبدال YOUR_API_KEY بمفتاحك:
تحقّق من أنه تم الاتصال:
ينبغي أن ترى youka: https://mcp.youka.io/mcp (HTTP) - ✔ Connected.افتراضيًا تتم إضافة الخادم للمجلد الحالي فقط. أضِف --scope user لاستخدام Youka في كل المجلدات.

جرّبه

اطلب من مساعدك بلغة طبيعية. على سبيل المثال:
يسير طلب كاريوكي نموذجي على النحو التالي:
1

Upload

يطلب المساعد من Youka رابط رفع ويقوم برفع ملفك. الرفع مجاني.
2

Check the cost

يتحقق من عدد الأرصدة التي سيستخدمها المشروع ويقارن ذلك مع رصيدك.
3

Create the project

يزيل Youka الغناء ويزامن الكلمات. يستغرق ذلك بضع دقائق. يقوم المساعد بالتحقق من الحالة حتى يصبح المشروع جاهزًا.
4

Edit or export

تحصل على رابط لفتح المشروع في محرر Youka. وإذا طلبت ملف الفيديو، يقوم المساعد بتصديره ويعطيك رابط تنزيل.
إنشاء مشروع لا يقوم بعمل Render للفيديو تلقائيًا. أنت تقرر متى تقوم بالتصدير، حتى تتمكن من تصحيح الكلمات أو النمط أولًا، سواءً عبر الدردشة أو في Youka editor.

ما الذي يستطيع المساعد فعله

الأرصدة والسلامة

  • نفس الأرصدة مثل تطبيق الويب. إنشاء مشروع، وإعادة مزامنة الكلمات، والتصدير تكلفتها هي نفسها كما على online.youka.io.
  • يتم التحقق من التكلفة أولًا. إذا لم تكن لديك أرصدة كافية، يرفض Youka الطلب ويذكر ذلك. لا يتم خصم شيء.
  • لا توجد رسوم مزدوجة. إذا أعاد المساعد محاولة تنفيذ طلب بعد انتهاء المهلة، يتعرف Youka على إعادة المحاولة ويعيد النتيجة الأصلية بدلًا من الخصم مجددًا.
  • تُشترى الأرصدة على Youka. لا يستطيع المساعد شراء الأرصدة. لإضافة المزيد، راجع Buy more credits.
  • الأدوات المدفوعة تعمل فقط عندما تطلب. يتم توجيه المساعد لإنشاء المشاريع أو مزامنة الكلمات أو التصدير فقط عندما تطلب ذلك.

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

مفتاح API مفقود أو غير صالح. تحقق من أن الترويسة هي بالضبط Authorization: Bearer yk_...، مع مسافة واحدة بعد Bearer ودون مسافات إضافية أو علامات اقتباس داخل المفتاح. إذا حذفت المفتاح من صفحة حسابك، أنشئ مفتاحًا جديدًا وحدّث إعدادات عميلك. بالنسبة لإعدادات Codex وCursor التي تقرأ YOUKA_API_KEY، تأكد من تعيين المتغير في البيئة التي يبدأ منها التطبيق.
اطلب من المساعد رصيدك، أو تحقّق منه على online.youka.io. ثم buy more credits واطلب مجددًا.
اطلب من المساعد عرض المشروع. يتضمن ذلك الخطأ. تأكد من أن الملف ملف صوت أو فيديو مدعوم وضمن حدود الرفع التي يعرضها حسابك.
أخبر المساعد بالكلمات الصحيحة واطلب منه مزامنتها مجددًا، أو افتح رابط المحرر وedit the lyrics بنفسك. ثم صدّر مرة أخرى.

مستندات ذات صلة