خادم MCP من ElevenLabs: إعداد Claude Code وChatGPT وCursor

لا تزال معظم الشروحات الخاصة بهذا الإعداد تطلب منك لصق مفتاح API سري في ملف JSON وتشغيل حزمة Python باسم elevenlabs-mcp. هذا الطريق مسدود. مستودع GitHub الرسمي مؤرشف، وإشعاره نفسه يصف الخادم المحلي بأنه مهجور، وتشغّل ElevenLabs الآن خادم MCP مستضافًا على https://api.elevenlabs.io/v1/mcp يسجّل دخولك عبر OAuth. لا توجد حزمة تحتاج إلى تثبيت، ولا يوجد مفتاح سري محفوظ في ملف إعدادات، ولا شيء تحتاج إلى تحديثه عند صدور الإصدار التالي.

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

ما الذي يغيّره الخادم المستضاف

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

الخادم المستضاف مقابل الحزمة المحلية القديمة

يظهر الفرق العملي عند أول عطل. مع الحزمة المحلية، كان عليك أن تحل مشكلات أدوات Python وPATH وأخطاء ملف الإعدادات. أما مع الخادم المستضاف، فالأجزاء المتحركة الوحيدة هي عنوان URL وتسجيل دخول عبر المتصفح.

💡 تعمل بالفعل بالحزمة القديمة؟ ما زالت تعمل، لذا لا يجبرك شيء على الانتقال اليوم. لكن الإعداد الجديد لا يبدأ من هناك، والإعدادات أدناه تستغرق وقتًا أقل من تثبيت uv.

ما الذي يستطيع مساعدك إنشاءه

بعد الربط، يحصل المساعد على مجموعة من الأدوات تصل إلى مساحة عمل ElevenLabs الخاصة بك. تقسم ElevenLabs هذه الأدوات إلى مجالين: ElevenCreative لتوليد الوسائط، وElevenAgents لبناء الوكلاء الصوتيين والنصيين. بعبارة بسيطة، يستطيع مساعدك أن:

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

كل ما تولّده يُحفظ في مساحة عمل ElevenCreative الخاصة بك، حيث يمكنك فتحه في Studio لإنهاء العمل. هذه التفصيلة أهم مما تبدو عليه: الصوت لا يبقى محبوسًا داخل نافذة المحادثة، بل يكون في المكان نفسه مع بقية مشاريعك.

تحقق من هذه الأمور قبل الربط

تحتاج إلى ثلاثة أشياء: حساب ElevenLabs، وأحد العملاء المدعومين، وعنوان URL الصحيح للخادم حسب منطقة بياناتك. معظم المستخدمين يحتاجون فقط إلى العنوان الأول في الجدول.

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

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

إعداد Claude Code بأمرين

يدعم Claude Code بروتوكول MCP البعيد بشكل أصلي، ما يجعله أقصر الطرق الثلاثة. يمكنك إضافة الخادم فقط، أو تثبيت الإضافة التي تجمع الخادم مع مهارات جاهزة.

إضافة الخادم فقط

شغّل هذا الأمر في الطرفية، خارج أي جلسة Claude Code:

claude mcp add --transport http elevenlabs https://api.elevenlabs.io/v1/mcp

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

ثم أكمل تسجيل الدخول من داخل Claude Code:

1. ابدأ جلسة باستخدام claude.
2. اكتب /mcp لفتح قائمة الخوادم.
3. اختر elevenlabs واختر المصادقة.
4. وافق على الوصول في نافذة المتصفح التي تُفتح، باستخدام حساب ElevenLabs الخاص بك.

عندما يُظهر المتصفح أنك متصل، تتغير حالة الخادم في /mcp من الحاجة إلى المصادقة إلى متصل، وتظهر أدوات ElevenLabs في القائمة.

تثبيت الإضافة الكاملة

إذا أردت أكثر من الأدوات الخام، فإن ElevenLabs تقدم إضافة تعمل في Claude Code وCursor وOpenAI Codex. في Claude Code تحتاج إلى أمرين:

/plugin marketplace add elevenlabs/plugin
/plugin install elevenlabs@elevenlabs

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

تضيف الإضافة ثلاث مجموعات من المهارات فوق الربط:

• مهارات عامة لتحويل النص إلى كلام بأكثر من 70 لغة، وتحويل الكلام إلى نص، ومغيّر الصوت، والمؤثرات الصوتية، والموسيقى، والدبلجة.
• مهارات MCP لإدارة الوكلاء وللاستوديو الإبداعي، ويشمل الكلام والصور والفيديو والنسخ.
• مهارات المهندس لبناء الوكلاء الصوتيين، من الاختبار حتى النشر.

يبقى تسجيل الدخول كما هو: تسجّل الدخول عبر OAuth عندما يتصل الوكيل بالخادم لأول مرة.

التحقق وتحديد النطاق

تحقق من أن الخادم سُجّل وأنه يعمل بشكل سليم:

claude mcp list

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

افتراضيًا، يحفظ claude mcp add الخادم للمشروع الحالي فقط. أضف --scope user لجعله متاحًا في كل مشروع على جهازك:

claude mcp add --scope user --transport http elevenlabs https://api.elevenlabs.io/v1/mcp

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

استخدم --scope project بدلًا من ذلك عندما ينبغي أن يشارك الفريق كله الإعداد نفسه. يؤدي ذلك إلى كتابة ملف .mcp.json في جذر المشروع، ولأن تسجيل الدخول يتم عبر OAuth، فإن الإدخال يحتوي على عنوان URL فقط.

💡 مساحة عمل في منطقة خاصة؟ استبدل عنوان URL الافتراضي بعنوان إقامة البيانات الخاص بمنطقتك من الجدول أعلاه. يبقى كل شيء آخر في الأمر كما هو.

جرّب أول أمر فورًا: "اقرأ ملف README في هذا المستودع، وأنشئ سردًا صوتيًا مدته 20 ثانية لخطوات التثبيت بصوت هادئ." يقرأ Claude Code الملف، ويكتب النص، ويستدعي أداة الكلام، ويظهر الصوت الجاهز في مساحة عمل ElevenCreative الخاصة بك.

إعداد Cursor من السوق أو JSON

يمنحك Cursor طريقتين، وكلتاهما تنتهي بالطلب نفسه لتسجيل دخول OAuth. اختر السوق إذا أردت المهارات، أو ملف JSON إذا أردت التحكم الكامل في ما يُحمَّل.

تثبيت بنقرة واحدة من السوق

افتح سوق Cursor، وابحث عن إضافة ElevenLabs وثبّتها. تجمع الإضافة الخادم المستضاف ومهاراته معًا، فيستطيع وكيل البرمجة الوصول إلى الكلام والمؤثرات الصوتية والموسيقى والدبلجة دون أي توصيل إضافي. في أول اتصال، يطلب منك Cursor تسجيل الدخول إلى ElevenLabs.

إدخال mcp.json يدويًا

للإعداد اليدوي، أضف الخادم إلى ملف mcp.json. استخدم ~/.cursor/mcp.json لكل المشاريع، أو .cursor/mcp.json داخل مستودع واحد:

{
  "mcpServers": {
    "elevenlabs": {
      "url": "https://api.elevenlabs.io/v1/mcp"
    }
  }
}

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

احفظ الملف وأعد تحميل النافذة. يطلب منك Cursor تسجيل الدخول عبر OAuth عند أول اتصال، ثم تظهر أدوات ElevenLabs في قسم MCP في إعداداتك. لاحظ ما هو غائب من JSON: لا command، ولا args، ولا كتلة env. يحتاج الخادم البعيد إلى عنوان URL فقط ولا شيء غيره.

اختبار جيد في Cursor هو سرد لعرض توضيحي: "أنشئ تعليقًا صوتيًا لمسار الدفع في هذا المشروع، من جملتين، بنبرة ودودة." إذا طلب الوكيل إذنًا قبل استدعاء الأداة، فهذا يعني أن تأكيد الأدوات في Cursor يقوم بعمله، وليس خطأً.

إعداد ChatGPT كموصل مخصص

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

إضافة الموصل

تتغير أسماء القوائم في ChatGPT بين الإصدارات والخطط، لذا اتبع المنطق لا التسميات الدقيقة:

1. افتح إعدادات ChatGPT وانتقل إلى قسم الموصلات أو التطبيقات.
2. ابحث عن ElevenLabs في الدليل. تسرد ElevenLabs تثبيتًا بنقرة واحدة باستخدام OAuth في ChatGPT.
3. إذا لم يكن مدرجًا لحسابك، فاختر إضافة موصل مخصص.
4. أدخل عنوان URL للخادم https://api.elevenlabs.io/v1/mcp واختر OAuth كطريقة للمصادقة.
5. سجّل الدخول بحساب ElevenLabs الخاص بك ووافق على طلب الوصول.
6. في محادثة جديدة، فعّل موصل ElevenLabs من قائمة الأدوات قبل أن تكتب طلبك.

💡 لا ترى الخيار؟ في مساحات العمل Business وEnterprise وEducation، قد يحتاج المسؤول إلى السماح بالموصلات المخصصة أولًا، عادةً عبر مفتاح وضع المطور في أذونات مساحة العمل. في الخطط الشخصية تختلف الإتاحة، لذا تحقق من خطتك قبل أن تقضي ساعة في تصحيح الأخطاء.

تشغيل أول أمر اختبار

ابدأ بشيء صغير حتى تعرف هل الخلل في الربط أم في الأمر. هذه الخمسة تعمل في ChatGPT وClaude Code وCursor على حد سواء:

• "أنشئ رسالة ترحيب مدتها 10 ثوانٍ بصوت أنثوي دافئ."
• "أنشئ مؤثرًا صوتيًا لمطر على سقف من الصفيح، مدته 8 ثوانٍ."
• "انسخ هذا التسجيل وسمِّ كل متحدث."
• "اكتب تشويقة لمنتج مدتها 30 ثانية، واقرأها بصوت رجالي واثق."
• "ادبلج هذا المقطع إلى الإسبانية مع الحفاظ على نبرة المتحدث الأصلي."

إذا نجح الأمر الأول، فستنجح بقية الأوامر. إذا فشل برسالة عن الأدوات أو الأذونات، فانتقل إلى القسم التالي.

إصلاح المشكلات التي يواجهها الناس

تقع معظم الأعطال في إحدى ثلاث فئات: لم يكتمل تسجيل الدخول، أو لا يتطابق الحساب أو المنطقة، أو أن إعدادًا قديمًا ما زال يعيق الطريق.

لا تظهر نافذة تسجيل الدخول

في Claude Code، يبقى الخادم الجديد الذي يعتمد على OAuth في حالة الحاجة إلى المصادقة حتى تفتح /mcp وتختاره وتبدأ تسجيل الدخول بنفسك. وعادةً لا يفتح تبويب متصفح تلقائيًا. في Cursor وChatGPT، أعد محاولة الاتصال وتحقق من أن المتصفح لم يحجب النافذة المنبثقة. إذا فُتح تبويب على حساب ElevenLabs الخطأ، فسجّل الخروج من المتصفح وكرر الخطوات.

منطقة خاطئة أو أدوات محجوبة

يضم هذا القسم عرضين مختلفين، ولكل منهما حل مختلف.

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

الشروحات القديمة ومفاتيح API السرية

إذا اتبعت منشورًا قديمًا، فقد يبقى في ملف الإعدادات إدخال يشغّل uvx elevenlabs-mcp. وجود خادمين يعرضان أدوات متشابهة يجعل المساعد يختار بشكل غير متوقع، لذا احذف القديم:

claude mcp remove ElevenLabs

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

استخدم الاسم الدقيق الذي أعطيته له، واحذف الكتلة المطابقة من claude_desktop_config.json أو mcp.json إذا كانت موجودة هناك. ثلاثة بقايا أخرى تستحق التنظيف:

• متغيرات البيئة مثل ELEVENLABS_MCP_BASE_PATH وELEVENLABS_MCP_OUTPUT_MODE تنتمي إلى الحزمة المحلية ولا تفعل شيئًا على الخادم المستضاف.
• خطوة وضع المطور في Windows التي كانت تطلبها الشروحات القديمة لتطبيق Claude Desktop جزء من المسار المحلي، لا من المسار المستضاف.
• مفاتيح API السرية الملصوقة في ملفات الإعدادات يجب تدويرها من لوحة تحكم ElevenLabs، خاصة إذا وصل الملف يومًا إلى مستودع Git.

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

ليست كل مهمة تحتاج إلى مساعد يتدخل في سيرها. إذا كنت تريد فقط تعليقًا صوتيًا من نص جاهز، فإن ElevenLabs V3 على PicassoIA يعمل في المتصفح دون ربط، ودون OAuth، ودون أي عميل تحتاج إلى إعداده. يوفر أكثر من 25 صوتًا، وإخراجًا متعدد اللغات، وضبطًا دقيقًا للسرعة والنبرة والأسلوب.

الخطوات في المتصفح

1. افتح صفحة نموذج ElevenLabs V3.
2. الصق نصك في Prompt، وهو الحقل الوحيد المطلوب.
3. اختر voice. الافتراضي هو Rachel، وتضم القائمة أيضًا Drew وAria وRoger وSarah وJames وJuniper.
4. حدد رمز اللغة، مثلًا en أو es أو fr.
5. اضبط عناصر التحكم في الجدول أدناه.
6. للنصوص الطويلة، املأ Previous Text وNext Text حتى يبقى التنغيم طبيعيًا عند حدود الجمل.
7. شغّل النموذج، واستمع إلى النتيجة، ثم حمّل الصوت.

💡 نصيحة: لفصل من كتاب مسموع أو وحدة من دورة تدريبية، ارفع Stability واترك Style قرب الصفر، حتى تبدو الجملة 40 كالجملة 1. أما لمقطع تشويقي أو صوت شخصية، فافعل العكس.

اختر نموذج ElevenLabs المناسب

ElevenLabs ليس نموذجًا واحدًا، وPicassoIA يستضيف عدة نماذج منها. اختر حسب المهمة، لا حسب أحدث اسم.

يمكن أن يأتي النص نفسه من نموذج لغوي كبير على المنصة ذاتها. اكتب مسودته باستخدام Claude Sonnet 5 أو GPT 5.6 Sol، والصق الناتج في نموذج صوتي، فتحصل على مادة مسرودة دون مغادرة المتصفح.

💡 موصلان، ومساعد واحد. يقدم PicassoIA أيضًا موصله الخاص لتوليد الصور والفيديوهات من داخل المحادثة. شغّله إلى جانب موصل ElevenLabs، وسيستطيع مساعد واحد أن يعلّق صوتيًا على نص ويرسم له في المحادثة نفسها.

أنشئ مرئياتك الخاصة على Picasso IA

الصوت نصف العمل المكتمل فقط. كل فيديو يحتاج إلى صورة مصغرة، وكل بودكاست يحتاج إلى غلاف، وكل عرض توضيحي يحتاج إلى مشاهد تبدو كصور فوتوغرافية حقيقية لا كمحتوى مخزون مزدحم. هذا هو الجزء الذي يتولاه Picasso IA في ثوانٍ.

ابدأ بنموذج PicassoIA Image، أو جرّب Seedream 4.5 لنسخة ثانية. صف الشخص والضوء والعدسة في جملة واحدة، مثلًا "بودكاستر على مكتب خشبي، ضوء نافذة من اليسار، عدسة 85 ملم، عمق حقل ضحل"، ثم غيّر تفصيلة واحدة في كل مرة وقارن النتائج. عندما تكون الصورة قريبة من المطلوب لكنها ليست دقيقة، يتيح لك PicassoIA Image Editor Pro تعديلها بدلًا من البدء من جديد.

اختر نصًا واحدًا صوّته اليوم، وولّد ثلاث صور تناسبه، وضعها معًا. يمكنك تصفح كل النماذج المتاحة على picassoia.com/en/all-models والبدء بالتجربة الآن.