إعداد HeyGen MCP مع Claude: خادم MCP عن بُعد لفيديوهات الأفاتار

تكتب جملة واحدة في Claude، وتبتعد لتحضير قهوتك، ثم تعود لتجد فيديو أفاتار جاهزًا برابط يمكنك إرساله إلى عميل. هذا هو الوعد الذي يقدمه خادم HeyGen MCP عن بُعد، ويستغرق الإعداد نحو خمس دقائق لأنه لا يتطلب أي تثبيت. لا خادم محلي، ولا مفتاح API يُلصق في ملف إعدادات، ولا فوترة منفصلة. تسجّل الدخول مرة واحدة عبر OAuth، ويصبح بإمكان Claude العمل داخل حسابك على HeyGen.

يرشدك هذا الدليل إلى إعداد HeyGen MCP مع Claude في الأماكن الثلاثة التي يستخدم فيها الناس Claude فعليًا: تطبيق الويب، والتطبيق المكتبي، وClaude Code. ستحصل على نقطة النهاية الدقيقة، وأمر الطرفية الدقيق، وأوامر نصية تنتج فيديوهات قابلة للاستخدام، ومعلومات الأرصدة وحدود المعدل من وثائق HeyGen الرسمية، وقائمة بالحلول للأخطاء التي توقع المستخدمين في المشكلات. وفي نهاية الدليل شرح قصير لتشغيل محرك Avatar V من HeyGen مباشرة على PicassoIA، لأوقات تريد فيها مقدّمًا يتحدث أمام الكاميرا دون فتح أي مساعد.

💡 الإجابة السريعة: نقطة النهاية هي https://mcp.heygen.com/mcp/v1/. أضفها إلى Claude كموصل مخصص (أو شغّل أمر claude mcp add واحدًا في Claude Code)، ثم وافق على تسجيل دخول OAuth، واطلب فيديو.

ماذا يفعل خادم MCP عن بُعد فعليًا

MCP اختصار لعبارة Model Context Protocol، وهو المعيار المفتوح الذي يتيح لمساعد الذكاء الاصطناعي استدعاء أدوات داخل تطبيقات أخرى. يشغّل HeyGen خادمه على بنيته التحتية الخاصة، لذا يتصل Claude بنقطة نهاية مستضافة بدلًا من برنامج على حاسوبك المحمول. وبحسب الوثائق، يُخصم الاستخدام من الأرصدة المتضمنة في خطة HeyGen لديك، ويعمل الموصل مع كل الخطط.

بمجرد الاتصال، يستطيع Claude تنفيذ أعمال إنتاج حقيقية من نافذة الدردشة:

• الكتابة والتصيير من أمر نصي واحد. يختار Video Agent من HeyGen الأفاتار، ويكتب السيناريو، ويبني المشاهد، ويصيّر النتيجة.
• توجيه الأفاتار. يتحدث أفاتار HeyGen، أو صورة تزودها أنت، بالنص الذي تحدده بمزامنة الشفاه.
• ترجمة الفيديوهات الجاهزة إلى لغات أخرى مع الحفاظ على تطابق حركة الفم.
• إدارة المكتبة. عرض الفيديوهات وجلبها وحذفها، والعمل على القوالب وأطقم العلامة التجارية والمجلدات.
• التعامل مع الأصوات. تصفح كتالوجًا يضم أكثر من 500 صوت، أو صمّم صوتًا جديدًا من وصف نصي، أو استنسخ صوتًا من ملف صوتي.

يحتوي الخادم على أكثر من 48 وظيفة بحسب HeyGen، ويدعم Claude (الويب والتطبيق المكتبي وClaude Code)، وCursor، وGemini CLI، وCodex CLI، وLovable، وManus، وSuperhuman، والوكلاء المبنيين على OpenAI، إضافة إلى أي عميل MCP مخصص.

مستضاف، وليس مثبّتًا

تعمل خوادم HeyGen المجتمعية التي نُشرت سابقًا على جهازك، وتحتاج إلى مفتاح API موضوع في متغير بيئة. يلغي الخادم عن بُعد هاتين المهمتين. المصادقة تتم عبر OAuth، فلا يوجد أي سر مخزّن في ملف إعدادات، وتتولى HeyGen صيانة الأدوات من جهتها. تلصق عنوان URL واحدًا، وتوافق على شاشة تسجيل دخول واحدة.

اختر مسار الإعداد

توثّق HeyGen ثلاث طرق تتيح للوكيل العمل مع المنصة. وتأتي الأرصدة من خطتك في كل الحالات.

💡 نصيحة HeyGen للوكلاء صريحة: جرّب خادم MCP أولًا، ثم انتقل إلى CLI، واستخدم استدعاءات Raw API في المرتبة الأخيرة. لا تلصق أبدًا مفتاح API في نافذة دردشة.

ربط HeyGen مع Claude

Claude على الويب والتطبيق المكتبي

تختلف تسميات القوائم قليلًا بين إصدارات التطبيق، لكن الخطوات واحدة دائمًا.

1. افتح Claude وانتقل إلى Settings، ثم Connectors.
2. ابحث عن HeyGen. إن كان مدرجًا، فانقر Connect. وإن لم يكن، فاختر Add custom connector.
3. سمِّه HeyGen والصق https://mcp.heygen.com/mcp/v1/.
4. انقر Connect. ستُفتح علامة تبويب في المتصفح على شاشة OAuth في HeyGen.
5. سجّل الدخول إلى حساب HeyGen الذي تريد إنفاق أرصدته، ثم وافق على الوصول.
6. افتح دردشة جديدة وتأكد من تفعيل موصل HeyGen فيها.

خطوة OAuth هي الأهم. فالأرصدة تعود إلى الحساب الذي توافق عليه، لذا تحقق مرتين من أنك مسجل الدخول إلى مساحة العمل الصحيحة قبل المتابعة.

💡 تشغّل وكيلًا مخصصًا على نطاقه الخاص؟ تطلب HeyGen منك إرسال هذا النطاق عبر نموذج طلب التكامل الخاص بها لإدراجه في القائمة البيضاء.

Claude Code بأمر واحد

شغّل هذا الأمر مرة واحدة في الطرفية:

claude mcp add --transport http heygen https://mcp.heygen.com/mcp/v1/

نسخ الأمر النصي

ثم افتح Claude Code، واكتب /mcp، واختر heygen، وأكمل تسجيل الدخول عبر OAuth من متصفحك. أضف --scope user إذا أردت أن يكون الخادم متاحًا في كل المشاريع بدلًا من المشروع الحالي فقط.

يمكن للفرق التي تشترك في مستودع واحد أن تحفظ إعدادات المشروع بدلًا من ذلك:

{
  "mcpServers": {
    "heygen": {
      "type": "http",
      "url": "https://mcp.heygen.com/mcp/v1/"
    }
  }
}

نسخ الأمر النصي

لا يحتوي الملف على أي بيانات اعتماد، لذا يصادق كل عضو في الفريق على حسابه، وتبقى الأرصدة مرتبطة بالشخص الذي طلب الفيديو.

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

اسأل Claude: "Call the HeyGen get_current_user tool and tell me which account is connected." تستخدم وثائق HeyGen هذا الاستدعاء كفحص للحالة. وفي Claude Code تظهر الأداة باسم mcp__heygen__get_current_user. إن تطابق اسم الحساب مع ما تتوقعه، فأنت جاهز. وإن قال Claude إنه لا يملك أدوات HeyGen، فانتقل إلى جدول الإصلاحات الوارد لاحقًا.

أنشئ أول فيديو أفاتار لك

يتم التصيير بشكل غير متزامن. تقول HeyGen إن الفيديوهات تكتمل عادةً خلال 1 إلى 5 دقائق، ويجب على Claude استدعاء أداة للحالة لمعرفة وقت الاكتمال. اذكر ذلك في أمرك النصي، وإلا فقد يعطيك المساعد معرّفًا ثم يتوقف.

أوامر نصية تعمل

يمثل Video Agent أقصر طريق من الفكرة إلى الفيديو. وله وضعان: generate يُنفَّذ دون متابعة، بينما يتيح chat التحسين عبر عدة جولات. يجب أن يذكر الأمر الجيد ستة أشياء:

• الهدف: ما الذي يجب أن يفعله المشاهد بعد المشاهدة
• الجمهور: من يشاهد
• المدة: 15 أو 30 أو 60 ثانية
• النبرة: هادئة أو حماسية أو رسمية
• التنسيق: 16:9 بعرض الشاشة أو 9:16 عمودي
• الأسلوب: اختيار واحد من قائمة الأساليب

"استخدم HeyGen Video Agent لإنشاء فيديو توضيحي للمنتج مدته 30 ثانية عن مكتب وقوف. مقدّمة ودودة بصوت أنثوي، نبرة هادئة، عمودي 9:16، بأسلوب مكتب نظيف. استمر في التحقق من الحالة حتى يصبح الفيديو جاهزًا، ثم أعطني الرابط."

قبل التصيير، اطلب من Claude استدعاء list_video_agent_styles. فالأساليب قوالب منسّقة تتحكم في تكوين المشاهد وإيقاعها وشكلها، ويمكنك تصفيتها بوسوم مثل "cinematic" أو "retro-tech".

توجيه فيديوهات الأفاتار مباشرة

عندما يجب أن تكون الصياغة دقيقة تمامًا، كقائمة أسعار أو إشعار امتثال، تجاوز الوكيل واستخدم create_video. يتحدث أفاتار تختاره أو صورة ثابتة بسيناريوك أو بالصوت الذي تحدده مع مزامنة الشفاه. تختار Avatar III أو Avatar IV أو Avatar V كمحرك، وAvatar IV هو الخيار الافتراضي. لا يعمل Avatar V إلا مع الأفاتارات التي تدعمه.

"استخدم create_video مع أفاتار علامتي التجارية وهذا النص بالضبط. المحرك Avatar V، بدقة 1080p، بنسبة 16:9. أعد video_url عندما يكون جاهزًا."

تعيد أداة get_video الحالة وvideo_url وthumbnail_url والمدة وأي تفاصيل عن الفشل، لذلك هي الأداة التي يجب استدعاؤها عندما يبدو أن التصيير متوقف.

الترجمة مع مزامنة الشفاه

تستخدم الترجمة ثلاث أدوات: list_video_translate_languages للرموز الصالحة، وcreate_video_translate لبدء المهمة، وget_video_translate_caption لجلب الترجمات النصية لاحقًا. تقدم HeyGen وضعي السرعة والدقة، لذا يمكن أن تأتي مسودة سريعة ونسخة نهائية مصقولة من فيديو المصدر نفسه. تقدّم PicassoIA العائلة نفسها باسم Video Translate للدبلجة إلى أكثر من 150 لغة، إضافة إلى Lipsync Precision وLipsync Speed.

تقبل دفعات الترجمة حتى 100 عنصر في الطلب الواحد، ما يجعل توطين مكتبة تدريب كاملة في فترة بعد ظهر واحدة أمرًا واقعيًا.

ما تقدمه الأدوات وتكلفتها

مجموعات الأدوات في لمحة

الأرصدة والتوقيت والحدود

• النقاط: لا رسوم إضافية فوق خطتك. يُخصم الاستخدام من أرصدة الخطة، وتكلّف عمليات استنساخ الأصوات الاحترافية رصيدًا واحدًا لكل توليد للمظهر.
• إزالة كلمات الحشو: 0.30 دولار لكل دقيقة من المصدر، مع حد أدنى دقيقة واحدة.
• التوقيت: تنتهي معظم عمليات التصيير خلال 1 إلى 5 دقائق. استعلم بتأخير أُسّي متزايد واحترم أي ترويسة Retry-After.
• حد المعدل: 30 طلبًا في الدقيقة لكل عضو في مساحة العمل على نقطة نهاية تركيب الصوت الاحترافي.
• حجم الدفعة: 100 عنصر في الطلب الواحد عبر كل أنواع الدفعات.
• فيديوهات المرجع: حتى 12 في وضع الإشارة إلى الفيديو، بنسب عرض إلى ارتفاع من 1:4 إلى 4:1.
• القوالب: حذف القالب حذف ناعم، وتبقى الفيديوهات التي أُنشئت منه دون تغيير.

إصلاح المشكلات الشائعة

الأعراض والإصلاحات

عادات توفّر الأرصدة

• اطلب من Claude أن يعيد صياغة السيناريو والأفاتار والتنسيق قبل التصيير، ثم أجب بكلمة "go".
• جرّب مقطعًا من 10 إلى 15 ثانية قبل مقطع طويل.
• صحّح السيناريو أولًا. فإعادة التصيير لإصلاح خطأ مطبعي تستهلك الأرصدة دون فائدة.
• شغّل الدفعة فقط بعد اعتماد عيّنة واحدة.

أين يأتي دور PicassoIA

محركات HeyGen ليست محبوسة داخل تطبيق HeyGen. تعرض PicassoIA عددًا منها إلى جانب نماذج أخرى لفيديوهات الكلام، وهذا مفيد لاختبارات A/B على السيناريو نفسه.

السيناريوهات مهمة بقدر أهمية التصيير. تستطيع نماذج اللغة على PicassoIA، مثل Claude Sonnet 5 وClaude Fable 5 وClaude Opus 4.7، أن تكتب السيناريو وتحسّنه قبل وصوله إلى أي أداة أفاتار. وهذا يمنحك تقسيمًا واضحًا: اكتب بنموذج لغوي، وصيّر بنموذج أفاتار، وأبقِ كل خطوة سهلة التكرار.

كيف تستخدم Avatar V على PicassoIA

يناسب مسار MCP من يعيشون داخل Claude. أما إن كنت تفضل النقر على نموذج، فإن Avatar V على PicassoIA يحوّل نصًا مكتوبًا إلى فيديو لمتحدث أمام الكاميرا دون كاميرا أو استوديو أو ممثلين.

خطوة بخطوة

1. افتح صفحة Avatar V على PicassoIA.
2. الصق سيناريوك في input_text. الحد هو أقل من 5,000 حرف لكل تشغيل.
3. أضف voice_id وavatar_id. كلاهما مطلوب، ويجب أن يدعم الأفاتار Avatar V. تأتي هذه المعرّفات من كتالوجات HeyGen، ويستطيع الموصل عن بُعد عرض الأصوات، لذا يمكن أن يساعدك Claude في اختيار قائمة مختصرة منها.
4. اختر aspect_ratio: 16:9 للعرض الواسع أو 9:16 للعمودي.
5. اختر resolution: 720p أو 1080p (الافتراضي) أو 4k.
6. اضبط voice_speed بين 0.5 و1.5، وفعّل caption إذا أردت ترجمات مدمجة في الفيديو.
7. شغّل التوليد ونزّل الملف الجاهز. استغرق التشغيل النموذجي في معرض النموذج نحو 137 ثانية بدقة 1080p.

إعدادات تستحق الضبط

💡 عادتان في كتابة السيناريو تستحقان العناء: اجعل الجمل قصيرة بما يكفي لقولها في نَفَس واحد، واكتب الأرقام والاختصارات كما تريد أن تُنطق.

جرّبه على PicassoIA اليوم

أمامك الآن طريقان للوصول إلى النتيجة نفسها. اربط HeyGen بـClaude عندما تريد أن يتم إنشاء الفيديو داخل محادثة، بحيث تبدأ جملة واحدة التصيير. واستخدم PicassoIA عندما تفضل اختيار الإعدادات بنفسك ومقارنة المحركات جنبًا إلى جنب.

اختر سيناريو قصيرًا تملكه بالفعل، ربما مقدمة منتج أو خطوة تدريبية، ومرّره عبر Avatar V بدقة 720p. ثم أرسل المادة نفسها عبر Video Translate لتسمعها بلغة ثانية. عشر دقائق من التجريب على PicassoIA ستخبرك عن سير عملك أكثر مما تخبرك به أي مواصفات تقنية. افتح المنصة، وجرّب نموذجًا، وابدأ فيديو الأفاتار الأول لك اليوم.