أعطِ Claude خط هاتف حقيقيًا عبر خادم MCP من Wixzel Voice

ما الذي تحتاجه قبل أن تبدأ؟

• حساب على Wixzel Voice فيه رصيد. الحد الأدنى لشحن الرصيد هو $5، ولا يوجد رصيد تجريبي مجاني للمكالمات.
• SIP trunk لدى مزوّد اتصالات تستخدمه بالفعل (Twilio أو Telnyx أو Plivo أو Vonage أو Bandwidth أو Exotel أو Vobiz أو أي مزوّد SIP) وعليه رقم هاتف. لا يبيع Wixzel Voice الأرقام ولا ينقلها. إذا كان حسابك لدى مزوّد الاتصالات على Twilio أو Telnyx أو Plivo أو Vobiz أو Vonage وربطته من لوحة التحكم، يمكنك شراء رقم على ذلك الحساب من Wixzel Voice، ويحاسبك عليه مزوّد الاتصالات.
• Claude Code، أو claude.ai أو Claude Desktop مع إتاحة الموصلات المخصصة (custom connectors) في خطتك.

كيف تبني هذا على Wixzel Voice، خطوة بخطوة؟

1. 01أضف الخادم إلى Claude Code

   الخادم المستضاف موجود على https://mcp.voice.wixzel.com/mcp ويسجّل دخولك عبر OAuth، فلا تلصق مفتاح API في أي مكان. أضفه من الطرفية:

   shellنسخ

   claude mcp add --transport http wixzel-voice https://mcp.voice.wixzel.com/mcp

   ثم اكتب /mcp داخل Claude Code، واختر الخادم wixzel-voice ثم Authenticate. يفتح متصفحك لوحة التحكم، فتسجّل الدخول، وتلغي تحديد أي صلاحية (scope) لا تريد أن يحصل عليها العميل، ثم توافق. يحصل Claude Code على مفتاح API خاص به، مقيّد بالصلاحيات التي وافقت عليها.

2. 02أو أضفه إلى claude.ai أو Claude Desktop

   في Settings، افتح Connectors وأضف موصلًا مخصصًا بالعنوان نفسه، https://mcp.voice.wixzel.com/mcp. اضغط Connect، وسجّل الدخول إلى لوحة التحكم، ووافق على الصلاحيات. يحصل الموصل على مفتاح خاص به، ويمكنك فصله من صفحة عملاء الذكاء الاصطناعي في لوحة التحكم في أي وقت؛ فيتوقف المفتاح عن العمل فورًا.

   العملاء الذين يشغّلون الخوادم محليًا من إعداد JSON باسم mcpServers، مثل Cursor، يشغّلون الخادم نفسه من npm مع مفتاح API في متغيرات البيئة:

   shellنسخ

   claude mcp add wixzel-voice -e WIXZEL_API_KEY=wv_live_... -- npx -y wixzel-voice-mcp

   jsonنسخ

   {
     "mcpServers": {
       "wixzel-voice": {
         "command": "npx",
         "args": ["-y", "wixzel-voice-mcp"],
         "env": { "WIXZEL_API_KEY": "wv_live_..." }
       }
     }
   }

3. 03دع موجّه quickstart يُعدّ حسابك

   يأتي الخادم مع موجّه (prompt) باسم quickstart، يعرضه Claude Code كأمر يبدأ بشرطة مائلة (slash command). يقبل هدفًا اختياريًا، مثل "تأكيد مواعيد عيادة الأسنان":

   Claude Codeنسخ

   /mcp__wixzel-voice__quickstart

   يعرض Claude أولًا ما هو موجود بالفعل (list_sip_trunks وlist_phone_numbers وlist_agents وget_balance) حتى لا يتكرر شيء. ثم يعمل بالترتيب الذي يحدده دليل التشغيل في الخادم: list_engines لمعرفة المتاح وتكلفته، ثم create_sip_trunk ببيانات اعتماد مزوّد الاتصالات التي تعطيه إياها، ثم create_phone_number على ذلك الـ trunk، ثم create_agent بتعليمات قصيرة بأسلوب الكلام المنطوق، وجملة افتتاحية، ورقم متصل (caller ID). يطلب منك بيانات الاعتماد بدلًا من اختلاقها، ويتوقف قبل أي شيء يُجري اتصالًا.

   هناك إعدادان لا يمكن تغييرهما إلا لديك عند مزوّد الاتصالات. أضف platform_ip الذي يعيده الـ trunk الجديد إلى قائمة السماح، حتى يقبل مزوّد الاتصالات المكالمات الصادرة منه، ووجّه مسار المكالمات الواردة لدى المزوّد إلى origination_uri الخاص بالـ trunk. يقرأ Claude القيمتين لك، ويُظهر check_sip_trunk_status ما إذا كان الـ trunk قابلًا للوصول.

4. 04اطلب مكالمة، ووافق عليها

   بعد تجهيز وكيل ورقم، اطلب بكلمات بسيطة:

   promptنسخ

   Call +14155551234 with the Support agent. Ask whether tomorrow's 10:00
   delivery slot still works, and tell me what they said.

   يختار Claude الأداة place_call. هذه الأداة مُعلَّمة بأنها تنفق المال وتتصل بهاتف حقيقي، ويطلب وصفها من النموذج التأكيد معك أولًا، فيطلب العميل موافقتك قبل تشغيلها. يحمل كل استدعاء لـ place_call مفتاح idempotency؛ وتكون إعادة المحاولة آمنة فقط عندما يمرّر Claude قيمة idempotency_key نفسها مجددًا، وهو ما يطلبه منه وصف الأداة.

   الوكيل الصوتي الذي أنشأته هو من يدير المحادثة، لا Claude. بعدها يستعلم Claude عبر get_call حتى تنتهي المكالمة، ويقرأ لك النص المكتوب والحالة وcost_micros، أي التكلفة بأجزاء من المليون من الدولار.

5. 05اعرف أي الأدوات تطلب الإذن قبل تشغيلها

   يعلّم Wixzel Voice أربع أدوات بأنها تنفق المال أو تصل إلى العالم الحقيقي: place_call تتصل برقم، وtest_call_agent تتصل برقم وتنطق عبارة واحدة، وstart_campaign تتصل بكل عميل محتمل في الحملة، وcreate_topup تبدأ عملية دفع. الأدوات التي تقرأ فقط، مثل get_call أو list_usage_events، مُعلَّمة للقراءة فقط، فيمكن للعميل تشغيلها دون أن يسأل.

   لا تدفع create_topup بنفسها أبدًا: فهي تعيد رابط دفع يجب أن يفتحه شخص ويكمله.

   الصلاحيات (scopes) هي الحاجز الثاني. العميل الذي لا يطلب شيئًا محددًا تُعرض عليه المجموعة القياسية للوكلاء؛ أما billing:write التي تبدأ شحن الرصيد، وapi_keys:write التي تُنشئ المفاتيح، فلا تُعرضان افتراضيًا أبدًا ويجب منحهما عن قصد. لا توجد صلاحية admin.

6. 06عندما تفشل مكالمة، اسأل عن السبب

   يأتي الخادم مع موجّهين آخرين:

   Claude Codeنسخ

   /mcp__wixzel-voice__diagnose_call
   /mcp__wixzel-voice__spend_report

   يأخذ diagnose_call معرّف مكالمة، ويقرأ failure_code وfailure_reason في السجل، وأحداث الاستخدام، وحالة الـ trunk، وسجلات SIP الأخيرة، ثم يخبرك ما إذا كان الإصلاح لدى مزوّد الاتصالات أم في الوكيل. لا يُجري أي مكالمات أثناء عمله. ويحوّل spend_report استخدام فترة ما إلى دولارات حسب المكوّن وحسب المكالمة.

كم يكلّف هذا البناء على Wixzel Voice؟

ما حدود Wixzel Voice التي تنطبق على هذا البناء؟

• المكالمات الهاتفية تحتاج إلى SIP trunk خاص بك ورقم عليه. لا يبيع Wixzel Voice الأرقام ولا ينقلها ولا يحتفظ بها. على حساب Twilio أو Telnyx أو Plivo أو Vobiz أو Vonage مربوط من لوحة التحكم، يستطيع Claude شراء رقم لك عبر purchase_phone_number، ويحاسبك عليه مزوّد الاتصالات، بعد أن تمنح صلاحية phone_numbers:purchase.
• العميل هو من يعرض طلب الموافقة قبل أداة مدفوعة. يعلّم الخادم تلك الأدوات ويطلب من النموذج التأكيد؛ أما العميل المضبوط على الموافقة على الأدوات تلقائيًا فلن يسأل، لذا أبقِ الموافقة التلقائية متوقفة لهذا الخادم.
• يمكن أن تكون خمس مكالمات نشطة في وقت واحد لكل حساب افتراضيًا. يُرفع الحد عند الطلب.
• مكالمة الاختبار مكالمة حقيقية: تتصل بهاتف حقيقي عبر مزوّد الاتصالات ويعمل العدّاد. لا يوجد وضع اختبار مجاني.
• تُطرح التغييرات في سلوك Wixzel Voice خلف ترويسة Wixzel-Version مؤرّخة.