> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

```text theme={null}
https://api.thunderphone.com/v1/mcp
```

وجّه عميل MCP إلى نقطة نهاية HTTP القابلة للبث هذه لإتاحة وكلاء ومكالمات
مؤسستك كأدوات. وهذا هو الاتجاه المعاكس لـ
[ربط خادم MCP بعيد بوكيل صوتي](/ar/guides/mcp-servers):

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

## المصادقة

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

```json Generic client configuration theme={null}
{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_API_KEY"
      }
    }
  }
}
```

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

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

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

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

```bash theme={null}
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": {}
  }'
```

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

```json theme={null}
{
  "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`](/api-reference/outbound-calls): يجب أن ينتمي الوكيل والرقم
إلى مؤسسة المفتاح، ويجب أن يكون الرقم مؤهلًا للاتصال الصادر، ويجب أن تمتلك
المؤسسة رصيدًا كافيًا، ويجب إكمال أي تأكيد مطبق للاتصال الصادر.

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

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

راجع [واجهة API لخوادم MCP](/api-reference/mcp-servers#thunderphone-as-an-mcp-server)
للاطلاع على أمثلة الاستجابات وأخطاء JSON-RPC وواجهة API لإدارة الخوادم البعيدة.