اتصال VocaLingo به Claude، ChatGPT و Cursor از طریق MCP

پس از اتصال VocaLingo، دستیار هوش مصنوعی شما می‌تواند یک پیام صوتی را با صدای خود گوینده ترجمه کند، یک ویدیو از YouTube را خلاصه کند، متنی را با صدای خودتان بازخوانی کند، ویدیویی را دوبله کند یا زیرنویس اضافه کند. دستیار از موجودی عادی توکن‌های VocaLingo شما استفاده می‌کند و هر نتیجه در تاریخچه برنامه نیز نمایش داده می‌شود: دوبله را از کامپیوتر شروع کنید و روی تلفن خود تحویل بگیرید.

مشخصات سرور

مرحله 1. باز کردن صفحه دستیارهای هوش مصنوعی

1. برنامه VocaLingo را در iOS، Android یا web.vocalingo.app باز کرده و وارد شوید.

2. به بخش تنظیمات ← دستیارهای هوش مصنوعی (MCP) بروید. عنوان این صفحه «اتصال VocaLingo به هوش مصنوعی شما» است.

3. در بخش «انتخاب هوش مصنوعی»، دستیار خود را لمس کنید: Claude، ChatGPT، Cursor، VS Code، Claude Code یا سایر موارد. صفحه مراحل مربوط به آن را نمایش می‌دهد.

اتصال Claude

این روش برای claude.ai، Claude Desktop و برنامه‌های موبایل Claude کاربرد دارد.

1. در صفحه دستیارهای هوش مصنوعی، باز کردن Claude را لمس کنید. پنجره «افزودن رابط سفارشی» با نام و آدرس از قبل پرشده باز می‌شود.

2. روی افزودن و سپس اتصال بزنید.

3. برنامه Claude صفحه ورود VocaLingo را باز می‌کند. همانند داخل برنامه وارد شوید: با کدی که به ایمیل شما ارسال می‌شود، با Google، یا با کد دریافتی از برنامه.

به‌صورت دستی: در Claude مسیر Customize ← Connectors ← Add custom connector را باز کنید، آدرس https://nodejs.vocalingo.app/mcp را جای‌گذاری کرده و Connect را لمس کنید. پس از آن VocaLingo در تمام دستگاه‌های شما در Claude فعال خواهد بود.

اتصال ChatGPT

1. آدرس سرور را در صفحه دستیارهای هوش مصنوعی کپی کنید.

2. صفحه chatgpt.com/plugins را در مرورگر روی گوشی یا کامپیوتر خود باز کنید.

3. روی + ← Add custom MCP server ضربه بزنید.

4. نام VocaLingo را وارد کنید، آدرس را جای‌گذاری کنید، ورود OAuth را انتخاب کنید، گزینه «I understand and want to continue» را تایید کرده و Create را لمس کنید.

5. در صفحه‌ای که باز می‌شود، وارد حساب VocaLingo خود شوید.

سرورهای سفارشی MCP در همه پلن‌های ChatGPT در دسترس نیستند.

نحوه ورود از طریق Claude یا ChatGPT

صفحه ورود همان روش‌های برنامه را پشتیبانی می‌کند: کدی که به ایمیل شما ارسال می‌شود یا حساب Google. اگر در برنامه با Apple وارد شده‌اید یا روش ورود خود را به یاد ندارید، در صفحه دستیارهای هوش مصنوعی روی دریافت کد ورود بزنید. در صفحه ورود، گزینه «ورود با کد برنامه VocaLingo» را انتخاب کرده و کد 8 رقمی را وارد کنید. این کد یک‌بارمصرف است و به مدت 10 دقیقه اعتبار دارد.

اتصال Cursor یا VS Code

1. در کامپیوتری که Cursor یا VS Code روی آن نصب است، web.vocalingo.app را باز کرده و وارد شوید.

2. به بخش تنظیمات ← دستیارهای هوش مصنوعی (MCP) بروید و Cursor یا VS Code را انتخاب کنید.

3. روی نصب در Cursor یا نصب در VS Code کلیک کنید. ویرایشگر باز شده و پیشنهاد افزودن سرور VocaLingo را می‌دهد: آن را تایید کنید.

نصب با یک کلیک فقط روی کامپیوتر کار می‌کند. همچنین می‌توانید روی کپی پیکربندی بزنید و آن را در فایل ~/.cursor/mcp.json برای Cursor، یا در mcp.json برای VS Code (دستور «MCP: Open User Configuration») قرار دهید. فایل پیکربندی از قبل شامل توکن شما است.

اتصال Claude Code

1. در صفحه دستیارهای هوش مصنوعی، Claude Code را انتخاب کرده و کپی دستور را لمس کنید.

2. آن را در ترمینال اجرا کنید. ساختار دستور به این صورت است:

claude mcp add --transport http vocalingo https://nodejs.vocalingo.app/mcp --header "Authorization: Bearer vlmcp_YOUR_TOKEN"

برنامه Claude Code را مجدداً راه‌اندازی کنید. نام VocaLingo در فهرست /mcp نمایش داده می‌شود.

سایر کلاینت‌های MCP

ابزارهای Windsurf، Cline و هر کلاینتی که از سرورهای ریموت MCP پشتیبانی می‌کند، با آدرس https://nodejs.vocalingo.app/mcp و هدر Authorization: Bearer vlmcp_… متصل می‌شوند. در صفحه دستیارهای هوش مصنوعی گزینه سایر موارد را انتخاب کنید تا توکن و یک پیکربندی آماده را کپی کنید. افزونه‌های مربوط به Claude Code، Cursor، Codex و Gemini CLI با مهارت‌های آماده در مخزن vocalingo-mcp در GitHub قرار دارند.

ابزارهای VocaLingo MCP

دستیار، ابزار مناسب را بر اساس درخواست شما انتخاب می‌کند. ابزارهای پولی از توکن‌های VocaLingo، اعتبار درون‌برنامه‌ای شما، استفاده می‌کنند.

ابزارهای translate_video، caption_video و change_voice نیازمند فایل هستند. برای پیوند YouTube یا TikTok، دستیار ابتدا download_media را فراخوانی می‌کند و فایل دانلودشده را تحویل می‌دهد. قیمت ابزارهای پولی همانند داخل برنامه است، بخش قیمت توکن برای هر ابزار را بررسی کنید.

نحوه استعلام هزینه توسط دستیار

• عملیاتی که 50 توکن یا بیشتر هزینه داشته باشد ابتدا قیمت را اعلام می‌کند و کار تنها پس از موافقت شما شروع می‌شود. دستیار نمی‌تواند از طرف شما تایید کند.

• می‌توانید هزینه را از قبل بپرسید: «دوبله این ویدیو چقدر هزینه دارد؟». دستیار بدون شروع هیچ کاری، برآورد قیمت را به شما می‌گوید.

• تکرار همان درخواست در بازه 10 دقیقه هزینه دوباره ندارد: دستیار همان عملیات قبلی را دریافت می‌کند.

• اگر موجودی تمام شود، دستیار پیام «موجودی ناکافی» می‌دهد. موجودی خود را در برنامه افزایش دهید، بخش نحوه خرید توکن را ببینید. صورت‌حساب جداگانه‌ای برای MCP وجود ندارد.

نحوه ارسال صدا، عکس و ویدیو به دستیار

یک فایل بارگذاری‌شده تا 48 ساعت نگهداری می‌شود و دستیار می‌تواند بدون نیاز به بارگذاری مجدد، دوباره از آن استفاده کند. محدودیت‌های حجم: تا 150 مگابایت برای translate_audio، تا 50 مگابایت برای speech_to_text و save_voice، تا 100 مگابایت برای ابزارهای ویدیو و change_voice، و 20 مگابایت برای تصاویر.

اگر فقط می‌خواهید متن روی عکس را بخوانید یا ترجمه کنید، Claude و ChatGPT این کار را خودشان رایگان انجام می‌دهند. ابزار translate_image برای زمانی است که خود تصویر با متن بازنویسی‌شده را می‌خواهید.

عملیات‌های طولانی

ابزارهای طولانی حدود 25 ثانیه منتظر می‌مانند و در صورت آماده بودن، نتیجه را برمی‌گردانند. در غیر این صورت، دستیار یک jobId دریافت کرده و با check_job آن را بررسی می‌کند. دوبله ممکن است تا 30 دقیقه طول بکشد. اگر در حین انجام کار چت را بستید، از دستیار بخواهید check_job را بدون jobId فراخوانی کند: این کار موارد اخیر را نمایش می‌دهد. پیوندهای دانلود فایل‌های نتیجه تا 24 ساعت معتبر هستند؛ نتایج کار در تاریخچه برنامه باقی می‌مانند (بدون اشتراک Premium، سه مورد آخر در هر ابزار ذخیره می‌شود).

دسترسی، توکن و نحوه غیرفعال‌سازی

هر فردی که توکن شما را داشته باشد می‌تواند از موجودی توکن شما استفاده کند، بنابراین آن را مخفی نگه دارید. بخش دسترسی و توکن‌ها در صفحه دستیارهای هوش مصنوعی دارای دو گزینه است:

• ایجاد توکن جدید: توکن قبلی ظرف یک دقیقه از کار می‌افتد. آن را در دستیارهایی که با توکن متصل شده‌اند جایگزین کنید.

• غیرفعال‌سازی دسترسی MCP: تمام دستیارها از جمله رابط‌های Claude و ChatGPT ظرف یک دقیقه دسترسی خود را از دست می‌دهند. برای اتصال دوباره، فعال‌سازی دسترسی MCP را لمس کنید تا یک توکن جدید صادر شود.

تنها صدای خود یا صدایی را شبیه‌سازی کنید که اجازه صریح برای استفاده از آن را دارید. همین قانون در داخل برنامه نیز اعمال می‌شود.

پرسش‌های متداول