> ## 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 מרוחק לסוכן קולי](/he/guides/mcp-servers):

| כיוון                             | תוצאה                                                            |
| --------------------------------- | ---------------------------------------------------------------- |
| שרת MCP מרוחק → סוכן ThunderPhone | הסוכן הקולי שלכם יכול לקרוא לכלים של השרת המרוחק.                |
| ThunderPhone → לקוח ה-MCP שלכם    | לקוח ה-MCP שלכם יכול לקרוא לכלי ThunderPhone עבור סוכנים ושיחות. |

## אימות

צרו מפתח `sk_live_` תחת **ארגון → מפתחות** ושלחו אותו כאסימון נושא. נקודת
הקצה של 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 לניהול שרתים מרוחקים.