رفتن به محتوا

Mage برای Claude Code

ساخت تصویر، ویدیو و صدا در Claude Code

Mage را در ترمینال و ویرایشگر به Claude Code وصل کنید و تصویر، ویدیو و صدا را با زبان ساده درخواست کنید. Claude Code مدل را انتخاب می‌کند، قیمت را اعلام می‌کند و نتیجه را برایتان می‌آورد.

https://mcp.mage.space/mcp

در یک نگاه

برای استفاده از Mage در Claude Code، سرور Mage MCP (https://mcp.mage.space/mcp) را اضافه کنید و با حساب Mage وارد شوید. بعد از آن Claude Code می‌تواند با Mango 3 تصویر، با Cherry 2 Pro ویدیو، با Seed Audio صدا یا با هر یک از ۲۸ مدل Mage که نام ببرید خروجی بسازد و هزینه هر تولید با Gems پرداخت می‌شود.

  • 16ابزارهای MCP
  • 28مدل‌های تصویر، ویدیو و صدا
  • 5دستیارهای پشتیبانی‌شده
  • $0برای اتصال

راه‌اندازی

اتصال Mage به Claude Code

حساب Mage لازم است؛ با نشست مهمان نمی‌توان اپی را وصل کرد.

  1. افزودن سرور

    این دستور را در ترمینال اجرا کنید.

    claude mcp add --transport http mage https://mcp.mage.space/mcp
  2. احراز هویت

    در Claude Code دستور /mcp را اجرا کنید، mage را انتخاب کنید و احراز هویت را بزنید. یک صفحه مرورگر باز می‌شود تا وارد Mage شوید و Connect را بزنید.

  3. یا از کلید 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 را آپلود کن و آن را به یک انیمیشن آبرنگی تبدیل کن.
  • یک ویدیوی پس‌زمینه ۵ ثانیه‌ای حلقه‌ای برای صفحه اصلی بساز.

ابزارها

۱۶ ابزار که دستیارتان می‌تواند فراخوانی کند

ابزارکاربرد
list_modelsمدل‌های پیشنهادی را با قیمت، بهترین کاربرد هر کدام و نقاط ضعفشان فهرست می‌کند.
get_modelفیلدها، مقادیر مجاز، پیش‌فرض‌ها، قوانین و قیمت یک مدل را شرح می‌دهد.
estimate_costقیمت یک تولید را پیش از شروع محاسبه می‌کند. هزینه‌ای کسر نمی‌شود.
create_uploadیک پیوند امضاشده برای آپلود فایل محلی می‌دهد؛ مناسب دستیارهایی که می‌توانند دستور اجرا کنند.
generateتولید تصویر، ویدیو یا صدا را شروع می‌کند.
get_requestمنتظر پایان تولید می‌ماند و پیوند نتیجه را برمی‌گرداند.
cancel_requestیک تولید در حال اجرا را متوقف می‌کند.
get_accountحساب متصل و موجودی Gems آن را نشان می‌دهد.
list_charactersکاراکترهای ذخیره‌شده شما و @handleهایشان را فهرست می‌کند.
create_characterیک کاراکتر خصوصی را از روی یک تصویر، و در صورت تمایل همراه با صدا، ذخیره می‌کند.
delete_characterیکی از کاراکترهای شما را حذف می‌کند.
list_referencesست لباس‌ها، حالت‌های بدن، مکان‌ها، اشیا و کلیپ‌های صوتی ذخیره‌شده شما را فهرست می‌کند.
create_referenceیک رفرنس خصوصی را از روی پیوند تصویر یا صدا ذخیره می‌کند.
delete_referenceیکی از رفرنس‌های شما را حذف می‌کند.
list_historyتولیدهای ۳۰ روز اخیر شما را فهرست می‌کند، از جمله آنهایی که در برنامه ساخته‌اید.
search_creationsآثار ذخیره‌شده شما را بر اساس محتوای آنها، مجموعه یا تاریخ جست‌وجو می‌کند.

دستیارهای بیشتر

Mage در همه دستیارهای هوش مصنوعی مهم کار می‌کند

  • Mage در Claude

    در Claude روی وب، اپ دسکتاپ، اپ‌های موبایل و Cowork تصویر، ویدیو و صدا تولید کنید.

  • Mage در ChatGPT

    در ChatGPT به‌عنوان یک اپ MCP شخصی، تصویر، ویدیو و صدا تولید کنید.

  • Mage در Grok

    با یک کانکتور سفارشی در Grok تصویر، ویدیو و صدا بسازید.

  • Mage در Cursor

    در حالت Agent در Cursor تصویر، ویدیو و صدا بسازید.

سؤالات متداول

سؤالات متداول

آیا Claude Code می‌تواند برای پروژه‌ام تصویر بسازد؟
بله. با سرور Mage MCP، Claude Code می‌تواند تصویر، ویدیو و صدا بسازد و نتیجه را در مخزن شما دانلود کند. همچنین می‌تواند با create_upload فایل‌های پروژه‌تان را آپلود کند، مثلاً کلیپی برای ویرایش.
در Claude Code از OAuth استفاده کنم یا کلید API؟
هر دو جواب می‌دهند. OAuth از طریق مرورگر وارد می‌شود و به هیچ secret در شل نیاز ندارد. کلید API برای CI و ماشین‌های بدون رابط گرافیکی مناسب است؛ آن را در هدر Authorization: Bearer بفرستید.
سرور Mage MCP چیست؟
یک سرور راه‌دور Model Context Protocol در نشانی https://mcp.mage.space/mcp که به دستیارهای هوش مصنوعی اجازه می‌دهد در حساب Mage شما تصویر، ویدیو و صدا بسازند. این سرور ۱۶ ابزار در اختیار دستیار می‌گذارد تا مدل انتخاب کند، قیمت را اعلام کند، تولید کند، منتظر نتیجه بماند و از شخصیت‌ها، رفرنس‌ها و تاریخچه‌ی ذخیره‌شده‌ی شما استفاده کند.
برای استفاده از سرور MCP به کلید API نیاز دارم؟
نه. 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 ← Connected apps قطع کنید.

ساختن با Mage را شروع کن

یک حساب، یک موجودی Gems، همهٔ مدل‌ها. فقط برای چیزی که تولید می‌کنی هزینه بپرداز.