Kling 3.0 MCP: استخدام Kling في Claude و Codex وسطر الأوامر

تكتب جملة واحدة في الطرفية، وبعد دقائق قليلة يظهر ملف MP4 في مجلد مشروعك. هذه هي الصورة التي يتخيلها معظم الناس عند البحث عن Kling 3.0 MCP، وبعض أجزائها يعمل فعلًا. وأجزاء أخرى تحتاج إلى تنبيه صريح، لأن العبارة تجمع ثلاثة أشياء منفصلة: نماذج الفيديو Kling v3، وبروتوكول Model Context Protocol، ووكلاء البرمجة (Claude Code و Codex CLI) الذين يستدعون الأدوات عبره.

يفصل هذا المقال بين الثلاثة. ستعرف ما يفعله كل نموذج من نماذج Kling v3، وكيف تسجّل خادم MCP في Claude Code وفي Codex، وكيف تشغّل الأوامر نفسها بلا واجهة من الصدفة، وكيف تكتب أوامر تنجح من المحاولة الأولى أو الثانية. وحين لم أتمكن من التحقق من شيء، أذكر ذلك بدلًا من التخمين.

ماذا يعني Kling 3.0 MCP فعلًا

MCP بكلمات بسيطة

بروتوكول Model Context Protocol طريقة معيارية لكي يستدعي عميل الذكاء الاصطناعي أدوات خارجية. يبدأ عميل مثل Claude Code أو Codex CLI تشغيل خادم MCP أو يتصل به، ويسأله عن الأدوات التي يقدمها، ثم يستدعيها أثناء عمله. وعادةً ما يعرض خادم الفيديو أدوات مثل "إنشاء فيديو" و"التحقق من حالة المهمة" و"جلب الملف".

تأتي الخوادم بنوعين. خادم stdio برنامج محلي: يشغّل العميل أمرًا (غالبًا npx أو uvx) ويتواصل معه عبر الإدخال والإخراج القياسيين. أما خادم HTTP فيكون بعيدًا ويحتاج عادةً إلى رمز حامل (bearer token). وفي الحالتين يتشابه الإعداد في جوهره: اسم، وأمر أو رابط، ومتغيرات البيئة التي يحتاجها الخادم.

ما الموجود اليوم

هذا هو الوضع كما تحققت منه أثناء كتابة المقال:

• لا يوجد خادم رسمي من Kling. لم أجد خادم MCP منشورًا من Kling نفسها.
• خادم من طرف ثالث. تسرد الأدلة العامة mcp-kling، ويوصف بأنه خادم MCP لتوليد فيديو Kling AI. يُظهر الإدراج أنه يُشغَّل باستخدام uvx mcp-kling ويقرأ متغير ACEDATACLOUD_API_TOKEN. اقرأ ملف README الخاص به لمعرفة إصدارات Kling التي يدعمها قبل أن تبني عليه.
• موصل PicassoIA. يعرض أربعة نماذج: اثنان للصور واثنان للفيديو، هما PicassoIA Video وSeedance 2.5 Lite. نموذج Kling v3 غير موجود في هذه القائمة، لذلك تشغّله من صفحة النموذج الخاصة به.

وضع المسارات الثلاثة جنبًا إلى جنب يجعل المفاضلة بينها أوضح:

💡 نصيحة: تعامل مع كل خادم MCP على أنه شيفرة تعمل على جهازك. اقرأ المستودع، وثبّت إصدارًا محددًا، واحتفظ بالرموز في متغيرات البيئة، ولا تضعها أبدًا داخل الأمر النصي.

نماذج Kling v3 الثلاثة

Kling v3 ليس نموذجًا واحدًا على PicassoIA بل ثلاثة، واختيار النموذج المناسب يوفر معظم التشغيلات الضائعة.

Kling v3 Video

Kling v3 Video هو الخيار الافتراضي. يحوّل الأمر النصي إلى مقطع يصل إلى 15 ثانية، في وضع standard (720p) أو وضع pro (1080p). يمكن أن يصل الأمر النصي إلى 2,500 حرف، والأمر النصي السلبي له الحد نفسه. يمكنك تثبيت الإطار الأول باستخدام start_image والأخير باستخدام end_image، أو كتابة سيناريو من ستة لقطات كحد أقصى باستخدام multi_prompt. الصوت الأصلي مغلق افتراضيًا ويُفعَّل بـ generate_audio.

Kling v3 Omni Video

Kling v3 Omni Video يضيف المراجع. أرفق حتى سبع صور مرجعية (أربع عند وجود فيديو مرجعي) لتثبيت شكل الشخصية أو الشيء أو المكان، ثم استدعها داخل الأمر النصي باستخدام عناصر نائبة مثل <<<image_1>>>. يعمل فيديو مرجعي مدته من 3 إلى 10 ثوانٍ بطريقتين: feature يستعير الأسلوب وحركة الكاميرا، بينما base يعدّل مقطعًا موجودًا وفق وصفك المكتوب.

Kling v3 Motion Control

Kling v3 Motion Control يأخذ صورة ثابتة لشخصية مع فيديو مرجعي، ثم يجعل الشخصية تكرر الحركة. اضبط character_orientation على image للمقاطع التي تصل إلى 10 ثوانٍ وتحافظ على وضعية صورتك، أو على video للمقاطع التي تصل إلى 30 ثانية وتتبع الشخص في اللقطات. يمكن أن تكون الفيديوهات المرجعية بصيغة MP4 أو MOV بحجم يصل إلى 100 ميغابايت، ويحدد keep_original_sound ما إذا كان صوتها سيبقى.

ربط Kling مع Claude Code

يسجّل Claude Code الخوادم باستخدام claude mcp add. كل ما يأتي بعد الشرطتين المزدوجتين هو الأمر الذي يشغّل الخادم.

إضافة الخادم

claude mcp add kling --env ACEDATACLOUD_API_TOKEN=$ACEDATACLOUD_API_TOKEN -- uvx mcp-kling

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

توسيع المتغير في الصدفة يُبقي السر خارج الأمر الذي تلصقه في الدردشة أو في لقطات الشاشة. أسماء العلامات والمتغيرات مأخوذة من قائمة الإدراج، فتحقق منها في ملف README الخاص بالخادم نفسه.

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

شغّل claude mcp list لعرض كل الخوادم وحالتها، أو اكتب /mcp داخل الجلسة. إذا ظهر Kling بحالة فشل، شغّل الأمر الذي يأتي بعد الشرطتين المزدوجتين يدويًا في طرفية عادية. معظم الأعطال تنتج عن غياب تثبيت uvx أو خطأ في الرمز.

لمشاركة الإعداد مع فريق، أضف --scope project. يكتب Claude Code ملف .mcp.json في جذر المستودع، ويمكنك الإشارة إلى الرمز بوصفه ${ACEDATACLOUD_API_TOKEN} حتى لا يُرفع السر إلى المستودع أبدًا.

عندما يصبح الخادم أخضر، اطلب مقطعًا بلغة بسيطة:

استخدم أداة Kling لإنشاء مقطع مدته 5 ثوانٍ بنسبة 16:9: قارب صيد يغادر ميناءً ضبابيًا عند الفجر، مع تقريب بطيء للكاميرا وصوت خافت لمحرك. انتظر حتى ينتهي، ثم أعطني رابط الملف.

ربط Kling مع Codex CLI

يحتفظ Codex CLI بإعدادات MCP في ~/.codex/config.toml. يمكنك تعديل هذا الملف أو ترك أمرًا يكتبه نيابةً عنك.

إعداد بأمر واحد

codex mcp add kling --env ACEDATACLOUD_API_TOKEN=$ACEDATACLOUD_API_TOKEN -- uvx mcp-kling
codex mcp list

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

الصياغة تشبه Claude Code: اسم، ثم أزواج --env اختيارية، ثم الشرطتان المزدوجتان، ثم أمر التشغيل. يؤكد codex mcp list أن الخادم حُفظ.

تعديل config.toml يدويًا

كل خادم هو جدول [mcp_servers.<name>]:

[mcp_servers.kling]
command = "uvx"
args = ["mcp-kling"]
env_vars = ["ACEDATACLOUD_API_TOKEN"]

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

هنا يسمّي env_vars متغيرًا يُمرَّر من الصدفة. إذا كنت تفضّل تخزين قيمة، فاستخدم جدول [mcp_servers.kling.env] بدلًا من ذلك، وأبقِ هذا الملف خارج نظام التحكم في الإصدارات. ويعمل .codex/config.toml محلي للمشروع أيضًا في المشاريع التي صنّفتها بأنها موثوقة. أما الخوادم البعيدة فتستخدم url وbearer_token_env_var بدلًا من command.

تشغيل Kling من سطر الأوامر

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

التشغيل بلا واجهة

التشغيل بلا واجهة يرسل تعليمة واحدة ثم يخرج. وافق مسبقًا على أدوات Kling، وإلا فسيُرفض استدعاء الأداة لأن أحدًا غير موجود للموافقة عليه:

claude -p "Read prompts/harbor.txt, make a 5 second Kling clip from it, wait until it finishes, and print the URL" --allowedTools "mcp__kling"

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

codex exec "Read prompts/harbor.txt, make a 5 second Kling clip from it, wait until it finishes, and print the URL"

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

التوليد بطيء، فخطّط وفقًا لذلك. التشغيلات النموذجية المدرجة في صفحة Kling v3 Video استغرقت ما بين 5 و18 دقيقة تقريبًا لكل منها، بينما استغرقت أمثلة Omni نحو 2 إلى 10 دقائق. شغّل المقاطع واحدًا تلو الآخر وسجّل المخرجات بدلًا من مراقبتها.

حفظ الأوامر في ملفات

ضع كل أمر نصي في ملف نصي خاص به، ثم كرّر العملية على كل ملف في المجلد:

mkdir -p out
for f in prompts/*.txt; do
  claude -p "Make a Kling clip from $f and save the result URL to out/$(basename "$f" .txt).url" --allowedTools "mcp__kling"
done

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

الملفات تمنحك سجلًا ومراجعة وإمكانية إعادة الاستخدام. قائمة اللقطات لمقطع متعدد اللقطات ليست إلا ملف JSON صغيرًا بجوار الأمر النصي، والفرق (diff) يُظهر بدقة ما الذي تغيّر بين محاولتين.

اكتب أوامر يلتزم بها Kling v3

يقرأ الأمر الجيد لـ Kling كوصف للقطة، لا كأمنية. سمِّ الشخص، والحركة، وحركة الكاميرا، والإضاءة، وإذا كان الصوت مفعّلًا فـالصوت. فكرة واحدة لكل لقطة أفضل من خمس أفكار مكدسة في لقطة واحدة.

السيناريوهات متعددة اللقطات

يقبل كل من Kling v3 Video وKling v3 Omni Video مصفوفة multi_prompt. لكل لقطة أمرها النصي ومدتها الخاصة:

[
  {"prompt": "Wide shot of a fishing boat leaving a foggy harbor at dawn", "duration": 5},
  {"prompt": "Close-up of the captain's weathered hands on the wheel", "duration": 5},
  {"prompt": "Aerial shot of the boat heading into open water", "duration": 5}
]

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

يُسمح بست لقطات كحد أقصى، مدة كل منها ثانية واحدة على الأقل، ويجب أن تساوي المدد مجموع duration للمقطع. اللقطات الثلاث أعلاه مجموعها 15 ثانية، لذلك ضُبط المجموع على 15.

المادة المرجعية والحركة

بالنسبة إلى Kling v3 Motion Control، يقوم الفيديو المرجعي بمعظم العمل. صوّر مقطعًا قصيرًا بهاتفك يظهر فيه الجسم كاملًا داخل الإطار، وتبقى الكاميرا ثابتة، وتكون الحركة نظيفة. ثم اقرنه بصورة ثابتة مؤطّرة بطريقة مشابهة. نادرًا ما تتطابق صورة شخصية مقرّبة مع مشي لجسم كامل.

3 أخطاء شائعة

1. مدد لا تتراكم بشكل صحيح. تنص صفحة النموذج على أن مجموع اللقطات يجب أن يساوي duration، لذلك فإن لقطات مجموعها 12 ثانية مقابل duration قدره 15 يجعل الطلب غير صالح. احسب المجموع قبل الإرسال.
2. ضبط نسبة العرض مع صورة بداية. في Kling v3 Video تُتجاهل النسبة بمجرد أن تزوّد start_image، لأن المقطع يتبع الصورة.
3. الصوت مع فيديو مرجعي. في Kling v3 Omni Video، لا يمكن الجمع بين generate_audio وفيديو مرجعي. استخدم keep_original_sound للمادة المصورة بدلًا من ذلك.

💡 نصيحة: جرّب كل فكرة في وضع standard أولًا. يُصيَّر بدقة 720p، فيكلّفك الأمر الضعيف انتظارًا قصيرًا بدلًا من تشغيل بوضع pro. انتقل إلى pro للمحاولة التي تنوي نشرها.

كيفية استخدام Kling v3 على PicassoIA

إذا كنت تفضّل تجاوز إعداد الخادم، فصفحة النموذج تشغّل المحرك نفسه عبر حقول نموذجية بدلًا من الخيارات. هذا هو المسار لـ Kling v3 Video:

1. افتح صفحة النموذج وسجّل الدخول إلى حسابك.
2. اختر الوضع. يعطي standard دقة 720p للمسودات، ويعطي pro دقة 1080p للمحاولة النهائية.
3. اكتب الأمر النصي. ابقَ دون 2,500 حرف، واتبع ترتيب الشخص والحركة والكاميرا والإضاءة والصوت.
4. اضبط المدة ونسبة العرض. اختر 16:9 أو 9:16 أو 1:1، ومدة تصل إلى 15 ثانية.
5. أضف الإطارات إذا احتجت إليها. ارفع صورة بداية، وصورة نهاية إذا أردت تثبيت الإطار الأخير.
6. الصق قائمة لقطات في حقل متعدد اللقطات عندما تريد مشاهد منفصلة.
7. فعّل Generate Audio للصوت المحيط، وأضف أمرًا نصيًا سلبيًا لأي شيء تريد استبعاده.
8. ولّد وحمّل ملف MP4 عندما تتحول الحالة إلى done.

أنشئ أول مقطع لك باستخدام Kling v3

اختر فكرة صغيرة واحدة ونفّذها اليوم. اكتب سيناريو من ثلاث لقطات مدة كل منها خمس ثوانٍ، وأرسله إلى Kling v3 Video في وضع standard، واقرأ النتيجة، وأصلح أضعف لقطة، ثم ادفع ثمن وضع pro بعد ذلك. إذا كان لديك صورة لشخصية ومقطع قصير من هاتفك، فجرّب بعدها Kling v3 Motion Control, واستخدم Kling v3 Omni Video عندما يجب أن تظهر الشخصية نفسها في عدة لقطات.

تريد البقاء داخل Claude Code أو Codex؟ يتضمن موصل PicassoIA بالفعل PicassoIA Video وSeedance 2.5 Lite، لذا يمكنك توليد مقاطع من الطرفية اليوم، والاحتفاظ بنموذج Kling v3 للّقطات التي تحتاج إلى تحكمه متعدد اللقطات.

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

افتح Picasso IA، واختر نموذجًا، وأنشئ شيئًا. مقطع تستطيع مشاهدته سيعلّمك عن كتابة الأوامر أكثر من أي قدر من القراءة.