استخدم ThunderPhone كخادم MCP

صِل أي عميل MCP عبر HTTP قابل للبث إلى ThunderPhone لسرد الوكلاء، وفحص المكالمات والنصوص المفرغة، وإجراء مكالمات صادرة باستخدام مفتاح API للمؤسسة.

يُوفّر ThunderPhone خادم Model Context Protocol على:

https://api.thunderphone.com/v1/mcp

وجّه عميل MCP إلى نقطة نهاية HTTP القابلة للبث هذه لإتاحة وكلاء ومكالمات مؤسستك كأدوات. وهذا هو الاتجاه المعاكس لـ ربط خادم MCP بعيد بوكيل صوتي:

الاتجاه	النتيجة
خادم MCP بعيد → وكيل ThunderPhone	يمكن لوكيلك الصوتي استدعاء أدوات الخادم البعيد.
ThunderPhone → عميل MCP الخاص بك	يمكن لعميل MCP الخاص بك استدعاء أدوات ThunderPhone للوكلاء والمكالمات.

المصادقة

أنشئ مفتاح sk_live_ ضمن المؤسسة → المفاتيح وأرسله كرمز Bearer. تقبل نقطة نهاية MCP مفاتيح API الخاصة بالمؤسسة، وليس ملفات تعريف ارتباط جلسة لوحة التحكم أو مفاتيح عناصر الواجهة القابلة للنشر.

Generic client configuration

{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_API_KEY"
      }
    }
  }
}

الأدوات المتاحة

الأداة	الوسيطات	ما الذي تفعله
`list_agents`	لا شيء	تسرد وكلاء المؤسسة مع المعرّف والاسم والمنتج والصوت.
`get_agent`	`agent_id`	تسترجع وكيلًا واحدًا.
`place_call`	`agent_id`, `from_number`, `to_number`	تُجري مكالمة صادرة باستخدام قواعد التحقق وضوابط الفوترة نفسها الخاصة بنقطة نهاية مكالمات REST.
`get_call`	`call_id`	تسترجع حالة المكالمة وملخصها وتقييمها.
`list_calls`	`limit` اختياري (1–100)، و`status` اختياري	تسرد المكالمات الأخيرة.
`get_call_transcript`	`call_id`	تسترجع النص المفرغ الكامل لمكالمة.

تقتصر جميع الأدوات على المؤسسة المرتبطة بمفتاح API. ويتصرف المعرّف من مؤسسة أخرى كما لو كان غير متاح.

أساليب البروتوكول

تنفذ نقطة النهاية أساليب MCP JSON-RPC اللازمة لعملاء HTTP القابل للبث:

initialize
notifications/initialized
tools/list
tools/call

يمكنك فحص دليل الأدوات مباشرةً:

curl -X POST https://api.thunderphone.com/v1/mcp \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

استدعِ أداة باسمها ووسيطاتها:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_calls",
    "arguments": { "limit": 20, "status": "completed" }
  }
}

نتائج الأدوات هي عناصر محتوى نصي في MCP. تُعاد حالات فشل الأدوات ضمن النتيجة مع isError: true؛ وتعيد أساليب JSON-RPC غير المعروفة خطأً في البروتوكول.

يتبع place_call القواعد نفسها لـ POST /v1/call: يجب أن ينتمي الوكيل والرقم إلى مؤسسة المفتاح، ويجب أن يكون الرقم مؤهلًا للاتصال الصادر، ويجب أن تمتلك المؤسسة رصيدًا كافيًا، ويجب إكمال أي تأكيد مطبق للاتصال الصادر.

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

المرجع الكامل للاتصالات

راجع واجهة API لخوادم MCP للاطلاع على أمثلة الاستجابات وأخطاء JSON-RPC وواجهة API لإدارة الخوادم البعيدة.

استخدم ThunderPhone كخادم MCP

المصادقة#

الأدوات المتاحة#

أساليب البروتوكول#

إجراء المكالمات بأمان#

المرجع الكامل للاتصالات#

المصادقة

الأدوات المتاحة

أساليب البروتوكول

إجراء المكالمات بأمان

المرجع الكامل للاتصالات