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

يُوفّر 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"
      }
    }
  }
}

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

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

الأداة	الوسيطات	ما الذي تفعله
`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 لإدارة الخوادم البعيدة.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Compliance

Developer cookbook

Operations

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

المصادقة

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

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

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

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

​المصادقة

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

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

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

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

المصادقة

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

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

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

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