لمحة سريعة
لاستخدام Mage في Claude Code، أضف خادم Mage MCP (https://mcp.mage.space/mcp) وسجّل الدخول بحساب Mage. بعدها يستطيع Claude Code توليد الصور باستخدام Mango 3، والفيديو باستخدام Cherry 2 Pro، والصوت باستخدام Seed Audio، أو أي نموذج من نماذج Mage الـ 28 التي تحددها، مع الدفع مقابل كل عملية توليد بواسطة Gems.
16
أدوات MCP
28
نماذج الصور والفيديو والصوت
5
المساعدات المدعومة
$0
للاتصال
الإعداد
كيفية ربط Mage بـ Claude Code
يلزم وجود حساب في Mage؛ فلا يمكن لجلسة الضيف ربط تطبيق.
أضف الخادم
شغّل هذا الأمر في الطرفية.
claude mcp add --transport http mage https://mcp.mage.space/mcpأكمل المصادقة
في Claude Code، شغّل /mcp واختر mage ثم أكمل المصادقة. ستُفتح صفحة في المتصفح لتسجيل الدخول إلى Mage واختيار اتصال.
أو استخدم مفتاح API
لتخطي تسجيل الدخول عبر المتصفح، أضف الخادم مع مفتاحك في ترويسة بدلًا من ذلك.
claude mcp add --transport http mage https://mcp.mage.space/mcp \ --header "Authorization: Bearer $MAGE_API_KEY"
جرّب بنفسك
أمثلة على الأوامر لاستخدام Mage في Claude Code
- ولّد صورة Open Graph بحجم 1200×630 لهذه التدوينة واحفظها في public/og.png.
- أنشئ رسومًا رئيسية للأقسام الثلاثة في صفحة الهبوط بألوان علامتنا التجارية.
- ارفع assets/demo.mp4 وحوّله إلى رسوم متحركة بأسلوب الألوان المائية.
- أنشئ فيديو خلفية متكررًا مدته 5 ثوانٍ للصفحة الرئيسية.
الأدوات
16 أداة يستطيع مساعدك استدعاءها
| الأداة | وظيفتها |
|---|---|
| list_models | تعرض النماذج الموصى بها مع أسعارها وما يناسب كلًّا منها وجوانب المفاضلة فيها. |
| get_model | تصف حقول نموذج واحد وقيمه المسموحة وإعداداته الافتراضية وقواعده وسعره. |
| estimate_cost | تحسب سعر عملية الإنشاء قبل بدئها. لا يُخصم أي مبلغ. |
| create_upload | تمنحك رابطًا موقّعًا لرفع ملف محلي، للمساعدات القادرة على تنفيذ الأوامر. |
| generate | تبدأ عملية إنشاء صورة أو فيديو أو صوت. |
| get_request | تنتظر اكتمال عملية الإنشاء ثم تعيد رابط النتيجة. |
| cancel_request | توقف عملية إنشاء قيد التنفيذ. |
| get_account | تعرض الحساب المتصل ورصيده من Gems. |
| list_characters | تعرض شخصياتك المحفوظة ومعرّفاتها @handles. |
| create_character | تحفظ شخصية خاصة من صورة، مع صوت اختياريًا. |
| delete_character | تحذف إحدى شخصياتك. |
| list_references | تعرض ما حفظته من أزياء ووضعيات وأماكن وأغراض ومقاطع صوتية. |
| create_reference | تحفظ مرجعًا خاصًا من رابط صورة أو صوت. |
| delete_reference | تحذف أحد مراجعك. |
| list_history | تعرض ما أنشأته خلال آخر 30 يومًا، بما في ذلك ما أُنشئ في التطبيق. |
| search_creations | تبحث في إبداعاتك المحفوظة بحسب ما تعرضه أو المجموعة أو التاريخ. |
مساعدات أخرى
يعمل Mage مع كل مساعدات الذكاء الاصطناعي الكبرى
الأسئلة الشائعة
الأسئلة الشائعة
هل يستطيع Claude Code توليد صور لمشروعي؟
نعم. مع خادم Mage MCP يستطيع Claude Code توليد الصور والفيديو والصوت، ثم تنزيل النتائج داخل مستودعك. ويمكنه أيضًا رفع ملفات من مشروعك باستخدام create_upload، مثل مقطع تريد تعديله.
هل أستخدم OAuth أم مفتاح API مع Claude Code؟
كلاهما يعمل. يسجّل OAuth الدخول عبر المتصفح ولا يحتاج إلى سر في الطرفية. أما مفتاح API فيناسب أنظمة CI والأجهزة بلا واجهة رسومية؛ مرّره في ترويسة Authorization: Bearer.
ما هو خادم Mage MCP؟
خادم Model Context Protocol عن بُعد على https://mcp.mage.space/mcp يتيح لمساعدي الذكاء الاصطناعي إنشاء الصور والفيديو والصوت على حسابك في Mage. ويمنح المساعد 16 أداة لاختيار النموذج ومعرفة السعر والإنشاء وانتظار النتيجة واستخدام شخصياتك ومراجعك وسجلك المحفوظ.
هل أحتاج إلى مفتاح API لاستخدام خادم MCP؟
لا. يتصل Claude وChatGPT وGrok وCursor وClaude Code عبر تسجيل الدخول إلى Mage باستخدام OAuth. مفتاح API اختياري، ويفيد في الإعدادات دون واجهة مثل CI.
كم التكلفة؟
الاتصال مجاني. يُدفع ثمن كل عملية توليد يبدأها مساعدك بالـ Gems من حسابك في Mage وفق سعر النموذج المعلن، ويمكن لمساعدك عرض السعر عبر estimate_cost قبل أن يبدأ.
ما النماذج التي يستخدمها مساعدي؟
إن لم تذكر نموذجًا بعينه، سينشئ مساعدك الصور بنموذج Mango 3، والفيديو بنموذج Cherry 2 Pro، والصوت بنموذج Seed Audio. ويمكنك طلب أي نموذج آخر من نماذج Mage بذكر اسمه.
هل ربط حسابي في Mage آمن؟
يعرض Mage اسم التطبيق وموقعه والوجهة التي ستعود إليها قبل مشاركة أي شيء، وأنت توافق على كل اتصال. يمكنك فصل أي تطبيق في أي وقت من MCP ← التطبيقات المتصلة.
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.