تعرّف على Retell MCP Server

تدعم منصّة Retell AI الآن بروتوكول Model Context Protocol، أو MCP، حتى تتمكّن من إنشاء وكلاء صوتيين وإدارتهم مباشرةً من أدوات الذكاء الاصطناعي التي تستخدمها بالفعل. ويشمل ذلك العملاء المتوافقين مع MCP مثل Cursor وClaude Desktop وClaude Code وأدوات بأسلوب Codex والمزيد.

عبر اتصال MCP واحد، يمكن لمساعدك أن يعمل مباشرةً مع منصّة Retell AI من أجل:

• إنشاء الوكلاء وتحديثهم
• بدء المكالمات
• إدارة أرقام الهاتف
• إرفاق قواعد المعرفة
• تشغيل QA

إذا كنت تستخدم Retell AI بالفعل عبر API أو SDKs الخاصة بنا، فإنّ MCP هو المنصّة نفسها عبر واجهة أبسط وأكثر ملاءمةً للوكلاء.

ما الذي يمكن لـ Retell MCP Server القيام به

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

الوكلاء

• إنشاء الوكلاء
• تحديث الوكلاء
• نشر الإصدارات
• سرد الوكلاء
• جلب الإصدارات

المكالمات

• بدء المكالمات الهاتفية ومكالمات الويب
• جلب تفاصيل المكالمة
• سرد المكالمات
• تحديث بيانات المكالمة الوصفية
• حذف المكالمات
• تشغيل QA والمراجعات

أرقام الهاتف

• استيراد الأرقام
• توفير الأرقام
• سرد الأرقام
• جلب تفاصيل الأرقام

قاعدة المعرفة

• إنشاء قواعد المعرفة
• إرفاق المصادر
• إزالة المصادر
• سرد قواعد المعرفة

الأصوات

• سرد الأصوات
• استنساخ الأصوات
• البحث في أصوات المجتمع

المحادثات

• إنشاء المحادثات
• إنشاء وكلاء المحادثة
• إنهاء المحادثات
• تحديث بيانات المحادثة الوصفية

الاختبار وQA

• إنشاء حالات الاختبار
• تشغيل الاختبارات
• سرد عمليات QA
• إعادة تشغيل QA
• إرسال النتائج

التنبيهات وWebhooks

• إنشاء قواعد التنبيه
• سرد قواعد التنبيه
• سرد الحوادث
• اختبار webhooks

لماذا هذا مهم

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

كيف يعمل

الإعداد بسيط. يتّصل عميل MCP لديك بنقطة نهاية MCP المستضافة من Retell عبر HTTP، ويصادق باستخدام مفتاح API الخاص بـ Retell، ويستدعي الأدوات. يمكنه أيضاً اكتشاف الأدوات المتاحة تلقائياً عبر tools/list، بما في ذلك:

• اسم الأداة
• الوصف
• مخطّط إدخال JSON

لذا بدلاً من ترميز كلّ إجراء يدوياً، يعرف وكيلك بالفعل ما هي أدوات Retell الموجودة، ويعرف كيفية استخدامها بشكل صحيح.

ما تحتاجه للبدء

تأكّد من أنّ لديك:

• مفتاح API الخاص بـ Retell
• عميل متوافق مع MCP مثل Cursor أو Claude Desktop أو Claude Code أو Codex
• عنوان URL لخادم Retell MCP: https://mcp.retellai.com

صيغة المصادقة:

Authorization: Bearer <RETELL_API_KEY>

إعداد بسيط

يدعم معظم عملاء MCP خوادم MCP البعيدة عبر HTTP.

استخدم:

• URL: https://mcp.retellai.com
• Header: Authorization: Bearer

مثال على الإعداد

Cursor

افتح: Command Palette ← Cursor Settings ← MCP ← Add new global MCP server

أضف:

{
  "mcpServers": {
    "retell": {
      "url": "https://mcp.retellai.com",
      "headers": {
        "Authorization": "Bearer <RETELL_API_KEY>"
      }
    }
  }
}

Claude Desktop

افتح: Settings ← Developer ← Edit Config

أضف:

{
  "mcpServers": {
    "retell": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://mcp.retellai.com",
        "--header",
        "Authorization:Bearer <RETELL_API_KEY>"
      ]
    }
  }
}

Claude Code

claude mcp add --transport http retell https://mcp.retellai.com --header "Authorization: Bearer <RETELL_API_KEY>"

Codex

أضف هذا إلى ~/.codex/config.toml:

[mcp_servers.retell]
url = "https://mcp.retellai.com"
bearer_token_env_var = "RETELL_API_KEY"

ثمّ عيّن:

export RETELL_API_KEY="<RETELL_API_KEY>"

عملاء MCP الآخرون

إذا كان عميلك يدعم عناوين URL وr> headers الخاصة بـ MCP البعيدة، استخدم:

• URL: https://mcp.retellai.com
• Header: Authorization: Bearer

أمثلة على الأوامر

بمجرّد الاتصال، يمكن لمساعدك البدء في العمل مع Retell على الفور.

جرّب أوامر مثل:

• "اعرض قائمة وكلائي ولخّص ما يفعله كلّ منهم."
• "أنشئ وكيلاً جديداً لتأهيل مبيعات المكالمات الواردة وانشره."
• "أرِني آخر 20 مكالمة وأشِر إلى أي منها بنتائج QA منخفضة."
• "أنشئ قاعدة معرفة، وأرفق هذه المصادر، وحدّث وكيلي لاستخدامها."
• "استورد رقم الهاتف هذا وعيّنه لوكيلي."
• "أعد تشغيل QA على هذه المكالمة ولخّص أسباب الفشل."

والآن يأتي الجزء الممتع حيث يمكن لـ MCP أن يُظهر قوّته حقاً. لم تعد تتحدّث فقط مع مساعد. بل تمنحه وصولاً حقيقياً إلى المنصّة حتى يتمكّن من مساعدتك في بناء الوكلاء الصوتيين واختبارهم وتحليلهم وتحسينهم في مكانهم.

لماذا ستحبّه الفرق

يساعد Retell MCP Server الفرق على:

• البناء بشكل أسرع دون مغادرة عميل الذكاء الاصطناعي الخاص بهم
• تقليل عبء لوحة التحكّم وAPI
• الانتقال من النموذج الأوّلي إلى الإنتاج بشكل أسرع
• تشغيل QA والعمليات بجهد يدوي أقل
• إبقاء البنية التحتية الصوتية أقرب إلى الأدوات التي يستخدمها المطوّرون بالفعل

بالنسبة للمطوّرين، يقلّل ذلك من عمل التكامل اليدوي. وبالنسبة لفرق المنتجات، يسرّع الاختبار والتكرار. وبالنسبة لفرق العمليات، يجعل من الأسهل إدارة المكالمات وQA وسير عمل الوكلاء اليومي.

الأمان والاستخدام الآمن

ربط LLMs بأدوات تشغيلية أمر هائل، لكنه ينطوي أيضاً على مخاطر. أكبر خطر هو حقن الأوامر (prompt injection). ويعني ذلك أنّ المحتوى غير الموثوق مثل النصوص المفرّغة أو رسائل المستخدمين أو مستندات قاعدة المعرفة قد يتضمّن تعليمات مخفية تحاول جعل النموذج يفعل شيئاً لم تطلبه. يدعم معظم عملاء MCP خيار "التأكيد قبل تشغيل الأدوات".

أبقِ هذا الخيار مفعّلاً.

أفضل الممارسات

تعامل مع MCP كما لو كنت تمنح مساعدك وصولاً تشغيلياً حقيقياً.

نوصي بما يلي:

• استخدم أقلّ الامتيازات — أنشئ مفاتيح API بالأذونات التي تحتاجها فقط.
• أبقِ المفاتيح خارج الأوامر — خزّن مفاتيح API في إعدادات العميل أو في الأسرار. لا تلصقها أبداً في المحادثة.
• فضّل سير العمل الذي يبدأ بالقراءة — اجلب الحالة الحالية قبل تحديث أي شيء أو حذفه.
• راجع الإجراءات المدمّرة — الإجراءات مثل delete وpublish يجب أن تتطلّب نيّة مستخدم واضحة.
• كن حذراً مع البيانات الحسّاسة — قد تحتوي سجلّات المكالمات والنصوص المفرّغة على بيانات تعريف شخصية (PII). لا تكشف سوى ما تحتاجه.
• استخدم بيئات غير إنتاجية متى أمكن — ابدأ في بيئة التطوير قبل ربط أنظمة الإنتاج.

استكشاف الأخطاء وإصلاحها

إذا كان هناك شيء لا يعمل، فإليك أوّل الأمور التي ينبغي التحقّق منها.

الأدوات لا تظهر

• تأكّد من أنّ عنوان URL لخادم MCP صحيح
• تحقّق من أنّ ترويسة Authorization مضبوطة بشكل صحيح
• تحقّق من أنّ عميلك يمكنه الوصول إلى نقطة نهاية Retell MCP

401 Unauthorized

• تحقّق من أنّ ترويستك هي Authorization: Bearer <RETELL_API_KEY>
• تأكّد من أنّ مفتاح API الخاص بك نشط وصالح

أخطاء استدعاء الأدوات

• حاول مرّةً أخرى بإدخال أصغر أو أبسط
• تحقّق من رسالة الخطأ المُعادة للاطّلاع على التفاصيل
• يعرض العديد من عملاء MCP أخطاء الأدوات المنظّمة مباشرةً، ممّا قد يساعد في تحديد المشكلة

ابدأ البناء مع Retell MCP

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

إذا كنت تستخدم Retell بالفعل، فإنّ MCP يمنحك سير عمل أسرع. وإذا كنت جديداً على Retell، فإنّه من أبسط الطرق للبدء. اربط عميلك. أضف مفتاح API الخاص بك. ابدأ البناء. فلنبدأ!

هل تحتاج إلى مساعدة؟

إذا واجهت مشكلات أو أردت طلب المزيد من إمكانات MCP، تواصل مع support@retellai.com.